mirror of
https://github.com/GradienceTeam/Gradience.git
synced 2024-08-30 18:52:32 +00:00
161 lines
5.9 KiB
Markdown
161 lines
5.9 KiB
Markdown
<img align="left" alt="Icon" src="https://github.com/GradienceTeam/Gradience/blob/main/data/icons/hicolor/scalable/apps/com.github.GradienceTeam.Gradience.svg">
|
|
|
|
# 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.
|
|
|
|
<details>
|
|
<summary>More screenshots</summary>
|
|
|
|
![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)
|
|
</details>
|
|
|
|
[![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)
|
|
|
|
<!--[![Flatpak build - Nightly](https://github.com/GradienceTeam/Gradience/actions/workflows/flatpak-nightly.yml/badge.svg)](https://github.com/GradienceTeam/Gradience/actions/workflows/flatpak-nightly.yml)-->
|
|
|
|
## Download
|
|
|
|
Gradience is available on Flathub.
|
|
|
|
<a href="https://flathub.org/apps/details/com.github.GradienceTeam.Gradience">
|
|
<img width="200" alt="Download on Flathub" src="https://flathub.org/assets/badges/flathub-badge-i-en.svg"/>
|
|
</a>
|
|
|
|
## 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_
|