{
  "added_at": "2026-11-06",
  "additional_evidence_urls": [
    "https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/docs/DISCOVERY-LOG.md",
    "https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/docs/protocol.md"
  ],
  "category": "reconstruction-cases",
  "description_en": "ak820 implements macOS control of the AJAZZ AK820 Pro keyboard through its vendor HID feature-report protocol. The Python CLI sets the clock, RGB lighting, and sleep timer over USB; accompanying notes describe Windows-driver analysis, packet framing, transaction handshakes, and the unresolved key-remapping commands.",
  "description_zh": "ak820 通过 AJAZZ AK820 Pro 的厂商 HID feature report 协议在 macOS 上控制键盘。Python 命令行工具经 USB 设置时钟、RGB 灯光和休眠时间；附带文档记录 Windows 驱动分析、数据包封装、事务握手及尚未解决的按键重映射命令。",
  "entry_url": "https://awesomerea.org/resources/ajazz-ak820-pro-mac-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/ajazz-ak820-pro-mac-case/",
  "evidence_url": "https://github.com/gusleig/ajazz-ak820-pro-mac/blob/2ad5c553140b50b62e1b93096dc089086976351e/README.md",
  "group": "cases",
  "id": "ajazz-ak820-pro-mac-case",
  "json_url": "https://awesomerea.org/resources/ajazz-ak820-pro-mac-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/ajazz-ak820-pro-mac-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/ajazz-ak820-pro-mac-case/index.md",
  "name": "ak820: reconstructing AJAZZ AK820 Pro HID control on macOS",
  "name_zh": "ak820：在 macOS 上重建 AJAZZ AK820 Pro 的 HID 控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "macOS, Python 3.11+, and an AJAZZ AK820 Pro connected with a USB-C data cable are required.",
    "The Python package depends on hidapi.",
    "LCD image upload on macOS and key remapping are unsupported.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 macOS、Python 3.11+，以及通过 USB-C 数据线连接的 AJAZZ AK820 Pro。",
    "Python 包依赖 hidapi。",
    "macOS 上不支持上传 LCD 图片，按键重映射尚未实现。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/gusleig/ajazz-ak820-pro-mac",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}