Case study
GreenPods: reconstructing AirPods control on Android
GreenPods is an Android app that reads AirPods BLE advertisements and offers Apple Accessory Protocol controls over L2CAP where available. Its protocol research records packet structures, transport requirements and captured device behavior for battery status, noise control, gestures and head tracking. The app exposes features according to the available Android Bluetooth path.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 4
- Last commit
- 2026-08-10
- Language
- Kotlin
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a download method observed; no demo found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: Android 8.0 or later and Bluetooth LE are required; building needs JDK 21 and the Android SDK.
- Prerequisites: AAP controls depend on a recent Android system that permits the required authenticated L2CAP channel.
- Limits: AirPods Pro 3 heart-rate decoding is documented but not yet shipped as an app feature.
- License: MIT license.
Cite
BibTeX
@misc{greenpods-airpods-protocol-case,
title = {{GreenPods: reconstructing AirPods control on Android}},
howpublished = {\url{https://github.com/andrewkomkov/GreenPods}},
url = {https://github.com/andrewkomkov/GreenPods},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/greenpods-airpods-protocol-case/}}
}Plain text
GreenPods: reconstructing AirPods control on Android. https://github.com/andrewkomkov/GreenPods (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/greenpods-airpods-protocol-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- docs/protocol-research.md GitHub · andrewkomkov/GreenPods · Revision cd171e5
- README.md GitHub · andrewkomkov/GreenPods · Revision cd171e5
More in Protocols
- dualsense-bridge: reconstructing DualSense Bluetooth microphone access · Case study
- FX30 Controller: reconstructing Sony FX30 remote control · Case study
- P215 Scan: reconstructing the Canon P-215II file-tunnel transport · Case study
- Sirius Dev Kit: Hengbot Sirius API and action-format findings · Case study
- Narwal Robot Vacuum: local WebSocket control and protocol probing · Case study
- landbook-api: reconstructing Landbook cloud and local device access · Case study