HyprEditor

A visual desktop editor for Hyprland configuration files.

HyprEditor is a personal free-time project built as an alternative to manually editing hyprland.conf in a terminal or text editor. It is still early, still being polished, and not every part of Hyprland is covered perfectly yet — but the goal is to make common configuration changes easier, safer, and more approachable.

Status

HyprEditor is currently early-stage and under active development in my spare time. Expect rough edges, incomplete previews, and parts of the UI that will improve over time.

If you prefer editing your config by hand, that workflow is still valid. HyprEditor is meant to be an alternative for people who want sliders, toggles, pickers, and searchable sections instead of constantly jumping between config files and documentation.

Note: This has only been tested on CachyOS and within my own workflow so far. I can’t guarantee that it will work correctly on other Linux distributions or setups yet.

What it does

• Auto-detects ~/.config/hypr/hyprland.conf when possible.
• Loads sourced / included config files alongside the main config.
• Provides sliders for numeric settings such as gaps, rounding, blur, opacity, cursor values, and more.
• Provides toggles for boolean settings and dropdowns for select-style options.
• Includes color pickers for things like borders, shadows, glow, splash colors, and other color-backed settings.
• Supports list-style entries like binds, exec rules, env vars, source directives, monitor rules, permissions, and more.
• Includes live search across config keys and values.
• Preserves the config as editable lines in memory instead of regenerating the entire file from scratch.
• Creates a .hypreditor.bak backup when saving.

Current scope

HyprEditor currently includes editable sections for:

• Appearance: General, Decoration, Blur, Shadow, Glow.
• Animations: Animation settings, bezier curves, animation rules.
• Layouts: Layout core, Dwindle, Master, Groups.
• Input: Keyboard, Mouse, Touchpad, Gestures, device-related blocks, virtual keyboard.
• System / Devices: Monitor rules, XWayland, environment variables.
• Misc / Behavior: Misc, Cursor, Render, OpenGL, Ecosystem, Experimental, Debug.
• Rules: Window rules and layer rules.
• Keybindings: bind settings and multiple bind entry types.
• Wallpaper: apply wallpaper for your current homescreen.
• Waybar: edit your waybar's config or css.
• Startup / Permissions / Includes: exec, exec-once, permission rules, and source directives.

Install

git clone https://github.com/kusoidev/HyprEditor.git
cd HyprEditor
chmod +x install.sh
./install.sh

Then run:

hypreditor

Development

npm install
npm start

With devtools:

npm run dev

Editing behavior

• Slider, toggle, select, and color changes update the in-memory representation immediately.
• Text input updates are debounced briefly before being applied.
• Missing settings can be inserted with Auto-set before editing them.
• List entries can be added inline and removed by commenting them out until save.
• Some settings may ask for confirmation before applying riskier changes.

Backup & safety

Each save creates a backup of the original config as:

~/.config/hypr/hyprland.conf.hypreditor.bak

You can restore it with:

cp ~/.config/hypr/hyprland.conf.hypreditor.bak ~/.config/hypr/hyprland.conf

Note: There's now a new button where u can manually press to restore from backup.

AI usage note

This project was built by me in my free time, and some parts of it were developed with AI assistance.

AI was used as a coding assistant for things like brainstorming, debugging help, refactoring suggestions, and parts of the HTML/CSS/UI work. The project is not fully AI generated, and I still review, modify, and test the code myself before keeping changes.

I’m adding this note for transparency since I know some people care about how software is made, especially in open source projects.

Limitations

• This project is still incomplete and being polished.
• Some advanced Hyprland rules are still edited as raw list entries instead of richer structured editors.
• Live preview is currently partial and mainly intended as a visual estimate, not a perfect representation.
• Hyprland changes quickly, so schema coverage and wording may lag behind upstream changes until updated.

Why this exists

I made this because manually editing Hyprland configs in the terminal gets repetitive, especially for settings that are easier to understand as sliders, toggles, grouped sections, and searchable controls. HyprEditor is my attempt to make that workflow easier without taking away the ability to still work with normal Hyprland config files.

Contributing

Issues, suggestions, and pull requests are welcome.

If something is inaccurate, outdated, or missing from the schema, feel free to open an issue. Hyprland evolves fast, and keeping editors like this up to date takes ongoing work.

Requirements

• Linux
• Node.js 18+
• npm
• Electron (installed automatically through npm install)