# 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.

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

## 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.

## Primary sources

1. <https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/README.md>
2. <https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/docs/PROTOCOL.md>
3. <https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/LICENSE>

## More in Protocols

- [dj-midi-sender: reconstructing Pro DJ Link tempo exchange](https://awesomerea.org/resources/dj-midi-sender-case/index.md) · Case study
- [Wellue O2Ring-S: reconstructing the OxyII BLE protocol](https://awesomerea.org/resources/o2ring-s-protocol-case/index.md) · Case study
- [Blackmacro-lib: reconstructing the Speed Editor USB HID exchange](https://awesomerea.org/resources/blackmacro-lib-case/index.md) · Case study
- [libfprint Goodix SPI Driver: reconstructing GDIX51C0 support](https://awesomerea.org/resources/libfprint-goodix-spi-case/index.md) · Case study
- [Insta360 GO Ultra: reconstructing its Wi-Fi camera protocol](https://awesomerea.org/resources/insta360-go-ultra-sdk-case/index.md) · Case study
- [Chuwi CoreBook X: recovering the left-speaker audio path on Linux](https://awesomerea.org/resources/chuwi-corebook-x-left-speaker-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.