{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/Wangpinglan/mchose-linux/blob/5f5ad5fad8f74d001578ce5d9caf304d9622a266/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "mchose-linux reconstructs MCHOSE A5 and AX5 Pro mouse settings on Linux from a decompiled Windows driver. It documents 65-byte HID Feature Reports, command groups and field offsets, then provides DPI and polling-rate controls, battery status and other settings through a CLI, GNOME extension and GTK app.",
  "description_zh": "mchose-linux 依据反编译的 Windows 驱动，在 Linux 上重建 MCHOSE A5 与 AX5 Pro 鼠标设置功能。项目记录了 65 字节 HID Feature Report、命令组和字段偏移，并通过 CLI、GNOME 扩展及 GTK 应用提供 DPI、回报率等设置和电量查询。",
  "entry_url": "https://awesomerea.org/resources/mchose-linux-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/mchose-linux-case/",
  "evidence_class": 1,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/Wangpinglan/mchose-linux/blob/5f5ad5fad8f74d001578ce5d9caf304d9622a266/PROTOCOL.md",
  "group": "cases",
  "id": "mchose-linux-case",
  "json_url": "https://awesomerea.org/resources/mchose-linux-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/mchose-linux-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/mchose-linux-case/index.md",
  "name": "mchose-linux: reconstructing MCHOSE mouse controls on Linux",
  "name_zh": "mchose-linux：在 Linux 上重建 MCHOSE 鼠标控制",
  "preview_kind": "image",
  "preview_url": "https://awesomerea.org/previews/mchose-linux-case.png",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Linux and a supported MCHOSE A5 or AX5 Pro series mouse are required.",
    "The GTK app requires GTK4, libadwaita and python3-gobject.",
    "The source states that lighting, button remapping and macros are not wrapped in the CLI, and firmware upgrades are excluded.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Linux 和受支持的 MCHOSE A5 或 AX5 Pro 系列鼠标。",
    "GTK 应用需要 GTK4、libadwaita 和 python3-gobject。",
    "资料说明 CLI 尚未封装灯效、按键重映射和宏，固件升级不在范围内。",
    "采用 MIT 许可证。"
  ],
  "scope": "partial",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/Wangpinglan/mchose-linux",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}