OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
hyprland-config low common DISPUTE

Fix unbind doing nothing because the key name's case is wrong

hyprlandomarchyarchendeavouroscachyos
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

The central claim is verbatim wiki text. The current Binds page states: 'In unbind, key is case-sensitive It must exactly match the case of the bind you are unbinding.' hyprctl binds is a documented info command. The Omarchy override block is confirmed almost character-for-character against config/hypr/bindings.lua in the omarchy repo, which ships exactly hl.unbind("SUPER + SPACE") followed by o.bind("SUPER + SPACE", "Omarchy menu", "omarchy-menu toggle root") as its worked example. hl.unbind("SUPER + TAB") is correct. The one defect: the runtime-test line hyprctl keyword unbind SUPER, TAB is hyprlang-era and is presented unlabeled between two 0.55+ Lua blocks. On a current Omarchy 4.x box (Hyprland 0.56, Lua config) a user pastes it and it does not work. The Binds wiki gives the Lua-era equivalent explicitly.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.

Symptom

unbind = SUPER, Tab appears to do nothing. The original binding still fires, and adding your own bind on the same key gives you two actions at once or the wrong one.

Cause

In unbind, the key name is case-sensitive and must match the case used in the original bind exactly. Tab and TAB are different keys as far as the unbind lookup is concerned.

Fix

Everything is correct except the runtime-test command, which is unlabeled hyprlang-era. Use the form that matches your config engine:

hyprlang (<= 0.54):


hyprctl keyword unbind SUPER, TAB

Lua (0.55+), which is the wiki's own example:


hyprctl eval 'hl.unbind("SUPER + TAB")'

Find the exact registered spelling first, since the case must match:


hyprctl binds | grep -A4 -i 'tab'

Verify

hyprctl binds no longer lists the old bind. Pressing the key does only what you expect.

Sources

unbind-case-sensitive-key-name