# MousePods: reconstructing AirPods 3 RemoteHID motion access

> MousePods reconstructs AirPods 3 RemoteHID motion access and uses it for Linux cursor control. Its protocol reference specifies AACP transport, RTBuddy framing, device announcements and reports; capture files document the receive-MTU difference that exposes motion sensors. The project also describes a SensorDataWX path for AirPods Pro 2.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/starman-tech/mousepods>
- Primary source: <https://github.com/starman-tech/mousepods/blob/115e4de10d656c663eb7b8b30d533916131f2692/docs/REMOTEHID-PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/mousepods-airpods-remotehid-case/>
- Record JSON: <https://awesomerea.org/resources/mousepods-airpods-remotehid-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/mousepods-airpods-remotehid-case/index.md)

## Requirements & limits

- **Prerequisites:** Linux with BlueZ, paired AirPods and write access to /dev/uinput; Python 3.10 or newer.
- **Limits:** Pointer mode has been tested in simulation only; several other AirPods models are untested.
- **License:** Apache-2.0 License for the code; the documented captures use CC BY 4.0.

## Primary sources

1. <https://github.com/starman-tech/mousepods/blob/115e4de10d656c663eb7b8b30d533916131f2692/docs/REMOTEHID-PROTOCOL.md>
2. <https://github.com/starman-tech/mousepods/blob/115e4de10d656c663eb7b8b30d533916131f2692/README.md>

## More in Protocols

- [FitFace Studio: reconstructing Galaxy Fit3 watch-face editing and delivery](https://awesomerea.org/resources/fitface-studio-case/index.md) · Case study
- [fretwire: reconstructing Line 6 HX USB control](https://awesomerea.org/resources/fretwire-case/index.md) · Case study
- [Kreo Hive 65: reconstructing USB HID RGB control](https://awesomerea.org/resources/kreo-hive65-rgb-case/index.md) · Case study
- [Cavium SNIC10E: reconstructing a PCIe shared-memory NIC datapath](https://awesomerea.org/resources/cavium-snic10e-datapath-case/index.md) · Case study
- [Deadband: reconstructing GameSir and Logitech device configuration](https://awesomerea.org/resources/deadband-case/index.md) · Case study
- [Pocket Libre: reconstructing Pocket recorder transfer over BLE](https://awesomerea.org/resources/pocket-libre-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.