# ak820-linux: reconstructing AJAZZ AK820 Pro USB control

> ak820-linux reconstructs USB HID control for the AJAZZ AK820 Pro keyboard from the vendor's Windows configurator. Its Linux CLI and GUI send lighting effects, per-key colors, images or GIFs to the keyboard screen, and clock updates; the protocol reference records interfaces, report sizes, opcodes, and payload layouts.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/hcristosm/ak820-linux>
- Primary source: <https://github.com/hcristosm/ak820-linux/blob/36d11e774d2da4a9f2d813343d375c7488adc5be/README.md>
- Catalog page: <https://awesomerea.org/resources/ak820-linux-case/>
- Record JSON: <https://awesomerea.org/resources/ak820-linux-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/ak820-linux-case/index.md)

## Requirements & limits

- **Prerequisites:** AJAZZ AK820 Pro connected by USB cable; documented support is for USB ID 0c45:8009.
- **Prerequisites:** The AppImage requires x86_64 Linux with glibc 2.35 or newer.
- **Limits:** Key remapping, macros, and 2.4 GHz wireless mode are not implemented.
- **License:** MIT License.

## Primary sources

1. <https://github.com/hcristosm/ak820-linux/blob/36d11e774d2da4a9f2d813343d375c7488adc5be/README.md>
2. <https://github.com/hcristosm/ak820-linux/blob/36d11e774d2da4a9f2d813343d375c7488adc5be/docs/PROTOCOL.md>

## More in Protocols

- [LUMIX Remote: reconstructing Panasonic S5 camera communication](https://awesomerea.org/resources/lumix-remote-s5-case/index.md) · Case study
- [fix-whxm4-voice: reconstructing WH-1000XM4 voice-pack upload](https://awesomerea.org/resources/fix-whxm4-voice-case/index.md) · Case study
- [OrangeCar: reconstructing the wired CarPlay phone side](https://awesomerea.org/resources/orangecar-case/index.md) · Case study
- [AirDrop-for-Everything: reimplementing AirDrop file transfer](https://awesomerea.org/resources/airdrop-for-everything-case/index.md) · Case study
- [IQOS Bar: a USB HID client for IQOS ILUMA usage counters](https://awesomerea.org/resources/iqos-bar-case/index.md) · Case study
- [Chorus: reconstructing Logitech Harmony remote programming](https://awesomerea.org/resources/chorus-harmony-remote-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.