Understand and restore a Caps Lock key that appears dead
Cause is exactly right and confirmed: default/hypr/input.lua sets kb_options with a comment reading 'CapsLock is the compose key, so Caps Lock itself has to live somewhere else', and manual/45-troubleshooting.md documents the same remap. Only the config format is stale: current Omarchy uses ~/.config/hypr/input.lua with an hl.config() call, not the input { } .conf block. One substantive omission: the actual default is compose:caps,shift:both_capslock_cancel, so replacing kb_options with just compose:ralt silently drops the shift:both_capslock_cancel behavior. Also worth noting Omarchy appends grp:alts_toggle automatically when multiple layouts are configured.
Symptom
Caps Lock appears dead: pressing it doesn't toggle capitals, and the LED doesn't light. Users assume the keyboard or the install is broken.
Cause
Omarchy remaps Caps Lock to the XCompose key by default (kb_options = compose:caps), so it can be used for emoji and special-character sequences. It is intentionally no longer Caps Lock.
Fix
Move Compose to another key and give Caps Lock back. Edit ~/.config/hypr/input.lua:
hl.config({
input = {
kb_options = "compose:ralt",
},
})
Note that Omarchy's real default is compose:caps,shift:both_capslock_cancel. If you want to keep the second behavior (both Shift keys cancel Caps Lock), carry it over:
hl.config({
input = {
kb_options = "compose:ralt,shift:both_capslock_cancel",
},
})
To drop Compose entirely, set an empty value:
hl.config({
input = {
kb_options = "",
},
})
The same file is where multi-layout switching lives:
hl.config({
input = {
kb_layout = "us,fr",
kb_options = "compose:ralt,grp:alts_toggle",
},
})
Apply it:
hyprctl reload
On an older Omarchy 3 install this is ~/.config/hypr/input.conf using the input { kb_options = compose:ralt } block syntax.
Verify
hyprctl getoption input:kb_options shows the new value and Caps Lock toggles capitals again.