Case study
cyberboard-cli: reconstructing CyberBoard R4 configuration writes
cyberboard-cli reconstructs the AngryMiao CyberBoard R4 configuration protocol used by AM Master. Its CLI reads keymaps and writes keymap and LED configuration through USB CDC serial frames, with protocol notes describing 64-byte framing and CRC-8. The author reports hardware-tested writes and keymap reads; per-key LED authoring remains unfinished.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C1 partial scope or analysis entry
- Stars
- 1
- Last commit
- 2026-10-06
- Language
- Python
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence

- Observed
- Download and demo observed; the case covers part of the target software.
- Scope
- Partial
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: Python 3.11+ and an AngryMiao CyberBoard R4; device operation uses pyserial.
- Limits: Per-key LED authoring remains in progress.
- License: MIT.
Cite
BibTeX
@misc{cyberboard-cli-case,
title = {{cyberboard-cli: reconstructing CyberBoard R4 configuration writes}},
howpublished = {\url{https://github.com/GeneralD/cyberboard-cli}},
url = {https://github.com/GeneralD/cyberboard-cli},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/cyberboard-cli-case/}}
}Plain text
cyberboard-cli: reconstructing CyberBoard R4 configuration writes. https://github.com/GeneralD/cyberboard-cli (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/cyberboard-cli-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · GeneralD/cyberboard-cli · Revision c8e3be4
- .claude/rules/30-write-protocol.md GitHub · GeneralD/cyberboard-cli · Revision c8e3be4
More in Protocols
- gm1356-recordings: reading a sound meter through its USB-HID protocol · Case study
- TwoTrees SK1: reconstructing the display UART interface · Case study
- KW330 OBD Data Access: reconstructing the scanner's USB data stream · Case study
- AstralPool Halo Cloud: reconstructing chlorinator cloud control · Case study
- zen-go-tui: reconstructing Zen Go USB HID controls · Case study
- tinyscreen: reconstructing an ArtInChip USB display protocol · Case study