# pro2-linux: reconstructing Logitech PRO 2 LIGHTSPEED control on Linux

> pro2-linux reconstructs configuration of the Logitech G PRO 2 LIGHTSPEED mouse on Linux from its HID++ 2.0 exchanges and onboard profile format 0x07. Its Python tools and libratbag patch handle DPI, report rate, RGB and button settings, while protocol notes record feature IDs and report layouts.

- 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/opigod/pro2-linux>
- Primary source: <https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/docs/protocol.md>
- Catalog page: <https://awesomerea.org/resources/pro2-linux-case/>
- Record JSON: <https://awesomerea.org/resources/pro2-linux-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/pro2-linux-case/index.md)

## Requirements & limits

- **Prerequisites:** Linux and a Logitech G PRO 2 LIGHTSPEED; Python 3.10+, Meson, Ninja, a C compiler, GTK 3/PyGObject and libratbag build dependencies.
- **Limits:** Back up onboard profiles before writing; profile writes persist on the mouse.
- **Testing evidence:** The author reports wired USB testing on one unit; receiver support needs testing on more units.
- **License:** MIT licence.

## Primary sources

1. <https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/docs/protocol.md>
2. <https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/README.md>
3. <https://github.com/opigod/pro2-linux/blob/9855f1a9f3ee78f957cf669f15e12fa088301ad9/docs/status.md>

## More in Protocols

- [beam-revival: local Beam+ control from motor protocol research](https://awesomerea.org/resources/beam-revival-case/index.md) · Case study
- [NXOSC Reborn: reconstructing Waves Nx Head Tracker BLE output](https://awesomerea.org/resources/nxosc-reborn-case/index.md) · Case study
- [BLE LED Matrix Controller: reconstructing GIF upload for a 96×20 display](https://awesomerea.org/resources/ble-led-matrix-controller-case/index.md) · Case study
- [LSC Smart Connect / Battletron: reconstructing LAN lighting control](https://awesomerea.org/resources/lsc-battletron-bridge-case/index.md) · Case study
- [Razer Key Light Chroma: a SignalRGB client for its lighting protocol](https://awesomerea.org/resources/razer-key-light-chroma-protocol-case/index.md) · Case study
- [lochinvar-native-modbus: mapping Knight boiler telemetry](https://awesomerea.org/resources/lochinvar-native-modbus-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.