# castty: reconstructing Mionix Castor control on Linux

> castty reconstructs configuration of the Mionix Castor mouse on Linux from captured HID feature reports. Its protocol notes describe command report 0x60, profile report 0x61, readback, and field offsets; the Rust GUI and CLI use those findings for lighting, DPI, buttons, macros, and profiles.

- 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/fawaz7/castty>
- Primary source: <https://github.com/fawaz7/castty/blob/ac124364ab8deb0293a630cf1c4befc93aa20bad/research/PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/castty-mionix-castor-case/>
- Record JSON: <https://awesomerea.org/resources/castty-mionix-castor-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/castty-mionix-castor-case/index.md)

## Requirements & limits

- **Prerequisites:** A Mionix Castor with USB ID 22d4:1316 and Linux hidraw are required.
- **Limits:** The Castor PRO is a different device and is unsupported.
- **License:** GPL-3.0.

## Primary sources

1. <https://github.com/fawaz7/castty/blob/ac124364ab8deb0293a630cf1c4befc93aa20bad/research/PROTOCOL.md>
2. <https://github.com/fawaz7/castty/blob/ac124364ab8deb0293a630cf1c4befc93aa20bad/README.md>

## More in Protocols

- [legion-gpu-rgb: reconstructing Lenovo GPU lighting control](https://awesomerea.org/resources/legion-gpu-rgb-case/index.md) · Case study
- [SoundcoreBridge: reconstructing Soundcore Space 2 headphone controls](https://awesomerea.org/resources/soundcorebridge-case/index.md) · Case study
- [NiimBridge: reconstructing the NIIMBOT D110_M print protocol](https://awesomerea.org/resources/niimbridge-d110m-case/index.md) · Case study
- [OMS fingerprint module: reconstructing USB communication for a Linux driver](https://awesomerea.org/resources/oms-fingerprint-linux-case/index.md) · Case study
- [zwift-api: mapping Zwift's private data endpoints](https://awesomerea.org/resources/zwift-api-case/index.md) · Case study
- [Gear VR Controller: decoding Samsung's BLE remote protocol](https://awesomerea.org/resources/gear-vr-controller-ble-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.