Manage your Hyprland settings with style.
Hyprset is an all-in-one settings manager for the Hyprland ecosystem (GTK4/libadwaita). The goal is a complete settings panel that allows maximum customization with minimal configuration writing, while also letting you define custom themes and files that load with the system.
See docs/ROADMAP.md.
Python 3, GTK 4, libadwaita — applied live through hyprctl.
python3 src/main.pyhyprset theme ... subcommands work the same way:
python3 src/main.py theme list.
From the AUR (once published):
paru -S hyprset # or: yay -S hyprsetOr build the packages yourself from a clone with the included
build.sh, which checks the build dependencies and drives
the split PKGBUILD (producing both hyprset and the
hyprset-desktop meta-package) out of tree — the repo's src/
directory collides with makepkg's default $srcdir, so never run bare
makepkg here:
./build.sh install # build both, install hyprsetInstalls the hyprset launcher, desktop entry, and icon system-wide.
See docs/BUILDING.md for the full guide (AUR, releases,
the desktop meta-package and its first-boot onboarding).
Hyprset keeps its data (themes, active theme, defaults, dock profiles)
under ~/.config/hypr/hyprset/ and its thumbnail cache under
~/.cache/hyprset/. Every location can be overridden in
~/.config/hypr/hyprset.toml:
[paths]
# Root for themes/, .active-theme, defaults.conf, docks.json.
# Overriding only this relocates the whole tree — file names inside
# stay the same, so pointing it at an existing directory just works.
data = "~/.config/hypr/hyprset"
# Optional per-item overrides (defaults derive from `data`):
# themes = "..."
# active_theme = "..."
# defaults = "..."
# docks = "..."
# cache = "~/.cache/hyprset/thumbs"XDG_CONFIG_HOME/XDG_CACHE_HOME are honored for all defaults.
pip install .Requires the distro's GTK stack (python-gobject, gtk4, libadwaita);
these are not pip-installable dependencies.