# fiilpod: FIIL earbud protocols integrated into HyperOS

> fiilpod reconstructs FIIL earbud control protocols and integrates their battery, noise-control, EQ, and spatial-audio state into Xiaomi HyperOS. Its LSPosed module injects into Bluetooth and settings processes, communicates over SPP or BLE GATT, and documents GAIA, Mate, Airoha, and other command families.

- Type: Case study
- Targets: App · 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/FNKG9527/FiilPods>
- Primary source: <https://github.com/FNKG9527/FiilPods/blob/428692955dcd42b20f1cb8cce0372e525ea449f3/docs/PROTOCOL_FIIL.md>
- Catalog page: <https://awesomerea.org/resources/fiilpod-case/>
- Record JSON: <https://awesomerea.org/resources/fiilpod-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/fiilpod-case/index.md)

## Requirements & limits

- **Prerequisites:** A Xiaomi or Redmi arm64 device with HyperOS 2, 3, or 4 on Android 15 or newer, LSPosed with libxposed API 102, and Bluetooth permissions.
- **Limits:** The module requires the documented LSPosed process scopes and does not support Android 14 or older.
- **License:** GPL-3.0 license.

## Primary sources

1. <https://github.com/FNKG9527/FiilPods/blob/428692955dcd42b20f1cb8cce0372e525ea449f3/docs/PROTOCOL_FIIL.md>
2. <https://github.com/FNKG9527/FiilPods/blob/428692955dcd42b20f1cb8cce0372e525ea449f3/README.md>

## More in Apps

- [upright: reconstructing Lightroom Classic's perspective correction](https://awesomerea.org/resources/lightroom-upright-case/index.md) · Case study
- [studio3svg: reconstructing the Silhouette Studio document format](https://awesomerea.org/resources/studio3svg-case/index.md) · Case study
- [technics-az100: a Windows client for EAH-AZ100 earbud controls](https://awesomerea.org/resources/technics-az100-case/index.md) · Case study
- [SberBoom Remote: reconstructing local speaker control and StarOS messages](https://awesomerea.org/resources/sberboom-remote-case/index.md) · Case study
- [Curiosity Daily API: endpoints recovered from the Android app](https://awesomerea.org/resources/curiosity-daily-api-case/index.md) · Case study
- [prism_connect: PRISM Live Studio remote protocol implementation](https://awesomerea.org/resources/prism-connect-prism-live-studio-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.