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

Choose whether the top row sends media keys or F1-F12 on Apple-style keyboards

omarchyarchendeavouroscachyosmanjaroapplelaptopdesktopkeychron
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

Confirmed on this workstation: /etc/modprobe.d/hid_apple.conf contains options hid_apple fnmode=2 and is owned by no package, and /usr/share/omarchy/install/hardware/fix-fkeys.sh (identical to quattro) writes it only when absent, with no hardware gate. Issue #7110 quotes drivers/hid/hid-apple.c: fnmode 3 resolves to 4 for APPLE_DISABLE_FKEYS keyboards, 2 for APPLE_IS_NON_APPLE ones and 1 otherwise, so the cause held but omitted mode 4, which the forced 2 also overrides. The Arch wiki Apple_Keyboard page confirms the modes, the modprobe.d file and the modconf/initramfs step. omarchy_hooks.conf includes modconf, and install/hardware/apple/fix-t2.sh puts hid_apple into the initramfs on T2 Macs, so sudo limine-mkinitcpio is the right Omarchy rebuild. Three defects. The plain Arch symptom claimed Keychron/Lofree keyboards in Mac mode are media-first, but per the kernel code in #7110 auto already gives them F-keys first, so on plain Arch the media-first default is genuine Apple hardware. The Keychron Windows-mode claim is in no cited source and was replaced by a check of which keyboards hid_apple actually holds. The verify step relies on wev, which Omarchy 4.0.4 does not install (pacman -Q wev fails, it is in extra). Not exercised: no Apple keyboard is attached here, so /sys/module/hid_apple is absent on this machine.

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

Rebuilding the initramfs touches boot files. Run it on a system that otherwise boots and do not interrupt it.

Symptom

Omarchy: on a MacBook keyboard or Magic Keyboard, the brightness, volume and media keys on the top row send F1-F12 and only work while holding Fn. Plain Arch: the opposite, F1-F12 do nothing (they adjust brightness or volume) unless Fn is held. That is the kernel default for genuine Apple keyboards, and for Apple-alike keyboards the kernel does not recognise as non-Apple.

Cause

The top row is translated by the hid_apple kernel driver according to its fnmode parameter: 0 disabled, 1 media keys first, 2 function keys first, 3 auto (kernel default), 4 function keys disabled. Auto picks 4 for keyboards flagged APPLE_DISABLE_FKEYS, 2 for keyboards the kernel flags as non-Apple (Lofree, Keychron and similar Apple-alikes it recognises by name) and 1 for genuine Apple keyboards. Omarchy's installer step install/hardware/fix-fkeys.sh writes options hid_apple fnmode=2 to /etc/modprobe.d/hid_apple.conf on every install with no hardware check (the file is owned by no package). That changes nothing for the third-party keyboards it names but moves genuine Apple keyboards off their media row.

Fix

Check the current mode and which keyboards hid_apple is driving (the sysfs paths exist only once the module is loaded, which happens when an Apple-protocol keyboard is attached):


cat /sys/module/hid_apple/parameters/fnmode
ls /sys/bus/hid/drivers/apple/
cat /etc/modprobe.d/hid_apple.conf 2>/dev/null

If /sys/bus/hid/drivers/apple/ lists no device, your keyboard is not handled by hid_apple and fnmode cannot change it. On keyboards with a Win/Mac switch, check which position the switch is in.

Try a mode live (lost at reboot or module reload):


echo 1 | sudo tee /sys/module/hid_apple/parameters/fnmode   # media keys first
echo 2 | sudo tee /sys/module/hid_apple/parameters/fnmode   # F1-F12 first

Make it permanent:


# Omarchy, media keys back on a genuine Apple keyboard (3 = kernel auto also works):
echo 'options hid_apple fnmode=1' | sudo tee /etc/modprobe.d/hid_apple.conf
# Plain Arch, F-keys first:
echo 'options hid_apple fnmode=2' | sudo tee /etc/modprobe.d/hid_apple.conf

The modconf hook copies /etc/modprobe.d into the initramfs, and on T2 Macs Omarchy loads hid_apple from the initramfs, so rebuild it:


# Omarchy 4 (mkinitcpio -P has no presets there):
sudo limine-mkinitcpio
# Plain Arch:
sudo mkinitcpio -P

Omarchy's installer only writes the file when it is absent, so your edit survives.

Verify

After a reboot, cat /sys/module/hid_apple/parameters/fnmode shows the value you set, and the bare top-row key does what you chose. To see the keysym, install wev (not shipped by Omarchy) with sudo pacman -S --needed wev, run wev, and press the key: XF86MonBrightnessUp means media first, F2 means function keys first.

Sources

apple-keyboard-media-keys-need-fn-fnmode