0xmrtt/Gradience
1
0
Fork 0
mirror of https://github.com/GradienceTeam/Gradience.git synced 2024-06-28 23:49:56 +00:00
Code Issues Packages Projects Releases Wiki Activity
Change the look of Adwaita, with ease
15 commits 6 branches 12 tags 23 MiB
Python 94.9%
Meson 3.8%
Shell 0.9%
CSS 0.3%
Makefile 0.1%
Go to file
ArtyIF cbda02d590 Added readme and improved load error handling
2022-07-18 17:11:46 +03:00
data Initial commit 2022-07-17 14:46:05 +03:00
po Initial commit 2022-07-17 14:46:05 +03:00
src Added readme and improved load error handling 2022-07-18 17:11:46 +03:00
com.github.ArtyIF.AdwCustomizer.json Preparing to add custom presets support 2022-07-17 22:27:57 +03:00
com.github.ArtyIF.AdwCustomizer.json~ Initial commit 2022-07-17 14:46:05 +03:00
COPYING Initial commit 2022-07-17 14:46:05 +03:00
meson.build Added readme and improved load error handling 2022-07-18 17:11:46 +03:00
README.md Added readme and improved load error handling 2022-07-18 17:11:46 +03:00

README.md

AdwCustomizer

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

Building and Installing

  1. Clone this repository git clone https://github.com/ArtyIF/AdwCustomizer.git
  2. Open the project with GNOME Builder
  3. Press the Build (hammer in the header bar) button
  4. Press on the status panel and click "Export Bundle" to export the app as a Flatpak bundle
  5. Install the bundle with flatpak install <path to bundle> or through a GUI application of your choice (like GNOME Software and KDE Discover)

WARNING: The project currently uses the master version of org.gnome.Platform and depends on some Adw classes that are not yet available in the latest stable version of org.gnome.Platform (42 at the time of writing). Flathub only ships stable versions of packages, so make sure you have a Flatpak repository that ships the needed dependency versions before installing.

Setup Tutorial

Libadwaita applications

No additional setup is required for native Libadwaita applications.

For Flatpak Libadwaita applications, you need to override their permissions by:

  • Running sudo flatpak override --filesystem=xdg-config/gtk-4.0
  • Using 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 by:
    • Running sudo flatpak override --filesystem=xdg-config/gtk-3.0
    • Using Flatseal and adding xdg-config/gtk-3.0 to Other files in the Filesystem section of All Applications

Roadmap

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

  • Customizing named colors, either with a color picker or with text
  • Explanations for some named colors
  • Partial preview of changed variables
  • Adwaita and Adwaita Dark built-in presets (based on default libadwaita colors)
  • Creating and loading custom presets
  • Applying changes to libadwaita, GTK4 (with extracted libadwaita theme) and GTK3 (with the adw-gtk3 theme) applications
  • Showing adw-gtk3's support of variables
  • Customizing the palette
  • Adding custom CSS code
  • Normalizing color variables to hexadecimal or rgba(r, g, b, a) format depending on settings
  • Full theme preview