Skip to content

Instantly share code, notes, and snippets.

View kesyog's full-sized avatar
🧗‍♂️

Kesavan Yogeswaran kesyog

🧗‍♂️
View GitHub Profile
@andrebrait
andrebrait / keychron_linux.md
Last active March 13, 2025 12:33
Keychron keyboards on Linux + Bluetooth fixes

Here is the best setup (I think so :D) for K-series Keychron keyboards on Linux.

Note: many newer Keychron keyboards use QMK as firmware and most tips here do not apply to them. Maybe the ones related to Bluetooth can be useful, but everything related to Apple's keyboard module (hid_apple) on Linux, won't work. As far as I know, all QMK-based boards use the hid_generic module instead. Examples of QMK-based boards are: Q, Q-Pro, V, K-Pro, etc.

Most of these commands have been tested on Ubuntu 20.04 and should also work on most Debian-based distributions. If a command happens not to work for you, take a look in the comment section.

Make Fn + F-keys work (NOT FOR QMK-BASED BOARDS)

Older Keychron keyboards (those not based on QMK) use the hid_apple driver on Linux, even in the Windows/Android mode, both in Bluetooth and Wired modes.

multi-pitch climbing transitions
general notes
-------------
always reply to commands
this let's the other climber know you heard him
e.g. climber calls "on belay" but belayer isn't ready yet, can't call "belay is on"
instead of waiting silently and climber calling out "on belay" again and again
say "thanks" as acknowledgment