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

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

Warning Gradience, stopthemingmy.app 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

Note You can download latest nightly build from GitHub actions

Note You can go to Preferences and apply overrides for Flatpak

1. Open Preferences window

2. Go to Theming tab

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

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

Gradience is available for Fedora via COPR:

dnf copr enable lyessaadi/gradience
dnf install gradience

Warning Not available yet.

Gradience is available for Arch Linux via AUR:

Using Paru:

paru -S gradience

For latest changes:

paru -S gradience-git

git clone https://aur.archlinux.org/gradience.git
cd gradience
makepkg -sic

git clone https://aur.archlinux.org/gradience-git.git
cd gradience-git
makepkg -sic

Warning It's currently only available in unstable

Gradience is available for NixOS:

nix-shell -p gradience

Note You can download latest nightly build from GitHub actions

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 https://github.com/GradienceTeam/Gradience.git as the URL.
3. Click the build button at the top once the project is loaded.

For more building and installation methods, see HACKING.md

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

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

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

See HACKING.md

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.

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 GradienceTeam#23.

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

See gradienceteam.github.io/hack

Gradience Team is not against stopthemingmy.app 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.

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

• GitLab
• GitHub
• Codeberg