data | ||
pictures | ||
po | ||
src | ||
com.github.ArtyIF.AdwCustomizer.json | ||
com.github.ArtyIF.AdwCustomizer.json~ | ||
COPYING | ||
meson.build | ||
README.md |
AdwCustomizer
AdwCustomizer is a tool for customizing Libadwaita applications and the adw-gtk3 theme.
Building and Installing
- Clone this repository
git clone https://github.com/ArtyIF/AdwCustomizer.git
- Open the project with GNOME Builder
- Press the Build (hammer in the header bar) button
- Press on the status panel and click "Export Bundle" to export the app as a Flatpak bundle
- 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 oforg.gnome.Platform
and depends on someAdw
classes that are not yet available in the latest stable version oforg.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
- Running
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:
- Ability to customize named colors, either with a color picker or with text
- Explanations for some named colors
- Partial preview of changed variables
- Built-in presets for Adwaita and Adwaita Dark (based on default libadwaita colors)
- Ability to apply changes to libadwaita, GTK4 (with extracted libadwaita theme) and GTK3 (with the adw-gtk3 theme) applications
- Ability to load and create custom presets
- Ability to view adw-gtk3's support of variables
- Ability to customize palette colors
- Ability to add custom CSS code
- Ability to normalize color variables to hexadecimal or
rgba(r, g, b, a)
format - Full theme preview