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
bar widgets
9
panels
6
desktop cards
4
terminals supported

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

~/.config/hecate/hecate.toml
[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"]
The hecate command
hecate check     # look for updates
hecate update    # update the dotfiles
hecate theme     # switch dynamic or static colors
hecate lock      # pick a lock screen layout

03 / 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

Install
bash <(curl -fsSL https://raw.githubusercontent.com/Nurysso/Hecate/main/install.sh)
Check only
git clone https://github.com/Nurysso/Hecate.git ~/Hecate && cd ~/Hecate && ./install.sh --check

Supports Arch and Arch-based systems (Manjaro, EndeavourOS, CachyOS). Other distributions are not supported yet.

07 / 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.