Case study
YenKeyControl: decoding the Yenkee YKB3700 Rogue keyboard protocol
YenKeyControl reconstructs the Yenkee YKB3700 Rogue keyboard's USB HID configuration protocol and implements Python commands for RGB effects, per-key colors and key remapping. Its protocol notes specify packet layouts, command values, checksums and sequencing derived from captured USB traffic and parameter tests.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 7
- Last commit
- 2025-12-23
- Language
- Python
- License (GitHub)
- GPL-3.0
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a demo observed; no download method found.
- Checked
- 2026-11-09
Requirements & limits
- Prerequisites: Yenkee YKB3700 Rogue keyboard, USB VID 3151 and PID 4002, for the documented device.
- Limits: The README lists other keyboards as possible matches and marks the YKB3700 Rogue as tested.
- License: GPL-3.0 license.
Cite
BibTeX
@misc{yenkeycontrol-case,
title = {{YenKeyControl: decoding the Yenkee YKB3700 Rogue keyboard protocol}},
howpublished = {\url{https://github.com/p3t3r50n-cz/YenKeyControl}},
url = {https://github.com/p3t3r50n-cz/YenKeyControl},
urldate = {2026-11-07},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/yenkeycontrol-case/}}
}Plain text
YenKeyControl: decoding the Yenkee YKB3700 Rogue keyboard protocol. https://github.com/p3t3r50n-cz/YenKeyControl (accessed 2026-11-07). Awesome REA entry: https://awesomerea.org/resources/yenkeycontrol-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- docs/communication-protocol.md GitHub · p3t3r50n-cz/YenKeyControl · Revision 3a6e5df
- README.md GitHub · p3t3r50n-cz/YenKeyControl · Revision 3a6e5df
- docs/README.md GitHub · p3t3r50n-cz/YenKeyControl · Revision 3a6e5df
More in Protocols
- Deye Battery Serial Bus: decoding battery CAN frames · Case study
- Bonaparte: reconstructing the Napoleon eFIRE Bluetooth control protocol · Case study
- skyrcUSB: reading skyRC chargers through a reconstructed protocol · Case study
- mqtt-energi: reconstructing myenergi device traffic · Case study
- RedFIS: reconstructing the Audi A3 8P display protocol · Case study
- GalaxyBuds-rs: implementing the Galaxy Buds Bluetooth protocol · Case study