🌙 Hecate

A Hyprland rice with auto-theming from wallpapers
Comes with GUI config tools and desktop widgets

🎬 See It In Action

💿 Installation

✨ Usage

🌟 Features

Dynamic Theming Your wallpaper picks the colors Colors get auto-extracted from your wallpaper and applied system-wide. Change your wallpaper, change your whole vibe. ✦ Uses PyWall under the hood Hecate Settings GUI No longer maintained GUI for people who don't want to edit config files A new tool will be launched soon A graphical tool to tweak your setup: Keybind Editor — Edit keybinds visually Waybar Customizer — Switch bar layouts and styles Preferences Manager — Toggle theme modes and settings Theme Selector — Browse and apply color schemes Monitor Configuration — Arrange monitors with drag-and-drop Alternative: try hyprsettings — another solid Hyprland GUI config tool. Smart Installation Asks what you want before installing Pick your terminal, shell, browser, and profile during install. Less manual editing later.

QuickShell Widgets ⭐ Updated Desktop widgets that are 🤌 🕐 Clock Widget — Shows time and date 🚀 QuickApps — Quick app launcher 💻 System Info — CPU, GPU, RAM stats 🎵 Audio Visualizer — Cava audio viz built-in Github Contribuition — This one for the devs Multi-Shell Support Pick your shell Supports Bash, Zsh, and Fish. Choose during install: Bash • Zsh • Fish Multiple Terminals Use what you like Pick your terminal during install: Alacritty • Kitty • Foot • Ghostty Safe Backups Won't nuke your configs Backs up existing configs before installing.

🎯 Supported Applications

Hecate provides beautiful, coordinated configurations for all your favorite tools

Category	Applications
Compositors	Hyprland
GUI Tools	Hecate Helper (Keybinds • Waybar • Themes • Monitors)
Widgets	QuickShell (Clock • QuickApps • System Info • Audio)
Terminals	Alacritty • Kitty • Foot • Ghostty
Shells	Bash • Zsh • Fish
Bars	Quickshell
Notifications	SwayNC
Launchers	Rofi
Logout	Wlogout
Wallpapers	Waypaper
System Info	Fastfetch

📦 Installation

🚀 Quick Start

Important

Hecate will detect your Os and package manager automatically (pacman, yay, paru, dnf). If paru is installed on your system, the script selects paru to install packages. For dnf well it works kinda but may need manualaly installing few packages

Prerequisites

Ensure you have git, gum, TerminalTextEffects(tte) installed:

paru -S terminaltexteffects git gum

⚡ One-Line Install

curl -fsSL https://raw.githubusercontent.com/nurysso/Hecate/main/install.sh | bash

🔧 Manual Installation

Checkout Documentaion

Installation complete! 🎉

Continue reading to discover all the features...

🎨 Hecate Settings GUI

GUI config tool (or use hyprsettings if this doesn't work)

This is no longer maintained a new project will be released soon. Try hyprsettings instead. It's another great GUI tool for Hyprland configuration.

Hecate-Settings is a GUI tool for configuring Hyprland without editing files

QuickShell Widgets

Enhance your desktop with beautiful, functional widgets

Configuration

Fine-tune Hecate to match your workflow

Hecate Configuration File

Hecate stores your preferences in ~/.config/hecate/hecate.toml:

# Hecate Dotfiles Configuration
# This file manages your Hecate installation settings

[metadata]
version = "0.4.9 shy eagle"
install_date = "2025-10-15"
last_update = "2025-10-15"
repo_url = "https://github.com/nurysso/Hecate.git"

[theme]
# Theme mode: "dynamic" or "static"
# dynamic: Automatically updates system colors when wallpaper changes
# static: Keeps colors unchanged regardless of wallpaper
mode = "dynamic"

[preferences]
term = "kitty"
browser = "firefox"
shell = "fish"
profile = "minimal"

Configuration Structure

All configuration files are located in ~/.config/:

~/.config/
├── hypr/              # Hyprland configuration
├── rofi/              # Application launcher themes
├── swaync/            # Notification center
├── wlogout/           # Logout menu
├── quickshell/        # Widget And Bar configurations
├── alacritty/         # Terminal configs
├── kitty/             # Terminal configs
├── foot/              # Terminal configs
├── ghostty/           # Terminal configs
└── hecate/            # Hecate main config

Dynamic Theming in Action

Hecate uses PyWall to intelligently extract colors from your wallpaper

Colors are automatically applied to:

Bar — Status bar colors and modules Rofi — Application launcher themes SwayNC — Notification styling

Wlogout — Logout menu appearance QuickShell Widgets — Widget color schemes Terminals — Alacritty, Kitty, Foot, Ghostty

✨ Simply change your wallpaper with SUPER+CTRL+W

and watch your entire desktop environment transform!

Keybindings

Hecate automatically generates keybindings based on your preferred applications

Key Combination	Action
SUPER + Return	Open Terminal
SUPER + D	Application Launcher (Rofi)
SUPER + H	Hecate Settings Keybind GUI
SUPER + CTRL + W	Wallpaper Selector
SUPER + SHIFT + N	Toggle Notifications
SUPER + Q	Close Window
SUPER + 1-9	Switch Workspace
SUPER + SHIFT + 1-9	Move Window to Workspace

Note

Full keybinding list available in ~/.config/hypr/config/keybinds.conf or in the Hecate-Settings GUI

🤝 Contributing

Contributions are welcome! Here's how you can help:

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║ Fork  →  Create Branch  →  Add feature  →  Push  →  PR        ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

Contribution Steps

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Add feature your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🐛 Troubleshooting

Hecate-Settings won't launch

# Run in terminal to see the error
Hecate-Settings

# If it doesn't work, try hyprsettings instead
# Install: yay -S hyprsettings-git
# Run: hyprsettings

Widgets not showing up

# Restart QuickShell
pkill quickshell
quickshell

Theme not applying to all applications

# Regenerate theme
wal -n -i path/to/wallpaper.png
#  Check ~/.config/waypaper/config.ini have this line
post_command = ~/.config/hecate/scripts/hecate-system-colors.sh
# If still not changed then try manual running
~/.config/hecate/scripts/hecate-system-colors.sh

This project is licensed under the GNU-gpl3 License

See the LICENSE file for details

Acknowledgments

Built on the shoulders of giants

Amazing Wayland compositor

Color palette generation

Widget framework

Audio visualizer

Made with ♥ by nurysso

_{Hecate — Greek goddess of magic, crossroads, and transformation}