Omahub
Sign in with GitHub
← 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
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.