zornher-linux

xremap configs to fix the F-row on Zornher mechanical keyboards. Provides a software Fn-lock via ScrollLock to toggle between F-keys and media actions.

Why

• Fixed F-row: F-row always sends fixed media HID codes (e.g. F1 key -> KEY_BRIGHTNESSDOWN); no mechanism to send function keys
• No Hardware Fn-lock: Fn key is firmware-internal and never reaches the OS

Models

Model	Config
ZH870	configs/zh870.yml

Warning

Even within the same model, firmware revisions may emit different scancodes. If keys behave differently, verify yours with evtest and adjust the modmap block.

PRs for other models welcome - see CONTRIBUTING.md.

Install (via Cargo)

cargo install xremap
sudo install -Dm755 ~/.cargo/bin/xremap /usr/local/bin/xremap
sudo install -Dm644 configs/<keyboard-model>.yml /etc/xremap/config.yml
sudo install -Dm644 systemd/xremap.service /etc/systemd/system/xremap.service
sudo systemctl enable --now xremap

ScrollLock toggles Fn-lock: press once for real F1-F12; again for media (does not have to be ScrollLock; can be other keys).

Customise

Edit the keymap block. See media-keys-ref.md for KEY_* codes.

Tested

• ZH870
• Fedora release 42 (Adams)
• Framework Laptop 13
• Hyprland 0.51.1
• xremap 0.14.1

License

MIT.