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

Understand and restore a Caps Lock key that appears dead

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

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.

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

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.

Sources

caps-lock-does-nothing