So here it is! haha....well, at least the first release. Still a lot to polish, a lot of things in mind, but I feel pressured by some asking me where’s the github link lol. I locked in and didn’t leave my room a lot for just to have a working ui.

Anyway, here’s the link. https://github.com/acropolis914/hyprsettings/ (Contributions,discussions and pull requests are welcome! and please I need ppl haha)

Overview

hyprsettings provides a graphical UI for editing Hyprland configuration files. Please note:

This application is very much in its alpha state. Features may break, things may not work, and many aspects will still change.

Contributions and pull requests are welcome!

Onboarding / What’s Working

Keybind editor & line comment editor.

Toggle comments: Remove # to turn a config line into an active key (when valid).

Basic theming, settings, and autosave support.

Automatic writing of config to ~/.config/hypr/hyprsettings.toml.

Auto font selection for Nerd Font icons — see instructions for customizing your font.

What’s NOT (Yet) Working

Globbing of source files: Only individual/relative files for now.

Adding new config items: Must be added manually to your config.

Editing config lines: Not fully implemented yet.

Keyboard navigation inside items: Not fully supported.

Usage & Shortcuts

F1: Show/hide onboarding screen

F5: Reload window (some elements update)

Arrows: Navigate

Enter: Opens key editor modal

Esc: Exit editor modal

Delete: Delete item (will ask for confirmation)

Roadmap / Coming Updates

[ ] Globbing of source files

[ ] Improved keyboard navigation

[ ] Tooltips & Hyprland documentation support

[ ] Item sliders, color/gradient selectors

[ ] nvim-like motions

Disclaimer: During the whole development of this, I used my actual hyprland.conf and first made sure that the parser builds it to an almost one to one copy after parsing. But please, make a copy of your conf just in case, see the code if you want to, they’re all there and I haven’t stripped anything at all. What I got here is what you’ll get.

Go try it and tell me what you guys think!