# MiPods: reconstructing Xiaomi earbuds control on macOS

> MiPods reconstructs Xiaomi earbuds control in a macOS menu-bar app using a recovered BLE GATT protocol. Its Swift core handles battery readings, device information and model-dependent noise controls, while research notes document hardware probes, vendor-app analysis and recording-transfer exchanges. A separate report describes REA-assisted analysis of Xiaomi's Mac app.

- Type: Case study
- Targets: App · Protocol
- Category: Community REA investigations
- Relationship: Author-reported mixed workflow
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/JackWPP/MiPods>
- Primary source: <https://github.com/JackWPP/MiPods/blob/eb1376e397fe557b9dcf94a260641d81b65f02d8/README.md>
- Catalog page: <https://awesomerea.org/resources/mipods-case/>
- Record JSON: <https://awesomerea.org/resources/mipods-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/mipods-case/index.md)

## Requirements & limits

- **Prerequisites:** macOS 14 or later with Bluetooth permission; building from source requires Xcode.
- **Testing evidence:** The author reports full device testing on Xiaomi M2529E1; other models remain untested.
- **Limits:** Recording export remains outside the documented app features.
- **License:** AGPL-3.0.

## Primary sources

1. <https://github.com/JackWPP/MiPods/blob/eb1376e397fe557b9dcf94a260641d81b65f02d8/README.md>
2. <https://github.com/JackWPP/MiPods/blob/eb1376e397fe557b9dcf94a260641d81b65f02d8/research/rea/findings.md>
3. <https://github.com/JackWPP/MiPods/blob/eb1376e397fe557b9dcf94a260641d81b65f02d8/research/record/capture-analysis.md>

## More in Apps

- [Taskly: rebuilding Trello's Electron desktop shell](https://awesomerea.org/resources/taskly-trello-shell-case/index.md) · Case study
- [mystery-sdl: porting the Mystery screen saver to SDL2](https://awesomerea.org/resources/mystery-sdl-case/index.md) · Case study
- [LSX II Volume Fixer: reconstructing volume behavior](https://awesomerea.org/resources/kef-lsx-volume-case/index.md) · Case study
- [UU Remote on Linux: an unofficial protocol implementation](https://awesomerea.org/resources/uu-remote-linux-protocol-case/index.md) · Case study
- [TCLimate: reconstructing selected TCL Home cloud controls](https://awesomerea.org/resources/tclimate-cloud-controls-case/index.md) · Case study
- [Browserbase plugin: re-hosting Claude in Chrome’s browser bridge](https://awesomerea.org/resources/browserbase-claude-chrome-bridge-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.