{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/hcristosm/ak820-linux/blob/36d11e774d2da4a9f2d813343d375c7488adc5be/docs/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "ak820-linux reconstructs USB HID control for the AJAZZ AK820 Pro keyboard from the vendor's Windows configurator. Its Linux CLI and GUI send lighting effects, per-key colors, images or GIFs to the keyboard screen, and clock updates; the protocol reference records interfaces, report sizes, opcodes, and payload layouts.",
  "description_zh": "ak820-linux 从厂商 Windows 配置程序恢复 AJAZZ AK820 Pro 键盘的 USB HID 控制方式。Linux 命令行和图形界面可设置灯效、逐键颜色、屏幕图片或 GIF 及时间；协议文档记录接口、报告长度、操作码和载荷布局。",
  "entry_url": "https://awesomerea.org/resources/ak820-linux-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/ak820-linux-case/",
  "evidence_class": 1,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/hcristosm/ak820-linux/blob/36d11e774d2da4a9f2d813343d375c7488adc5be/README.md",
  "group": "cases",
  "id": "ak820-linux-case",
  "json_url": "https://awesomerea.org/resources/ak820-linux-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/ak820-linux-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/ak820-linux-case/index.md",
  "name": "ak820-linux: reconstructing AJAZZ AK820 Pro USB control",
  "name_zh": "ak820-linux：重构 AJAZZ AK820 Pro USB 控制协议",
  "preview_kind": "image",
  "preview_url": "https://awesomerea.org/previews/ak820-linux-case.png",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "AJAZZ AK820 Pro connected by USB cable; documented support is for USB ID 0c45:8009.",
    "The AppImage requires x86_64 Linux with glibc 2.35 or newer.",
    "Key remapping, macros, and 2.4 GHz wireless mode are not implemented.",
    "MIT License."
  ],
  "requirements_zh": [
    "需要通过 USB 线连接 AJAZZ AK820 Pro；文档支持的 USB ID 为 0c45:8009。",
    "AppImage 需要 x86_64 Linux 和 glibc 2.35 或更新版本。",
    "按键重映射、宏及 2.4 GHz 无线模式尚未实现。",
    "MIT 许可证。"
  ],
  "scope": "partial",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/hcristosm/ak820-linux",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}