Omahub
← All plugins
T

OmaSettings

by Tobias Wiking

One window for every Omarchy setting, from Hyprland to your keybindings to tmux. Searchable, and anything you change can be put back.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
72cfe16
Scanned
3 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
72cfe16
Reviewed
3 weeks ago

No malicious or hidden behavior was found in the reviewed code; it is a transparent settings manager that writes user configs through guarded helpers with backups and validation, and runs external commands only in response to explicit UI actions. The deterministic scan's "none" matches this review. Residual risk is the ordinary risk of any tool that edits real config files and can update other plugins, not evidence of malware.

  • The plugin intentionally has broad write and execute capability: it edits Hyprland, tmux, Neovim, Herdr, and ~/.XCompose configs, and runs actions defined in the Omarchy menu configuration. This is expected for a settings app, but users should understand the plugin can change their system configuration.
  • The Plugins page can fetch and update installed plugins after an explicit user click; this carries the normal supply-chain risk of updating software from upstream repositories, but no hidden or automatic update behavior was found.
  • The launcher entry installation is marker-guarded and refuses to overwrite user-owned or symlinked files, so no hidden persistence was identified.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/twiking/omasettings --enable
System #Hyprland #quickshell #system

OmaSettings

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

<p align="center"><img src="preview.png" alt="The OmaSettings window" width="800"></p>
  • 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.
  • Workspaces. Bind an application to a workspace or a display, open it there in the background, floating, pinned or fullscreen, start it when you log in, keep the screen awake or hide it from screen sharing. And set up the workspaces themselves: name, display, layout, kept when empty, borderless.
  • 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.