# 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/Wangpinglan/mchose-linux>
- Primary source: <https://github.com/Wangpinglan/mchose-linux/blob/5f5ad5fad8f74d001578ce5d9caf304d9622a266/PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/mchose-linux-case/>
- Record JSON: <https://awesomerea.org/resources/mchose-linux-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/mchose-linux-case/index.md)

## 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.

## Primary sources

1. <https://github.com/Wangpinglan/mchose-linux/blob/5f5ad5fad8f74d001578ce5d9caf304d9622a266/PROTOCOL.md>
2. <https://github.com/Wangpinglan/mchose-linux/blob/5f5ad5fad8f74d001578ce5d9caf304d9622a266/README.md>

## More in Protocols

- [epson-scan-to-mac: reconstructing Epson panel scanning on Macs](https://awesomerea.org/resources/epson-scan-to-mac-case/index.md) · Case study
- [OpenMouse: reconstructing Kysona M600 V2 mouse control](https://awesomerea.org/resources/openmouse-kysona-m600-case/index.md) · Case study
- [WDA Konfigurator: a reconstructed Microsoft Wireless Display Adapter configuration client](https://awesomerea.org/resources/wda-konfigurator-case/index.md) · Case study
- [irca-ble-protocol: reconstructing heater control over Bluetooth LE](https://awesomerea.org/resources/irca-ble-protocol-case/index.md) · Case study
- [egm6-nixie-clock: reconstructing a nixie clock's Wi-Fi protocol](https://awesomerea.org/resources/egm6-nixie-clock-case/index.md) · Case study
- [Guoran nixie clock: reconstructing its Bluetooth control protocol](https://awesomerea.org/resources/guoran-nixie-clock-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.