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

Find the trailing comma that makes a keybinding silently do nothing

hyprlandarchendeavouroscachyosmanjaroomarchy
AUDITED Audited against its sources and confirmed accurate.

Symptom

A keybinding does nothing at all, silently: no error, no notification. E.g. bind = SUPER, F, exec, firefox, never launches Firefox, while the identical-looking line for another app works.

Cause

hyprlang's bind keyword takes exactly four comma-separated arguments. An accidental trailing comma becomes part of the last argument, so Hyprland tries to exec the literal command firefox, which does not exist. Example configs legitimately end with a trailing comma when the last argument is meant to be empty (bind = SUPER, Tab, cyclenext,), which is where the habit comes from.

Fix

Count the commas: exactly three.


bind = SUPER, F, exec, firefox      # OK   - 4 args
bind = , Print, exec, grim          # OK   - empty mods
bind = SUPER, Tab, cyclenext,       # OK   - empty params, dispatcher takes none
bind = SUPER, F, exec, firefox,     # WRONG - execs `firefox,`

Find offenders across your config:


grep -rnE '^\s*bind[a-z]*\s*=.*exec,.*,\s*$' ~/.config/hypr/

On Lua (0.55+) this class of bug is gone, because args are explicit:


hl.bind("SUPER + F", hl.dsp.exec_cmd("firefox"))

Verify

hyprctl binds lists the bind with the correct arg, and the key works after hyprctl reload.

Sources

keybind-trailing-comma-hyprlang