Gradience/README.md

Gradience

Change the look of Adwaita, with ease

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

More screenshots

Download

Gradience is available on Flathub.

Building and Installing

Gradience can be installed using multiple methods.

• Flathub (Recommended)
• As RPM package
• As DEB package (not available yet)
• From AUR

Flatpak

Gradience is available on Flathub. You can install it using the following command:

flatpak install flathub com.github.GradienceTeam.Gradience

COPR

Gradience is available on COPR. You can install it using the following command:

dnf copr enable lyessaadi/gradience
dnf install gradience

Debian (And derivates)

Not available yet

AUR

Gradience is available on AUR. You can install it using the following command:

yay -S gradience # or gradience-git

Building from source

Requirements

• Python 3 python
• PyGObject python-gobject
• Blueprint blueprint-compiler
• GTK4 gtk4
• libadwaita (>= 1.2.alpha) libadwaita
• Meson meson
• Ninja ninja

Install required Python libraries:

pip install -r requirements.txt

Global installation

git clone https://github.com/GradienceTeam/Gradience.git
cd Gradience
meson builddir --prefix=/usr/local
sudo ninja -C builddir install

Local build (for testing and development purposes)

git clone https://github.com/GradienceTeam/Gradience.git
cd Gradience
meson builddir
meson configure builddir -Dprefix="$(pwd)/builddir/testdir"
ninja -C builddir install
ninja -C builddir run

[NOTE] During testing and developement, as a convenience, you can use the local.sh script to quickly rebuild local builds.

Building using flatpak-builder

1. Open Terminal
2. Run git clone https://github.com/GradienceTeam/Gradience.git && cd Gradience
3. Install the 42 version of GNOME SDK: flatpak install org.gnome.Sdk/x86_64/42 org.gnome.Platform/x86_64/42
4. Run: flatpak-builder --install --user --force-clean repo/ build-aux/flatpak/com.github.GradienceTeam.Gradience.Devel.json

Alternatively, open the project with GNOME Builder, then build and run it.

Setup Tutorial

You can also go in Preferences and apply overwrite for Flatpak

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

Roadmap

This tool is currently WIP, but it already has a plenty of features and is very usable. Below is the roadmap, where all the checked features are already implemented:

Show roadmap

• Customize named colors, either with a color picker or with text
• Explanations for some named colors
• Partial theme preview
• Built-in presets for Adwaita and Adwaita Dark (based on default libadwaita colors)
• Apply changes to libadwaita, GTK4 (with extracted libadwaita theme) and GTK3 (with the adw-gtk3 theme) applications
• Load and create custom presets
• View adw-gtk3's support of variables
• View parsing errors
• Customize palette colors
• Add custom CSS code
• Localization support
• Normalize color variables
• Make the code more secure
• Add preset manager with option to download other users presets
• Release on Flathub
• Add plugin support. Will help integration with others tools. (WIP)
• Full theme preview
• Customize GNOME Shell
• Customize GDM
• Customize KvLibadwaita
• Customize Firefox GNOME theme

Contribute

See CONTRIBUTING.md for more informations and a list of contributors

About 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 it's functionality and improving it's looks