# ak820: reconstructing AJAZZ AK820 Pro HID control on macOS

> ak820 implements macOS control of the AJAZZ AK820 Pro keyboard through its vendor HID feature-report protocol. The Python CLI sets the clock, RGB lighting, and sleep timer over USB; accompanying notes describe Windows-driver analysis, packet framing, transaction handshakes, and the unresolved key-remapping commands.

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

## Requirements & limits

- **Prerequisites:** macOS, Python 3.11+, and an AJAZZ AK820 Pro connected with a USB-C data cable are required.
- **Prerequisites:** The Python package depends on hidapi.
- **Limits:** LCD image upload on macOS and key remapping are unsupported.
- **License:** MIT license.

## Primary sources

1. <https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/README.md>
2. <https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/docs/DISCOVERY-LOG.md>
3. <https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/docs/protocol.md>

## More in Protocols

- [GameTrak Liberation: a client for the controller's HID protocol](https://awesomerea.org/resources/gametrak-liberation-case/index.md) · Case study
- [Cooper Hunter AC: UART and infrared protocol investigation](https://awesomerea.org/resources/cooper-hunter-ac-protocol-case/index.md) · Case study
- [aw5d-linux: driving an iBUYPOWER cooler LCD from USB-HID research](https://awesomerea.org/resources/aw5d-linux-case/index.md) · Case study
- [MyJBxHeadsetControl: JBL Quantum 950 controls over USB HID](https://awesomerea.org/resources/myjbxheadsetcontrol-case/index.md) · Case study
- [zlt: MTN ZLT T10D MAX router API reconstruction](https://awesomerea.org/resources/zltrouter-case/index.md) · Case study
- [claude-rc-api: reconstructing Claude Code Remote Control endpoints](https://awesomerea.org/resources/claude-rc-api-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.