Case study

AK820 Pro Modder: reconstructing keyboard HID control on macOS

AK820 Pro Modder implements macOS control of the Epomaker and Ajazz AK820 Pro keyboard through a Rust HID protocol library shared by a Tauri app and CLI. Its protocol notes distinguish two firmware families and document commands for lighting, keymaps, macros, the TFT display, and device settings.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-08
Evidence class: C2 code & docs, no demo or download

Stars: 6
Last commit: 2026-10-24
Language: Rust
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: macOS 11 or later and an AK820 Pro keyboard; building requires Rust 1.90 or later, Node.js 22, and pnpm 10.
Testing evidence: The author reports testing most features on one ISO-DE keyboard with firmware 1.07; family-B support has not been tested on this build.
Limits: Family-B onboard key remapping and macros remain undecoded; JIS layout is unsupported.
License: MIT License.

Cite

BibTeX

@misc{ak820-pro-modder-case,
  title = {{AK820 Pro Modder: reconstructing keyboard HID control on macOS}},
  howpublished = {\url{https://github.com/wsclx/ak820pro-modder}},
  url = {https://github.com/wsclx/ak820pro-modder},
  urldate = {2026-11-08},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/ak820-pro-modder-case/}}
}

Plain text

AK820 Pro Modder: reconstructing keyboard HID control on macOS. https://github.com/wsclx/ak820pro-modder (accessed 2026-11-08). Awesome REA entry: https://awesomerea.org/resources/ak820-pro-modder-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 · wsclx/ak820pro-modder · Revision 55a2ca2
docs/PROTOCOL.md GitHub · wsclx/ak820pro-modder · Revision 55a2ca2
LICENSE GitHub · wsclx/ak820pro-modder · Revision 55a2ca2