{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/docs/PROTOCOL.md",
    "https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "AK820 Pro Modder implements macOS control of the Epomaker and Ajazz AK820 Pro keyboard through a Rust HID protocol library shared by a Tauri app and CLI. Its protocol notes distinguish two firmware families and document commands for lighting, keymaps, macros, the TFT display, and device settings.",
  "description_zh": "AK820 Pro Modder 通过 Rust HID 协议库在 macOS 上控制 Epomaker/Ajazz AK820 Pro 键盘，Tauri 应用与 CLI 共用该库。协议文档区分两类固件接口，并记录灯效、键位映射、宏、TFT 显示屏和设备设置命令。",
  "entry_url": "https://awesomerea.org/resources/ak820-pro-modder-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/ak820-pro-modder-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/wsclx/ak820pro-modder/blob/55a2ca250e7f7918e09eee506d54ef0d84fc66ff/README.md",
  "group": "cases",
  "id": "ak820-pro-modder-case",
  "json_url": "https://awesomerea.org/resources/ak820-pro-modder-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/ak820-pro-modder-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/ak820-pro-modder-case/index.md",
  "name": "AK820 Pro Modder: reconstructing keyboard HID control on macOS",
  "name_zh": "AK820 Pro Modder：在 macOS 上重建键盘 HID 控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "limits",
    "license"
  ],
  "requirements": [
    "macOS 11 or later and an AK820 Pro keyboard; building requires Rust 1.90 or later, Node.js 22, and pnpm 10.",
    "The author reports testing most features on one ISO-DE keyboard with firmware 1.07; family-B support has not been tested on this build.",
    "Family-B onboard key remapping and macros remain undecoded; JIS layout is unsupported.",
    "MIT License."
  ],
  "requirements_zh": [
    "需要 macOS 11 或更高版本及 AK820 Pro 键盘；构建需要 Rust 1.90 或更高版本、Node.js 22 和 pnpm 10。",
    "作者报告大部分功能在一把固件 1.07 的 ISO-DE 键盘上测试；此构建尚未测试 B 类固件支持。",
    "B 类固件的板载键位映射和宏尚未解析；不支持 JIS 布局。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/wsclx/ak820pro-modder",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}