Eder Sosa edersohe

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.

Nix on WSL Debian/Ubuntu

Prep

Install these if not already available:

sudo apt install curl xz-utils

	# Based on https://gist.github.com/kmatt/71603170556ef8ffd14984af77ff10c5
	# prompt ">" indicates Powershell commands
	# prompt "$" are Linux shell commands

	# https://docs.microsoft.com/en-us/windows/wsl/install-win10

	> dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
	> dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

	# install https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi


	;; Dual header line is possible by exploiting the tab-bar line that
	;; sits on top of the header line and is generally hidden. For the
	;; icon, it has to be precisely cut in top and bottom part and each
	;; part is concatenated with either the tab-line or header-line.

	(defun dual-header (top bottom)
	"This installs a double line header in current buffer using both tab line (TOP) and header line (BOTTOM)."

	(set-face-attribute 'tab-line (selected-frame)

	;; nano-emacs.el --- NANO Emacs (minimal version) -- lexical-binding: t --

	;; Copyright (c) 2025 Nicolas P. Rougier
	;; Released under the GNU General Public License 3.0
	;; Author: Nicolas P. Rougier <[email protected]>
	;; URL: https://github.com/rougier/nano-emacs

	;; This is NANO Emacs in 256 lines, without any dependency
	;; Usage (command line): emacs -Q -l nano.el -[light\|dark]