# gloriousctl: mapping Pixart Model I 2 mouse settings

> gloriousctl adds Linux control of Pixart Model I 2 mice through a hardware-mapped, write-only HID report format. The author documents corrected DPI, stage color, polling-rate, and fragment timing fields, alongside a CLI and GTK front end.

- 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/zeppybabe/gloriousctl-linux>
- Primary source: <https://github.com/zeppybabe/gloriousctl-linux/blob/cbf041afd30fd8d6709da13d15f8e56926429b99/README.md>
- Catalog page: <https://awesomerea.org/resources/gloriousctl-linux-pixart-case/>
- Record JSON: <https://awesomerea.org/resources/gloriousctl-linux-pixart-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/gloriousctl-linux-pixart-case/index.md)

## Requirements & limits

- **Prerequisites:** Linux, hidapi, a C compiler, and make; the GUI also needs PyGObject and GTK 3.
- **Limits:** Pixart settings are write-only, so displayed values come from a local cache.
- **Attribution:** EUPL-1.2 license; the SinoWealth code and original CLI derive from enkore/gloriousctl.

## Primary sources

1. <https://github.com/zeppybabe/gloriousctl-linux/blob/cbf041afd30fd8d6709da13d15f8e56926429b99/README.md>

## More in Protocols

- [divoom-protocol: reconstructed BLE control for Divoom displays](https://awesomerea.org/resources/divoom-protocol-case/index.md) · Case study
- [hestia: replacing the Keemple smart-home cloud](https://awesomerea.org/resources/hestia-keemple-case/index.md) · Case study
- [gigabyte-gpu-lcd: reconstructing AORUS GPU LCD control](https://awesomerea.org/resources/gigabyte-gpu-lcd-case/index.md) · Case study
- [Ricoh SP 200 Linux CUPS Driver: reconstructing the printer's USB print protocol](https://awesomerea.org/resources/ricoh-sp200-linux-case/index.md) · Case study
- [HyperX QuadCast 2 S: reconstructing RGB control on macOS](https://awesomerea.org/resources/hyperx-quadcast-2s-rgb-case/index.md) · Case study
- [whoop4-ble: reconstructing Whoop 4.0 sensor data access](https://awesomerea.org/resources/whoop4-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.