OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
audio-input high occasional DISPUTE

Stop letters typing digits on Apple and small laptop keyboards under Omarchy

omarchyhyprlandapplelaptopdesktop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

Issue #8912 (open) and the maintainer bot's reproduction support the symptom, the hid-apple numlock emulation for 05ac:023a, plain F6 as the escape, the per-device hl.device workaround verified with hyprctl reload && hyprctl configerrors, the lock and polkit impact with the faillock lockout, and the move of numlock_by_default from the user's input.conf in Omarchy 3 to default/hypr/input.lua in 4.0.0. Confirmed here: /usr/share/omarchy/default/hypr/input.lua sets numlock_by_default = true on 4.0.4-1 and quattro, hyprctl getoption input:numlock_by_default is true, and /etc/pam.d/omarchy-lock-password has deny=10 unlock_time=120. The Hyprland wiki devices page confirms hl.device({ name = ..., <input option> }) and config-options lists numlock_by_default default false, so the plain Arch branch holds. A 2026-09-21 comment confirms the laptop case on 4.0.4-1 (Gemini IV, M typing a dash). One defect in the cause: "The translation happens in the kernel above evdev" is true only for hid-apple. On a laptop with an embedded Fn keypad the keyboard firmware or embedded controller sends the keypad codes itself while the NumLock LED is lit. The corrected cause separates the two. Not exercised: any Apple or embedded-keypad hardware.

The cause above was rewritten on 2026-10-05 to match this note; the fix was corrected by the audit itself.
RISK

If this hits at the lock screen, repeated wrong attempts trigger a two-minute lockout after ten failures. Press NumLock or F6 before retrying.

Symptom

On an Apple keyboard without a numpad (for example Apple Wireless Keyboard 05ac:023a) or a small laptop with an embedded Fn keypad, ordinary typing produces digits: some keys becomes s60e 2eys. o gives 6, m gives 0, k gives 2. The same keys may type nothing at the lock screen and polkit prompt, making the lock screen effectively unenterable.

Cause

Omarchy 4's packaged /usr/share/omarchy/default/hypr/input.lua sets numlock_by_default = true for every keyboard. On Apple keyboards hid-apple applies numeric-keypad emulation to letter keys while the NumLock LED is lit, even on models with no physical keypad. That translation happens in the kernel driver above evdev, so no layout or compositor rule undoes it. On small laptops with an embedded Fn keypad the keyboard firmware does the same thing itself when NumLock is on, and it reaches the kernel already as keypad codes. Either way the only fix is to keep NumLock off for that keyboard. In Omarchy 3 the setting lived in the user's own input.conf, in Omarchy 4 it moved into the packaged defaults.

Fix

**Escape right now:** press NumLock, or plain F6 on Apple keyboards (hid-apple maps F6 to NumLock while the overlay is active).

**Omarchy 4, per device (keeps NumLock on for a real numpad elsewhere):**


hyprctl devices | grep -A2 -i keyboard     # note the exact device name

-- ~/.config/hypr/input.lua
hl.device({ name = "apple-wireless-keyboard", numlock_by_default = false })

**Or globally**, if you never use a numpad:


-- ~/.config/hypr/input.lua
hl.config({
  input = {
    numlock_by_default = false,
  },
})

hyprctl reload && hyprctl configerrors

**Plain Arch + Hyprland:** Hyprland's default is numlock_by_default = false, so this only happens if your own config turned it on. Remove it or scope it with hl.device.

Verify

hyprctl devices shows numLock: no for the affected keyboard, cat /sys/class/leds/*numlock*/brightness reads 0 for it, and typing omki gives omki.

Sources

apple-keyboard-letters-type-digits-numlock