Case study
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.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
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.
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · gusleig/ajazz-ak820-pro-mac · Revision 2ad5c55
- docs/DISCOVERY-LOG.md GitHub · gusleig/ajazz-ak820-pro-mac · Revision 2ad5c55
- docs/protocol.md GitHub · gusleig/ajazz-ak820-pro-mac · Revision 2ad5c55
More in Protocols
- GameTrak Liberation: a client for the controller's HID protocol · Case study
- Cooper Hunter AC: UART and infrared protocol investigation · Case study
- aw5d-linux: driving an iBUYPOWER cooler LCD from USB-HID research · Case study
- MyJBxHeadsetControl: JBL Quantum 950 controls over USB HID · Case study
- zlt: MTN ZLT T10D MAX router API reconstruction · Case study
- claude-rc-api: reconstructing Claude Code Remote Control endpoints · Case study