Hecate
My Hyprland dotfiles, built so you can change them three ways: answer the installer, click a settings app, or edit one TOML file.
- Status
- ● Live
- Year
- 2025
- Stack
- Hyprland · Quickshell · QML · Lua · Rust
- Source
- Nurysso/hecate
- 19
- 9
- 6
- 4
01 / Overview
What it does
Most dotfiles hand you someone else's setup and a pile of config files. Hecate asks what you use when you install, gives you a settings app for the rest, and keeps the fine detail in a single hecate.toml. Colors can follow your wallpaper.
02 / Usage
One file, live reload
[theme]
rounding = 16 # corner radius, 0 for square
opacity = 0.78 # how solid the glass is
blur = true
[bar]
position = "top" # or "bottom"
style = "islands" # "islands", "floating" or "full"
left = ["launcher", "workspaces", "windows"]
center = ["clock"]
right = ["media", "tray", "status", "notifications", "power"]hecate check # look for updates
hecate update # update the dotfiles
hecate theme # switch dynamic or static colors
hecate lock # pick a lock screen layout03 / Depth
Three ways to make it yours
Asked once
The installer asks for your terminal, shell, browser, profile and colors, then installs and wires up exactly that. Existing configs are backed up to ~/.cache/hecate-backup first.
Clicked
Hecate Settings covers gaps, blur, animations, keybinds, monitors, Wi-Fi, audio and widget placement. Changes preview live.
Written
hecate.toml holds the finer points: shell corners, glass, bar shape and every widget. Save it and the desktop updates at once.
04 / Inside
What's inside
Quickshell shell
A frosted-glass bar, a control center, an app launcher, notifications, clipboard history, an emoji picker and desktop cards for clock, weather and system stats.
Colors from your wallpaper
Optional matugen theming reaches the shell, GTK and Qt apps, and the prompt.
Your choice of tools
Kitty, Alacritty, Foot or Ghostty. Zsh, Bash or Fish. Firefox, Brave, Chromium or Chrome.
Four profiles
Minimal, developer, gamer, or both together. Each installs the extra software for that use.
05 / Safety
It will not break your setup
Settings never rewrite your config
Changes apply live but are saved only when you press Apply, to a separate overrides file. Revert puts everything back.
Typos fall back
A value it cannot use reverts to its default and names the problem in the log, so a bad edit does not take down the desktop.
06 / Install
Get it running
bash <(curl -fsSL https://raw.githubusercontent.com/Nurysso/Hecate/main/install.sh)git clone https://github.com/Nurysso/Hecate.git ~/Hecate && cd ~/Hecate && ./install.sh --check07 / Limits
Rough edges
- Arch and Arch-based systems only. The Fedora installer is out of date.
08 / FAQ
Before you try it
- Which distros work?
- Arch and Arch-based systems: Manjaro, EndeavourOS and CachyOS. The Fedora installer is out of date, so use the manual install guide there.
- Will it overwrite my config?
- The installer backs up your existing configs to ~/.cache/hecate-backup first. Settings changes go to a separate overrides file that loads after yours.
- The bar is missing. What now?
- Run qs log to see errors with the file and line. Restart with pkill -x quickshell; quickshell & disown.
- Can I install only the configs?
- Yes. ./install.sh --no-deps skips packages and installs the configs, Hecate Settings and wallpapers.
Hecate
My Hyprland dotfiles, built so you can change them three ways: answer the installer, click a settings app, or edit one TOML file.