Pod Companion
io.wingman.airpodscompanion
Pete Winn pw@primal.net A local Android 12+ AirPods companion with Apple-style battery rings, phone media controls and paired-device settings. Choose listening modes and supported Conversation Awareness, microphone, press, swipe, charging and accessibility settings. Commands show reported device state separately from requests. Optional ear pause/resume uses notification access only for media-session control and requires Android 13+ route checks. Experimental AirPods Pro 3 heart-rate sampling is opt-in, memory-only and unverified on physical hardware. Includes approximate nearby BLE battery readings in 10% steps. No account, ads, analytics or internet permission. Features depend on AirPods model, firmware and Android. Hearing fitting, head gestures, spatial rendering, Find My, smart routing and high-quality microphone capture are not implemented.
First release: Nov 13, 2026, 10 total releases.
Most recent release: Nov 16, 2026.
Appears in 1 app stack.
0 sats / 0 zaps received in the past year.
Sats Received
Underlying data available via MCP: app_zaps, app_releases.
Zap Count
Underlying data available via MCP: app_zaps, app_releases.
Releases
- Nov 16, 2026 0.3.0Adds paired AirPods controls, a widget listening-mode picker, session-scoped reported setting state, optional conservative ear pause/resume, and an experimental opt-in heart-rate reader. Adaptive and Conversation Awareness compatibility advertisement is explicit per connection. Existing battery rings and media controls are preserved. No physical advanced-control validation is claimed; deeper unsupported features are explained in the app.
- Nov 16, 2026 0.2.6Apple Batteries-style widget with circular charge rings, centred left/right earbud and case icons, percentages and charging markers. Unknown, low, approximate and stale readings remain distinct. Compact media controls and existing widget pins are preserved; direct battery connection is unchanged.
- Nov 16, 2026 0.2.5Redesigned visual battery widget with separate left earbud, right earbud and case cards, battery fill gauges, percentages and charging markers. Low and unknown readings remain distinct; approximate nearby values and stale/source timestamps stay labelled. Compact icon controls retain phone media and volume actions. Existing pinned widgets update in place; direct battery connection is unchanged.
- Nov 16, 2026 0.2.4Fixes rejection of the documented EQ notification (opcode 0x63, declared body length 5) while waiting for direct battery reports. The notification is discarded without changing EQ settings. Other lengths and unknown boundaries remain rejected. No outgoing protocol or permission changes. Physical battery delivery remains unverified.
- Nov 16, 2026 0.2.3Fixes rejection of the documented version-2 Information notification (opcode0x1D) after successful direct connection. Also handles seven audited inbound routing/session/status notifications using exact bounded frame lengths. Metadata bodies are discarded without decoding identities or scanning for battery headers. Unknown or conflicting formats remain rejected. Physical battery delivery still requires verification.
- Nov 16, 2026 0.2.2Fixes rejection of the documented Stream State Info notification (opcode 0x2B) after a successful direct connection and handshake. Consumes its bounded declared length without treating opaque contents as battery data. Retains detailed privacy-preserving diagnostics. Physical battery delivery still requires verification.
- Nov 16, 2026 0.2.1Adds precise, privacy-preserving direct-connection diagnostics: failing stage, safe error category/public Bluetooth code, handshake/subscription progress and receive counters. Handles additional documented capabilities and status notification boundaries without interpreting their payloads as battery data. Unknown boundaries remain rejected. Existing paired/BLE selections, widget, media controls and permissions retained. The cause of the reported physical failure is not yet established; this release is not a verified AirPods/GrapheneOS compatibility fix.
- Nov 16, 2026 0.2.0Adds an experimental direct connection to your selected paired AirPods for whole-percent battery reports without waiting for nearby BLE discovery. Includes explicit Connect/Disconnect/Forget, source-aware app and widget readings, dated observations, bounded background connection attempts, and a privacy-preserving Copy connection report. Existing BLE selection, widget and media controls retained. Independently implemented from public protocol facts; emulator and simulated protocol tests do not establish physical AirPods/GrapheneOS compatibility.
- Nov 13, 2026 0.1.1Discovery repair: a live chooser refreshes as signals arrive; a bounded 20-second active scan returns to background monitoring. Copy a privacy-preserving scan report with aggregate results and public protocol format summaries. Better monitoring/error messages and safe screen insets. Existing permissions retained. Fixes confirmed discovery/UI defects; physical AirPods Pro 3 reception on GrapheneOS remains unverified.
- Nov 13, 2026 0.1.0First preview with battery widget, nearby broadcast selection, media and volume controls. Android 12+. Physical AirPods compatibility remains unverified.