Case study

Better RGB: reconstructing the Tongfang/ITE8291 keyboard lighting protocol

Better RGB reconstructs the USB HID lighting protocol of Tongfang laptops with an ITE8291 keyboard controller and implements a Windows per-key RGB client. The author describes comparing vendor-software captures with visible lighting changes to identify feature-report commands, output-report buffers and key offsets.

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: 5
Last commit: 2026-10-25
Language: C
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code, documentation and a download method observed; no demo found.
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: A Tongfang/ITE8291 keyboard with the documented USB HID interface and Windows.
Prerequisites: Building requires MSYS2 with mingw-w64, CMake and Ninja.
License: MIT license.

Cite

BibTeX

@misc{better-rgb-case,
  title = {{Better RGB: reconstructing the Tongfang/ITE8291 keyboard lighting protocol}},
  howpublished = {\url{https://github.com/EpicYamo/BetterRGB}},
  url = {https://github.com/EpicYamo/BetterRGB},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/better-rgb-case/}}
}

Plain text

Better RGB: reconstructing the Tongfang/ITE8291 keyboard lighting protocol. https://github.com/EpicYamo/BetterRGB (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/better-rgb-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

README.md GitHub · EpicYamo/BetterRGB · Revision fd47ee8