Change the look of Adwaita, with ease
Go to file
Daudix_UFO 893b3e0082
feat: Add thumbnail named colors to Monet
2023-06-08 01:23:04 +03:00
.github ci: remove workflow for codeberg since i found a better way 2023-05-08 10:49:08 +02:00
build-aux/flatpak meta: Update blueprint-compiler to v0.8.1 2023-05-23 20:13:37 +02:00
data feat: Improve wording 2023-05-31 20:37:26 +03:00
gradience feat: Add thumbnail named colors to Monet 2023-06-08 01:23:04 +03:00
po translate: translated using Weblate (German) 2023-06-06 19:51:13 +02:00
.editorconfig misc add more rules to .editorconfig 2023-03-12 19:53:27 +00:00
.gitignore meta: add `builddir;export` to .gitignore 2023-04-30 20:09:26 +00:00
.gitmodules GNOME Shell theming support (#679) 2023-05-04 13:24:18 +00:00
.pylintrc meta: update and rename pylintrc 2022-12-27 21:13:20 +01:00 doc: Fix typo 2023-05-04 22:04:00 +03:00 feat: add link to gnome coc 2022-11-21 19:25:29 +01:00 Update 2023-05-23 20:13:36 +02:00
LICENSE Create LICENSE 2022-08-10 23:51:10 +02:00 fix: nicknames and links 2022-09-16 15:34:28 +03:00
Makefile meson: remove depracation warnings in newer Meson versions 2022-11-11 01:42:00 +01:00 docs: Make nightly download link a bit more prominent 2023-06-06 01:49:11 +03:00 Update 2023-01-27 21:28:03 +03:00 misc: make email a mailto link 2023-01-04 21:05:36 +03:00
gradience.doap feat: improve text and update links 2022-11-24 17:33:15 +03:00 scripts: fix if statement in `` 2023-03-06 00:39:37 +01:00 meson: configure local build launchers if buildtype is set to debug 2023-02-11 22:06:05 +01:00 meson: don't fail if host doesn't have `git` installed 2023-03-18 17:29:36 +00:00
requirements.txt GNOME Shell theming support (#679) 2023-05-04 13:24:18 +00:00
typos.toml misc: CI improvements (#700) 2023-01-18 03:04:00 +03:00

Warning This software is currently in a beta state. It can break things, and it doesn't yet have a polished, foolproof UX.

Contributions are welcome!

Please, if you got into some trouble with it, just create a new issue, or contact us on Matrix and Discord.


Change the look of Adwaita, with ease

Download on Flathub

Translation status Build status Flathub downloads Packaging status

Chat on Matrix Chat on Discord

Please do not theme this app


Gradience is a tool for customizing Libadwaita applications and the adw-gtk3 theme.

Warning Gradience, and Adwaita Developers

The main features of Gradience include the following:

  • 🎨 Changing any color of Adwaita theme
  • 🖼️ Applying Material 3 color scheme from wallpaper
  • 🎁 Usage of other users presets
  • ⚙️ Changing advanced options with CSS
  • 🧩 Extending functionality using plugins
📷 More screenshots

Monet Tab

Proof of Work

Note You can download latest nightly build from GitHub actions

🎨 Theming setup

Note You can go to Preferences and apply overrides for Flatpak

🪛 Manual setup

Libadwaita applications

No additional setup is required for native Libadwaita applications.

For Flatpak Libadwaita applications, you need to override their permissions:

  • Run sudo flatpak override --filesystem=xdg-config/gtk-4.0 or
  • Use Flatseal and adding xdg-config/gtk-4.0 to Other files in the Filesystem section of All Applications

Vanilla GTK 4 applications

Use this guide to theme vanilla GTK 4 applications.

GTK 3 applications

  • Install and apply the adw-gtk3 theme (don't forget to install the Flatpak package!)
  • For Flatpak applications, you need to override their permissions:
    • Run sudo flatpak override --filesystem=xdg-config/gtk-3.0 or
    • Use Flatseal and adding xdg-config/gtk-3.0 to Other files in the Filesystem section of All Applications

🔄 Revert Theming

  1. Open Preferences window

Main Gradience Menu

  1. Go to Theming tab

  2. In Reset & Restore Presets group, click Reset button for either GTK 3 or Libadwaita applications

Reset & Restore Presets Group

🪛 Manual revert

Remove GTK 3 and GTK 4 configs

  • Run rm -rf .config/gtk-4.0 .config/gtk-3.0

Remove adw-gtk3 theme

  • Run flatpak uninstall adw-gtk3 to remove Flatpak adw-gtk3 theme
  • Run rm -rf .themes/adw-gtk3 .themes/adw-gtk3-dark .local/share/themes/adw-gtk3 .local/share/themes/adw-gtk3-dark to remove local adw-gtk3 theme

Reset Flatpak overrides

  • Run sudo flatpak override --reset

Warning This will reset all Flatpak overrides, such as Firefox Wayland override

📦 Alternative installation methods

Warning The main installation method is Flatpak from Flathub

Note There are number of Gradience packages that are not tested by Gradience Team and not listed here, available at Repology

Fedora (COPR)

Gradience is available for Fedora via COPR:

dnf copr enable lyessaadi/gradience
dnf install gradience

Debian (And derivatives)

Warning Not available yet.

Arch Linux (AUR)

Gradience is available for Arch Linux via AUR:

Using Paru:

paru -S gradience

For latest changes:

paru -S gradience-git
🪛 Without AUR helpers
git clone
cd gradience
makepkg -sic

For latest changes:

git clone
cd gradience-git
makepkg -sic


Warning It's currently only available in unstable

Gradience is available for NixOS:

nix-shell -p gradience

🏗️ Building from source

Note You can download latest nightly build from GitHub actions

GNOME Builder

GNOME Builder is the environment used for developing this application. It can use Flatpak manifests to create a consistent building and running environment cross-distro. Thus, it is highly recommended you use it.

  1. Download GNOME Builder.
  2. In Builder, click the "Clone Repository" button at the bottom, using as the URL.
  3. Click the build button at the top once the project is loaded.

For more building and installation methods, see

🎛️ Miscellaneous

Show welcome window again

The following command will make Gradience show welcome screen on next launch, like you just installed it


flatpak run --command=gsettings com.github.GradienceTeam.Gradience reset com.github.GradienceTeam.Gradience first-run

Alternative installation methods

gsettings reset com.github.GradienceTeam.Gradience first-run


How can I launch a CLI?

Refer to temporary CLI documentation in repo's wiki for instructions on how to launch a CLI.

🙌 Contribute to Gradience




🏷️ About the Name

Gradience was originally named Adwaita Manager.

You can see the meaning of Gradience on Wiktionary.

The icon represents: A Paint Roller repainting an Adwaita window, keeping its functionality.

🖌️ About the "Pretty Purple"

The Pretty Purple theme comes from the very beginning, directly from the original author of Gradience, Artyom Fomin.

It was called "Purple Guy", presumably as a reference to the FNaF, later it was renamed to Pretty Purple.

Pretty Purple preset was originally shared in the

Pretty Purple is built-in in the Gradience and used in all Gradience artworks.

🌱 Gradience, and Adwaita Developers


Gradience Team is not against and Adwaita Developers idea, Gradience is a tool for tinkers that want to theme their desktops at their liking, and not a tool for distributions to change theme in them by default, Gradience Team agrees with importance of unified look of Adwaita to make sure that all apps work right and Developers have unified and stable tool for creating their apps.

💝 Acknowledgment

Special thanks to:

  • Original author of Gradience, Artyom Fomin for creating this project
  • Weblate for providing translation platform

This README is based on README from Kooha by Dave Patrick Caberto

🪞 Mirrors