adw-gtk3-white-headers

A soft fork of adw-gtk3 that restores the white headerbars introduced with Libadwaita 1.4/GNOME 45.

^{White headerbars were removed from adw-gtk3 because they can reduce the legibility of some apps. Please do not make any issue reports for this fork in the original repo.}

Light theme (adw-gtk3)	Light theme (fork)	Dark theme

^{Also Used: Rounded Window Corners and Night Theme Switcher}

How to install

Note: You may want to install this alongside the original theme. That way, if you encounter issues with white headerbars for a specific program, you can switch it to adw-gtk3 by prepending GTK_THEME=adw-gtk3 to its exec.

Tarball

1. Go to the releases section and download the latest tar.xz file.
2. Extract the file to ~/.themes/ (recommended), ~/.local/share/themes/, (or /usr/share/themes if you want to install it for all users).

Note: Do not extract it to multiple locations. Only use one path. If you use flatpak applications, you MUST extract it to ~/.themes/.

3. If you use flatpak applications, you will have to give flatpaks access to the theme. From a terminal, run as root:

flatpak override --filesystem=~/.themes:ro

Note: Both the fork and the original project have a dark variant. They should be identical, as the white headerbars only appear in light mode, but I packaged a dark theme anyways so it will toggle correctly when using recent versions of GNOME or an auto-switch extension.

You can then enable adw-gtk3 in the application gnome-tweaks. (Some applications may require a relog.)

Alternatively you can set the theme with your terminal:

Change the theme to the light variant:

gsettings set org.gnome.desktop.interface gtk-theme 'adw-gtk3-wh' && gsettings set org.gnome.desktop.interface color-scheme 'default'

Change the theme to the dark variant:

gsettings set org.gnome.desktop.interface gtk-theme 'adw-gtk3-wh-dark' && gsettings set org.gnome.desktop.interface color-scheme 'prefer-dark'

Revert to GNOME's default theme:

gsettings set org.gnome.desktop.interface gtk-theme 'Adwaita' && gsettings set org.gnome.desktop.interface color-scheme 'default'

Other installation options

This is a small fork, so there are no distro packages nor a flatpak, though as detailed above, the theme will still apply to flatpak. If you want updates from your distro's package manager, you will need to use the original project.

Installation from source

This will install the latest version from the main branch. Use this installation method if you want to contribute and help testing the theme.

See CONTRIBUTING.md for the instructions.

How to uninstall the theme(s)

• For a local installation in ~/.themes: rm -r ~/.themes/adw-gtk3-wh*
• For a local installation in ~/.local/share/themes: rm -r ~/.local/share/themes/adw-gtk3-wh*
• For a global installation: sudo rm -r /usr/share/themes/adw-gtk3-wh*

Credits

• Libadwaita source: https://gitlab.gnome.org/GNOME/libadwaita
• Adw-gtk3 contributors: https://github.com/lassekongo83/adw-gtk3/graphs/contributors
• Adw-gtk3-white-headers contributors: https://github.com/lseelig/adw-gtk3-white-headers/contributors