Jump to content

Keychron launcher

From ArchWiki


How to access and update a Keychron device, also it's firmware if required.

Identify the USB devices in both modes

Get the IDs for your Keychron device(s).

HID mode

When the device is plugged in, in normal mode: 

lsusb | grep Keychron
  • Keychron C100 8K
Bus 003 Device 076: ID 3434:042c Keychron Keychron C100 8K

DFU mode

Reset into DFU mode for your device:

  • Keychron C100 8K - While holding the top left key, reconnect the USB cable.
lsusb | grep DFU
  • Keychron C100 8K uses the AT32 chip
Bus 003 Device 077: ID 2e3c:df11 Artery-Tech DFU in FS Mode

UDEV Rules

To add UDEV rule for the device create /etc/udev/rules.d/99-keychron.rules and add rules for the device in both modes:

Replace `mainusergroup` with what ever group you want to 

# HID Mode
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="3434", ATTRS{idProduct}=="042c", MODE="0660", TAG+="uaccess", TAG+="udev-acl", GROUP="mainusergroup"
# DFU Mode
SUBSYSTEM=="usb", ATTRS{idVendor}=="2e3c", ATTRS{idProduct}=="df11", TAG+="uaccess", MODE="0660", TAG+="udev-acl", GROUP="mainusergroup"

Reload and trigger the new rule 

sudo udevadm control --reload-rules
sudo udevadm trigger

Keychrom Launcher

Using a webserial enabled browser like chromium, open the Keychron launcher and connect to your device.


Upgrading the firmware

The launcher uses DFU mode to upgrade the firmware.

Install dfu-util to that the launcher can program the firmware. 

sudo pacman -S dfu-util

Upgrading the firmware

Go to the Firmware Update tab and navigate to the Match Device and then reset the Keychron device.

Then select the DFU device in the device dialog. 

DFU in FS Mode - Paired

Then you can update the device.