Case study

mchose-linux: reconstructing MCHOSE mouse controls on Linux

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C1 partial scope or analysis entry

Stars: 0
Last commit: 2026-10-28
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Demo screenshot from the project's public documentation

Observed: Download and demo observed; the case covers part of the target software.
Scope: Partial
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: Linux and a supported MCHOSE A5 or AX5 Pro series mouse are required.
Prerequisites: The GTK app requires GTK4, libadwaita and python3-gobject.
Limits: The source states that lighting, button remapping and macros are not wrapped in the CLI, and firmware upgrades are excluded.
License: MIT license.

Cite

BibTeX

@misc{mchose-linux-case,
  title = {{mchose-linux: reconstructing MCHOSE mouse controls on Linux}},
  howpublished = {\url{https://github.com/Wangpinglan/mchose-linux}},
  url = {https://github.com/Wangpinglan/mchose-linux},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/mchose-linux-case/}}
}

Plain text

mchose-linux: reconstructing MCHOSE mouse controls on Linux. https://github.com/Wangpinglan/mchose-linux (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/mchose-linux-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

PROTOCOL.md GitHub · Wangpinglan/mchose-linux · Revision 5f5ad5f
README.md GitHub · Wangpinglan/mchose-linux · Revision 5f5ad5f