t-dantiau / Gradience

Change the look of GNOME, with ease
European Union Public License 1.2
7 stars 0 forks source link

[!IMPORTANT] This is a new work in progress version of Gradience which aims to be a fully featured replacement but which isn't supported or approved by any member of the former Gradience team. I hope that the Gradience community will use this new version of Gradience (φοῖνιξ Edition). I kept the name Gradience because I liked it, but I'm open to any suggestions about the design side of this upcoming theming app

Gradience
Gradience φοῖνιξ

Change the look of GNOME, with ease

CLI

The CLI version of Gradience is available as a standalone binary. You can download it from GitHub Releases or build it yourself from sources or install it using cargo install gradience-cli

Documentation for the CLI is available as markdown here or by using the --help flag.

Usage

First of all, you need a theme, you can try using an old gradience one or make your own from scratch, see Community for examples.

Then, you can either create a shell theme (recommended option) or just apply GTK theme.

For applying a shell theme, you can use the following command (customize as needed)

gradience-cli --preset 'Rosé Pine New' --mode dark --accent red shell

Please note, that --preset must be the name of the preset as written inside the theme file, not the filename!

And then go in GNOME tweaks and select the freshly created theme (Gradience is able to automaticaly do that with --gsettings)

Library

Gradience Library can be used by any rust program for doing GNOME theming. There is one cargo feature that can be enabled if you want to be able to download presets from the online preset store (online), this feature is disabled by default.

If you only use the library, you need to provide shell templates yourself, you can look at gradience cli's code to see how it has been done for packaging everything in one binary.

License

Gradience φοῖνιξ is licensed under the EUPL

About

This library is currently work in progress, but I choosed to keep the name, if anyone has a better name, I'll be open to change!