Omahub
← All plugins
D

Keybind Manager

by Deoxizn

Add, override, and disable Hyprland keybindings from the bar, with a rolling backup and one-click revert.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
8189c9f
Scanned
1 month 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
8189c9f
Reviewed
1 month ago

The plugin is a well-structured keybind manager that restricts actions to curated whitelists and validates inputs, with no obfuscation or hidden behavior. The main risk is that it modifies the user's Hyprland configuration and reloads the compositor, which could disrupt the session, but this is clearly documented and user-initiated.

  • The plugin rewrites ~/.config/hypr/bindings.lua and reloads Hyprland on every change, which could cause temporary disruption if the generated config has errors, though it reports configerrors.
  • The apply.sh script uses `pkill hyprpicker || hyprpicker -a` for the color-picker action, which could kill an unrelated process if hyprpicker is running, but this is a minor side effect.
  • The plugin relies on `omarchy menu keybindings --print` to detect existing bindings; if that command is unavailable or misbehaves, detection may fail, but it does not pose a security risk.
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/Deoxizn/keybind-manager --enable
System #Hyprland

Keybind Manager

An Omarchy plugin for turning any key into an action — without editing config files by hand. Pick a key combo, pick what it does, and it lands in ~/.config/hypr/bindings.lua via a managed, marker-delimited block that survives config updates and shows up in the Omarchy keybindings menu.

Features

  • Manage from the bar. A keyboard button on the bar opens a panel listing every managed keybind, with remove / re-enable controls and an add form.
  • Curated actions only. Binds are restricted to launch presets, Omarchy system commands, window/workspace dispatchers, and web-app URLs. No free-form shell commands are accepted, so nothing can break out of the generated config.
  • Override or disable defaults. If a key is already bound in the live config, the panel tells you what it currently does and the generated block unbinds it before binding your action. You can also add "unbind default" entries that just remove a stock binding.
  • Config-aware. Every change snapshots bindings.lua, rewrites only the managed block, reloads Hyprland, and reports hyprctl configerrors back. The last pre-change file is kept at bindings.lua.bak and can be restored with reset/revert from the CLI.

Installation

omarchy plugin add https://github.com/deoxizn/keybind-manager.git --enable

omarchy plugin add clones the repo, validates it, and enables the widget in the left section of the bar (the manifest's default; it asks for a section when run interactively).

Updating

omarchy plugin update dev.deoxizn.keybind-manager

omarchy plugin update fetches the latest version, shows the diff, and asks before applying it. Run it without an id to update every installed git-managed plugin.

Uninstall

omarchy plugin remove dev.deoxizn.keybind-manager

The plugin also registers a service, so the panel stays in sync across every instance.

Usage

Add a keybind

  1. Click the keyboard icon on the bar (or bind its IPC toggle).
  2. Type the keys, e.g. SUPER + K.
  3. Pick a kind and an action.
  4. Click Add keybind.

If the combo is already bound, the panel shows what it currently does, and the entry is recorded as overriding it. Re-adding an already-managed combo is rejected.

Unbind a default

Pick Unbind default in the add form, enter the keys (the current binding is auto-detected), and add. The default is removed from the live config while everything else stays untouched.

Remove or re-enable

Use the close / restore button on a row.