Fix SUPER chords flicking through every workspace to 10 on Hyprland 0.56.2
Read both cited issues in full. #12050 (open) carries the root-cause comment the record summarises, and #12711 supplies the 59-of-230 count, the unbind-with-the-code-string workaround and the non-US layout caveat. Confirmed the mechanism in Hyprland v0.56.2 source. parseKeyString in LuaBindingsToplevel.cpp stores a code:N token as (XKB_KEY_NoSymbol, N) and never sets kb.key. handleKeybinds in KeybindManager.cpp skips a single-key bind only when both keysym and keycode differ. On this workstation (4.0.4-1, hyprland 0.56.2-2) hyprctl binds -j reports 59 keyless binds of 228, which matches the record. Counted the code: binds in /usr/share/omarchy/default/hypr/bindings/tiling.lua and utilities.lua: 30 workspace, 12 resize, 5 group, 9 panel, 2 webcam and 1 menu, total 59. They are unchanged on quattro. v0.56.2 is still the latest Hyprland release. hl.unbind compares the normalised displayKey, so unbinding with the code: string does match. No default bind uses minus, equal, brackets or bare digits, so the replacement binds collide with nothing. The panel command string matches utilities.lua. One minor imprecision: v4.0.2 and v4.0.3 already shipped the same code: binds, so the trigger is Hyprland 0.56.2 rather than 4.0.4 itself. The symptom quotes the reporters and the title already names 0.56.2, so I left it. The rebind block was not exercised, because doing so would change the operator's session.
Binding by key name ties these shortcuts to one keyboard layout. Anyone switching between layouts with different digit rows will find them dead on the other layout. Undo the block once Hyprland ships the matcher fix, or the unbinds will remove working code: binds.
Symptom
After updating to Omarchy 4.0.4, pressing SUPER (alone, or SUPER+Return, SUPER+Space) races through workspaces 1, 2, 3 ... 10 and leaves you on workspace 10. The terminal you just opened lands on workspace 10, often on the wrong monitor. SUPER+SHIFT+anything throws the focused window to workspace 10. On other machines SUPER+1..0 simply do nothing. hyprctl configerrors is empty, but hyprctl binds -j lists dozens of binds with "key": "" and "keycode": 0.
Cause
Hyprland 0.56.2's Lua bind parser stores a MODS + code:N key as a keysym of 0 (XKB_KEY_NoSymbol) plus keycode N and never fills the displayed key, which is why hyprctl binds -j shows key: "". The matcher in CKeybindManager::handleKeybinds skips a bind only when BOTH the keysym and the keycode differ, so any key event whose keysym is also 0 matches every code: bind that shares its modifiers, and they fire in registration order. Laptop hotkey devices that emit unmapped keys (one report traced it to an LG WMI hotkeys device sending KEY_UNKNOWN beside normal presses) and virtual keyboards produce exactly those events. Omarchy 4.0.4 writes 59 default binds this way (default/hypr/bindings/tiling.lua: workspaces 1 to 10 switch, move and move silently, the 12 resize binds on code:20/code:21, group windows 1 to 5, and in utilities.lua the 9 bar panels, the 2 webcam overlay binds and the Omarchy menu on code:201). The workspace loop is registered last among them, so the walk ends on 10. Hyprland main has rewritten the matcher so a NoSymbol event no longer matches a code: bind, but that was read in source by a reporter and not confirmed in a release. The reports where SUPER+1 never fires at all are not explained by the same mechanism and their cause is not established. Confirmed on this workstation (Omarchy 4.0.4-1, Hyprland 0.56.2-2): 59 of 228 registered binds are keyless.
Fix
Confirm you have the keyless binds:
hyprctl binds -j | jq '[.[] | select(.key == "" and .keycode == 0)] | length'
A stock Omarchy 4.0.4 install reports 59.
**Omarchy 4.** Rebind them by key name in ~/.config/hypr/bindings.lua. Each code: bind must be unbound first with the exact same string, or the new bind stacks beside the broken one and the cascade continues. hl.unbind with the code: string does match the keyless bind.
-- Hyprland 0.56.2 matches every "code:N" bind on any key event with keysym 0.
-- Rebind Omarchy's code: binds by key name. Remove once a Hyprland release fixes it.
local digits = { "1", "2", "3", "4", "5", "6", "7", "8", "9", "0" }
for ws = 1, 10 do
local code = "code:" .. tostring(ws + 9)
local key = digits[ws]
local target = tostring(ws)
hl.unbind("SUPER + " .. code)
hl.unbind("SUPER + SHIFT + " .. code)
hl.unbind("SUPER + SHIFT + ALT + " .. code)
o.bind("SUPER + " .. key, "Switch to workspace " .. ws, hl.dsp.focus({ workspace = target }))
o.bind("SUPER + SHIFT + " .. key, "Move window to workspace " .. ws, hl.dsp.window.move({ workspace = target }))
o.bind("SUPER + SHIFT + ALT + " .. key, "Move window silently to workspace " .. ws, hl.dsp.window.move({ workspace = target, follow = false }))
end
for index = 1, 5 do
hl.unbind("SUPER + ALT + code:" .. tostring(index + 9))
o.bind("SUPER + ALT + " .. digits[index], "Switch to group window " .. index, hl.dsp.group.active({ index = index }))
end
for panel = 1, 9 do
hl.unbind("SUPER + CTRL + code:" .. tostring(panel + 9))
o.bind("SUPER + CTRL + " .. digits[panel], "Bar panel " .. panel, "omarchy-shell -q shell togglePanelAt right " .. panel)
end
-- code:20 is the minus key and code:21 the equal key on a US layout
local resize = {
{ "SUPER + ", -100, 0, 100, 0 },
{ "SUPER + SHIFT + ", 0, -100, 0, 100 },
{ "SUPER + ALT + ", -25, 0, 25, 0 },
{ "SUPER + SHIFT + ALT + ", 0, -25, 0, 25 },
{ "SUPER + CTRL + ", -300, 0, 300, 0 },
{ "SUPER + CTRL + SHIFT + ", 0, -300, 0, 300 },
}
for _, r in ipairs(resize) do
hl.unbind(r[1] .. "code:20")
hl.unbind(r[1] .. "code:21")
o.bind(r[1] .. "minus", "Resize window", hl.dsp.window.resize({ x = r[2], y = r[3], relative = true }))
o.bind(r[1] .. "equal", "Resize window", hl.dsp.window.resize({ x = r[4], y = r[5], relative = true }))
end
hl.unbind("SUPER + ALT + code:34")
hl.unbind("SUPER + ALT + code:35")
o.bind("SUPER + ALT + bracketleft", "Make webcam overlay smaller", "omarchy-capture-webcam-resize smaller")
o.bind("SUPER + ALT + bracketright", "Make webcam overlay larger", "omarchy-capture-webcam-resize larger")
The Omarchy menu bind SUPER + SHIFT + code:201 has no key name equivalent in the reports. It only fires on SUPER+SHIFT, so leave it, or remove it with hl.unbind("SUPER + SHIFT + code:201").
The digit names above work only where the digits are on the unshifted level. On AZERTY, Czech and similar layouts use that layout's level-1 keysyms instead (read them with wev, the sym field), for example ampersand, eacute, quotedbl on French AZERTY, or plus, ecaron, scaron on Czech.
**Plain Arch with your own Lua config.** Do not use code:N in hl.bind on 0.56.2. Bind the keysym name instead (hl.bind("SUPER + 1", ...)), and run the same hyprctl binds -j check after each reload.
Verify
hyprctl binds -j | jq '[.[] | select(.key == "" and .keycode == 0)] | length'
reports 0 (or 1 if you left the code:201 menu bind). A bare SUPER tap no longer changes workspace, SUPER+Return opens the terminal on the current workspace, and SUPER+1 still switches to workspace 1.
Sources
- https://github.com/omacom/omarchy/issues/12050
- https://github.com/omacom/omarchy/issues/12711
- https://wiki.hypr.land/Configuring/Basics/Binds/
- https://github.com/hyprwm/Hyprland/blob/v0.56.2/src/config/lua/bindings/LuaBindingsToplevel.cpp
- https://github.com/hyprwm/Hyprland/blob/v0.56.2/src/managers/KeybindManager.cpp