OmaSettings

One window for every Omarchy setting, from Hyprland to your keybindings to tmux.

• Find anything. Type "blur" or "gaps" and every setting that touches it appears with its current value, whatever file it normally lives in.
• Look and feel. Theme, font, text size, gaps, borders, rounding, opacity, blur, shadows, animations and their speed, window group tabs, tiling layout.
• The bar. Position, transparency, which widgets sit where, and which plugins are enabled, plus add, remove and update them.
• Keybindings. Browse every binding you have, add your own, turn Omarchy's off, put them back. No Lua.
• Compose keys. Your ~/.XCompose sequences as a list you can add to and remove from.
• Input and displays. Keyboard layout, repeat rate, mouse and touchpad behaviour, per-monitor scale, and one device can differ from the rest.
• Applications. Settings for tmux, Herdr and Neovim, written into their real configs.
• The live stuff. Audio, network, bluetooth and power, so those widgets can leave the bar, if you want more space for other widgets.
• Undo. Anything you changed is marked and goes back, one setting or all of them at once.

Why I built it

I wanted a fast overview of everything I could change, and an easier way to find out which settings Hyprland actually has. Easier management of keybindings and ~/.XCompose was the other part.

Dropping a few widgets like audio from the bar frees space for ones I get more out of. And hopefully someone else finds it useful too.

Install

omarchy plugin add https://github.com/twiking/omasettings.git --enable

Usage

Click the gear in the bar to open the window, or find it in the launcher as OmaSettings.

How it writes

Your config files are never parsed and rewritten, since that is how a settings app eats someone's setup. Instead:

• Hyprland settings are applied live with hyprctl eval and written to a file of its own, ~/.config/hypr/omasettings.lua, loaded last from a single require line appended to your hyprland.lua. Your own files keep saying exactly what you wrote.
• Keybindings live in a marked block in bindings.lua. Everything outside the markers is copied through untouched.
• Everything else, meaning Herdr, tmux and Neovim, is edited one value at a time, in place, keeping the comment attached to the line it belongs to.

Before the first write to any file you could have written yourself, a copy is kept beside it as <file>.omasettings.bak. Every write is checked in the format's own terms, with herdr config check, by compiling the Lua, or by applying the tmux option, and rolled back if it fails.

Requirements

Tool	Needed for
jq	Everything, it does every read and write
pactl	Audio
nmcli	Network
bluetoothctl	Bluetooth
upower, powerprofilesctl	Power
timedatectl	Date & Time
tmux, nvim, herdr	Their own pages under Applications
xkbcli	Checking a keyboard layout compiles before writing it

Only jq is required. A page whose tool is missing says so instead of failing. Nothing here needs root, and nothing is installed on your behalf.

Remove

omarchy plugin remove io.github.twiking.omasettings

The launcher entry it wrote is deleted with it.

License

MIT, see LICENSE.