Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nwg-piotr/nwg-look
GTK3 settings editor adapted to work in the wlroots environment
https://github.com/nwg-piotr/nwg-look
appearance gtk3 lxappearance sway swaywm wlroots
Last synced: 4 days ago
JSON representation
GTK3 settings editor adapted to work in the wlroots environment
- Host: GitHub
- URL: https://github.com/nwg-piotr/nwg-look
- Owner: nwg-piotr
- License: mit
- Created: 2022-03-17T23:40:35.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-24T14:47:27.000Z (2 months ago)
- Last Synced: 2024-10-10T22:03:36.522Z (24 days ago)
- Topics: appearance, gtk3, lxappearance, sway, swaywm, wlroots
- Language: Go
- Homepage:
- Size: 4.41 MB
- Stars: 529
- Watchers: 7
- Forks: 16
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
nwg-look
This application is a part of the [nwg-shell](https://nwg-piotr.github.io/nwg-shell) project.
Nwg-look is a GTK3 settings editor, designed to work properly in wlroots-based Wayland environment.
The look and feel is strongly influenced by [LXAppearance](https://wiki.lxde.org/en/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](https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland). You don't need to set
gsettings in the sway config file. You don't need the `import-gsettings` script.
## Dependencies
- go (build dependency)
- gtk3
- [xcur2png](https://github.com/eworm-de/xcur2png)
- gsettings
Depending on your distro, you may also need to install
[gotk3 dependencies](https://github.com/gotk3/gotk3#installation).
## Installation
[](https://repology.org/project/nwg-look/versions)
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
```text
$ 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](https://github.com/swaywm/sway) Wayland compositor has been
described in the [GTK 3 settings on Wayland](https://github.com/swaywm/sway/wiki/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
```text
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:
```text
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.