Case study

cherry-mx-lighting-mac: reconstructing Cherry MX 10.0N RGB lighting control

cherry-mx-lighting-mac reconstructs lighting control for the Cherry MX 10.0N RGB keyboard in a macOS menu bar app. The author observed Cherry Utility's USB HID traffic and documented a five-report sequence, including bytes for effect, brightness, speed and RGB colour; the app also remaps keys through hidutil.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 0
Last commit: 2026-11-03
Language: Swift
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-09

How evidence classes are assigned

Requirements & limits

Prerequisites: Cherry MX 10.0N RGB keyboard and macOS; the author tested USB device 046A:00E2 on macOS 27 with Apple Silicon.
Prerequisites: Xcode Command Line Tools are required to build; Input Monitoring permission is required to write to the keyboard.
Limits: Effect direction, per-key colours and Custom mode are unfinished; other Cherry models are untested.
License: MIT license.

Cite

BibTeX

@misc{cherry-mx-lighting-mac-case,
  title = {{cherry-mx-lighting-mac: reconstructing Cherry MX 10.0N RGB lighting control}},
  howpublished = {\url{https://github.com/AlexBongers/cherry-mx-lighting-mac}},
  url = {https://github.com/AlexBongers/cherry-mx-lighting-mac},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/cherry-mx-lighting-mac-case/}}
}

Plain text

cherry-mx-lighting-mac: reconstructing Cherry MX 10.0N RGB lighting control. https://github.com/AlexBongers/cherry-mx-lighting-mac (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/cherry-mx-lighting-mac-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

PROTOCOL.md GitHub · AlexBongers/cherry-mx-lighting-mac · Revision cb0d543
README.md GitHub · AlexBongers/cherry-mx-lighting-mac · Revision cb0d543