Skip to content

nwg-piotr/nwg-look

Folders and files

NameName
Last commit message
Last commit date

Latest commit

986439c · Jan 20, 2025
Feb 16, 2024
Jan 18, 2025
Apr 10, 2022
Jul 16, 2022
Jan 17, 2025
Feb 11, 2024
Jan 17, 2025
Jan 15, 2025
Jan 15, 2025
Jan 20, 2025
Jan 15, 2025
Jan 18, 2025

Repository files navigation

logo

nwg-look


This application is a part of the nwg-shell project.

Nwg-look is a GTK settings editor, designed to work properly in wlroots-based Wayland environment. The look and feel is strongly influenced by LXAppearance, but nwg-look is intended to free the user from a few inconveniences:

  • It works natively on Wayland. You no longer need Xwayland, nor strange env variables for it to run.
  • It applies gsettings directly, with no need to use workarounds. You don't need to set gsettings in the sway config file. You don't need the import-gsettings script.

nwg-look

Dependencies

  • go (build dependency)
  • gtk3
  • xcur2png
  • gsettings

Depending on your distro, you may also need to install gotk3 dependencies.

Installation

Packaging status

If nwg-look has not yet been packaged for your Linux distribution:

  1. Clone the repository, cd into it.
  2. make build
  3. sudo make install

Usage

$ nwg-look -h
Usage of nwg-look:
  -a	Apply stored gsetting and quit
  -d	turn on Debug messages
  -r	Restore default values and quit
  -v	display Version information
  -x	eXport config files and quit

The -a flag has been added just in case. When you press the "Apply" button, in addition to applying the changes, a backup file is also created. You may apply gsetting again w/o running the GUI, by just nwg-look -a. No idea if it's going to be useful in real life. ;)

Usage in sway

The default way to apply GTK setting on sway Wayland compositor has been described in the GTK 3 settings on Wayland Wiki section. You no longer need it. Nwg-look loads and saves gsettings values directly, and does not care about the ~/.config/gtk-3.0/settings.ini file. It only exports your settings to it, unless you use the -n flag.

Therefore, if your sway config file contains either

set $gnome-schema org.gnome.desktop.interface

exec_always {
    gsettings set $gnome-schema gtk-theme 'Your theme'
    gsettings set $gnome-schema icon-theme 'Your icon theme'
    gsettings set $gnome-schema cursor-theme 'Your cursor Theme'
    gsettings set $gnome-schema font-name 'Your font name'
}

or if you use the import-gsettings script:

exec_always import-gsettings

to parse and apply the settings.ini file, remove these lines.

Backward compatibility

Some gsetting keys have no direct counterparts in the Gtk.Settings type. While exporting the settings.ini file, nwg-look uses the most similar values:

gsettings Gtk.Settings
font-hinting gtk-xft-hintstyle
font-antialiasing gtk-xft-antialias
font-rgba-order gtk-xft-rgba

Some Other settings have been left just for LXAppearance compatibility, and possible use of your settings.ini file elsewhere:

  • Toolbar style
  • Toolbar icon size

have been deprecated since GTK 3.10, and the values are ignored.

  • Show button images
  • Show menu images

have been deprecated since GTK 3.10, and have no corresponding gsettings values.

  • Enable event sounds
  • Enable input feedback sounds

don't seem to change anything in non-GNOME environment.