Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/GradienceTeam/Gradience

Change the look of Adwaita, with ease
https://github.com/GradienceTeam/Gradience

adw-gtk3 adwaita adwaita-theme blueprint gnome gnome-shell gnome-shell-theme gnome-theme gtk gtk-theme gtk3 gtk3-theme gtk4 gtk4-theme hacktoberfest libadwaita python python3

Last synced: 3 months ago
JSON representation

Change the look of Adwaita, with ease

Host: GitHub
URL: https://github.com/GradienceTeam/Gradience
Owner: GradienceTeam
License: gpl-3.0
Created: 2022-07-18T12:48:27.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-04-12T14:38:34.000Z (9 months ago)
Last Synced: 2024-04-12T22:20:33.761Z (9 months ago)
Topics: adw-gtk3, adwaita, adwaita-theme, blueprint, gnome, gnome-shell, gnome-shell-theme, gnome-theme, gtk, gtk-theme, gtk3, gtk3-theme, gtk4, gtk4-theme, hacktoberfest, libadwaita, python, python3
Language: Python
Homepage: https://gradienceteam.github.io
Size: 20.2 MB
Stars: 1,203
Watchers: 15
Forks: 48
Open Issues: 56
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Roadmap: ROADMAP.md

Awesome Lists containing this project

awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/GradienceTeam/Gradience - GTK theming tool (Jump To / Customizations)
awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/GradienceTeam/Gradience - GTK theming tool (Jump To / Customizations)
fucking-Awesome-Linux-Software - ![Open-Source Software - Gradience is a tool for customizing Libadwaita applications and the adw-gtk3 theme. (Applications / Desktop Customization)
Awesome-Linux-Software - ![Open-Source Software - Gradience is a tool for customizing Libadwaita applications and the adw-gtk3 theme. (Applications / Desktop Customization)
awesome-starred - GradienceTeam/Gradience - Change the look of Adwaita, with ease (Python)
awesome-starred - GradienceTeam/Gradience - Change the look of Adwaita, with ease (Python)

README

> [!IMPORTANT]
> Gradience has been archived as of June 29, 2024. See the [blog post](https://daudix.one/blog/archiving-gradience/) for some information on the rationale behind this decision.

> [!NOTE]
> Gradience is looking for a maintainer(s)! if you know Python and GTK4/Libadwaita and willing to work on it, chip in on [Matrix](https://matrix.to/#/#Gradience:matrix.org) and [Discord](https://discord.com/invite/4njFDtfGEZ).

Gradience

Change the look of Adwaita, with ease

Preview

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

> [!IMPORTANT]
> [Gradience, stopthemingmy.app and Adwaita Developers](#%EF%B8%8F-gradience-stopthemingmyapp-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](https://github.com/GradienceTeam/Design/raw/main/Screenshots/monet_purple.png)

![Proof of Work](https://github.com/GradienceTeam/Design/raw/main/Screenshots/proof_purple.png)

## 🎨️ 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](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**

## 🔄 Revert Theming
1. Open Preferences window

![Main Gradience Menu](https://i.imgur.com/bJMNX6d.png)

2. Go to Theming tab

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

![Reset & Restore Presets Group](https://i.imgur.com/SynxTJT.png)

🪛️ 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

> [!IMPORTANT]
> 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](https://repology.org/project/gradience/versions)

### Fedora (COPR)

Gradience is available for Fedora via COPR:

```shell
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](https://github.com/morganamilo/paru):

```shell
paru -S gradience
```

For latest changes:

```shell
paru -S gradience-git
```

🪛️ Without AUR helpers

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

For latest changes:

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

### NixOS

Gradience is available for NixOS 23.05 (Stoat) and later:

To run in a temporary shell:
```shell
nix-shell -p gradience
```

To install:
```shell
nix-env -iA nixos.gradience
```

## 🏗️ Building from source

### Nightly Build

First of all, you need to have [GNOME Nightly](https://nightly.gnome.org) Flatpak remote added if it's not already:

```shell
flatpak remote-add --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo
```

Then, download the Gradience nightly from [here](https://nightly.link/GradienceTeam/Gradience/workflows/build/main)

Finally, extract the ZIP and install Gradience by running:

```shell
flatpak install gradience-devel.flatpak
```

### 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](https://apps.gnome.org/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](HACKING.md)

## 🎛️ Miscellaneous

### Show welcome window again

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

#### Flatpak

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

#### Alternative installation methods

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

## ℹ️ FAQ

### How can I launch a CLI?
Refer to [temporary CLI documentation](https://github.com/GradienceTeam/Gradience/wiki/Using-CLI) in repo's wiki for instructions on how to launch a CLI.

## 🙌 Contribute to Gradience

See [HACKING.md](HACKING.md)

## ✨️ Contributors

[![Contributors](https://contrib.rocks/image?repo=GradienceTeam/Gradience)](https://github.com/GradienceTeam/Gradience/graphs/contributors)

## 🏷️ About the 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 its functionality._

## 🖌️ About the "Pretty Purple"

The Pretty Purple theme comes from the very beginning, directly from the original author of Gradience, [Artyom Fomin](https://github.com/ArtyIF).

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 https://github.com/GradienceTeam/Gradience/discussions/23.

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

## 🌱️ Gradience, [stopthemingmy.app](https://stopthemingmy.app) and Adwaita Developers

> See [gradienceteam.github.io/hack](https://gradienceteam.github.io/hack)

Gradience Team is not against the ideas of [stopthemingmy.app](https://stopthemingmy.app) and the developers of Adwaita. Gradience is a tool for tinkerers who want to theme their desktop to their liking, and **not a tool for distributions** to ship in their releases. Gradience Team agrees with importance of unified look of Adwaita to make sure that all apps function correctly and that developers have a unified and stable tool for creating their apps.

## 💝 Acknowledgment

Special thanks to:

- Original author of Gradience, [Artyom Fomin](https://github.com/ArtyIF) for creating this project
- [Weblate](https://weblate.org) for providing translation platform

This README is based on README from [Kooha](https://github.com/SeaDve/Kooha) by [Dave Patrick Caberto](https://github.com/SeaDve)

## 🪞 Mirrors

- [GitLab](https://gitlab.com/GradienceTeam/Gradience)
- [GitHub](https://github.com/GradienceTeam/Gradience)
- [Codeberg](https://codeberg.org/GradienceTeam/Gradience)