Icon # Gradience Change the look of Adwaita, with ease ![Screenshot of interface with Adwaita light theme](https://github.com/GradienceTeam/Design/blob/main/Screenshots/main_screenshot.png) Gradience is a tool for customizing Libadwaita applications and the adw-gtk3 theme.
More screenshots ![Screenshot of interface of Monet Tab](https://github.com/GradienceTeam/Design/blob/main/Screenshots/monet_purple.png) ![Screenshot of proof that this actually works](https://github.com/GradienceTeam/Design/blob/main/Screenshots/proof_of_work_screenshot.png)
[![Flatpak build](https://github.com/GradienceTeam/Gradience/actions/workflows/flatpak.yml/badge.svg)](https://github.com/GradienceTeam/Gradience/actions/workflows/flatpak.yml) [![Copr build status](https://img.shields.io/badge/dynamic/json?color=blue&label=copr&query=builds.latest.state&url=https%3A%2F%2Fcopr.fedorainfracloud.org%2Fapi_3%2Fpackage%3Fownername%3Dlyessaadi%26projectname%3Dgradience%26packagename%3Dgradience%26with_latest_build%3DTrue)](https://copr.fedorainfracloud.org/coprs/lyessaadi/gradience/package/gradience/) [![Flathub](https://img.shields.io/badge/dynamic/json?color=informational&label=downloads&logo=flathub&logoColor=white&query=%24.installs_total&url=https%3A%2F%2Fflathub.org%2Fapi%2Fv2%2Fstats%2Fcom.github.GradienceTeam.Gradience)](https://flathub.org/apps/details/com.github.GradienceTeam.Gradience) [![Translate on Weblate](https://hosted.weblate.org/widgets/GradienceTeam/-/svg-badge.svg)](https://hosted.weblate.org/engage/GradienceTeam) [![Chat on Matrix](https://matrix.to/img/matrix-badge.svg)](https://matrix.to/#/#Gradience:matrix.org) [![Chat on Discord](https://img.shields.io/discord/1013779899821064202?label=discord&logo=discord&logoColor=white)](https://discord.com/invite/rwNDGPJf) ## Download Gradience is available on Flathub. Download 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: ```bash flatpak install flathub com.github.GradienceTeam.Gradience ``` ### COPR Gradience is available on COPR. You can install it using the following command: ```bash dnf copr enable lyessaadi/gradience dnf install gradience ``` ### Debian (And derivates) Not available yet. If you want, submit a PR. ### AUR Gradience is available on AUR. You can install it using the following command: ```bash yay -S gradience # or gradience-git ``` ### Building from source #### Requirements - Python 3 `python` - PyGObject `python-gobject` - Blueprint [`blueprint-compiler`](https://jwestman.pages.gitlab.gnome.org/blueprint-compiler/setup.html) - GTK4 `gtk4` - libadwaita (>= 1.2.alpha) `libadwaita` - Meson `meson` - Ninja `ninja-build` Install required Python libraries: ```sh pip install -r requirements.txt ``` ### Global installation ```sh 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) ```sh git clone https://github.com/GradienceTeam/Gradience.git cd Gradience meson builddir meson configure builddir -Dprefix="$(pwd)/builddir" 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](https://github.com/tchx84/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](https://github.com/lassekongo83/adw-gtk3/blob/main/gtk4.md) to theme vanilla GTK 4 applications. ### GTK 3 applications - Install and apply the [adw-gtk3](https://github.com/lassekongo83/adw-gtk3#readme) 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](https://github.com/tchx84/Flatseal) and adding `xdg-config/gtk-3.0` to **Other files** in the **Filesystem** section of **All Applications** ## Roadmap See [`ROADMAP.md`](ROADMAP.md) ## Contribute See [`CONTRIBUTING.md`](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](https://en.wiktionary.org/wiki/gradience). The icon represents: _A Paint Roller repainting an Adwaita window, keeping it's functionality and improving it's looks_