{
  "added_at": "2026-11-08",
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "Better RGB 还原采用 ITE8291 键盘控制器的 Tongfang 笔记本电脑的 USB HID 灯光协议，并实现 Windows 逐键 RGB 控制客户端。作者记录了如何对照厂商软件的抓包与实际灯光变化，识别 HID 功能报告中的命令、输出报告中的颜色缓冲区及各按键的字节偏移。",
  "entry_url": "https://awesomerea.org/resources/better-rgb-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/better-rgb-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/EpicYamo/BetterRGB/blob/fd47ee8a3120165d3544c4b6a4c4ed1d1d4c04a7/README.md",
  "group": "cases",
  "id": "better-rgb-case",
  "json_url": "https://awesomerea.org/resources/better-rgb-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/better-rgb-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/better-rgb-case/index.md",
  "name": "Better RGB: reconstructing the Tongfang/ITE8291 keyboard lighting protocol",
  "name_zh": "Better RGB：还原 Tongfang/ITE8291 键盘灯光协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "license"
  ],
  "requirements": [
    "A Tongfang/ITE8291 keyboard with the documented USB HID interface and Windows.",
    "Building requires MSYS2 with mingw-w64, CMake and Ninja.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要具备文中所述 USB HID 接口的 Tongfang/ITE8291 键盘及 Windows。",
    "源码构建需要 MSYS2、mingw-w64、CMake 和 Ninja。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/EpicYamo/BetterRGB",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}