Case study

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C1 partial scope or analysis entry

Stars: 5
Last commit: 2026-10-29
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Demo screenshot from the project's public documentation

Observed: Download and demo observed; the case covers part of the target software.
Scope: Partial
Checked: 2026-11-08

How evidence classes are assigned

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.

Cite

BibTeX

@misc{ak820-linux-case,
  title = {{ak820-linux: reconstructing AJAZZ AK820 Pro USB control}},
  howpublished = {\url{https://github.com/hcristosm/ak820-linux}},
  url = {https://github.com/hcristosm/ak820-linux},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/ak820-linux-case/}}
}

Plain text

ak820-linux: reconstructing AJAZZ AK820 Pro USB control. https://github.com/hcristosm/ak820-linux (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/ak820-linux-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · hcristosm/ak820-linux · Revision 36d11e7
docs/PROTOCOL.md GitHub · hcristosm/ak820-linux · Revision 36d11e7