Update FAQ, Home, and AirPod-Keys for CAPod 5.0+ AAP support

Android's upstream Bluetooth stack fix (CAPod issue #215 / Android issuetracker 371713238) has landed on Pixel devices on Android 16/17 builds as of April 2026. CAPod 5.0+ ships an AAP client that can change device settings (ANC, stem actions, noise control, etc.) and auto-retrieve IRK/encryption keys. This updates the wiki to reflect the new reality:

- FAQ.md: rewrite intro + ANC/EQ entry as canonical capability reference. Add model/firmware gating caveat, OEM rollout disclaimer, and AAP connection triage steps. Update auto-pause and battery entries to describe AAP as a supplement/fallback rather than treating it as impossible.

- Home.md: add a device settings bullet linking to the canonical FAQ entry; mention auto key retrieval in the accuracy section.

- AirPod-Keys.md: add a callout that CAPod 5.0+ usually retrieves keys automatically via AAP; manual extraction remains the fallback.

AirPod-Keys.md

@@ -1,8 +1,8 @@
 # AirPod Keys
 
-Currently, Android doesn't support direct connections to AirPods, which is a [technical limitation](https://github.com/d4rken-org/capod/issues/215). Google might address this issue in future Android versions.
+> **Note (CAPod 5.0+):** On phones with the updated Android Bluetooth stack — confirmed on Pixel devices on Android 16 / 17 builds as of April 2026, with other OEMs (Samsung, Xiaomi, OnePlus, etc.) rolling out the fix at their own pace — CAPod usually retrieves the identity and encryption keys automatically via an AAP connection, so no PC extraction is needed. Manual extraction (this guide) is still useful when: (1) your phone can't establish an AAP connection yet, or (2) auto-retrieval doesn't complete for your specific device profile.
 
-However, AirPods regularly broadcast a status message using Bluetooth Low Energy (BLE), and this message contains valuable information.
+AirPods regularly broadcast a status message using Bluetooth Low Energy (BLE), and this message contains valuable information.
 
 Each broadcast includes the **public address** of the AirPods, but to maintain privacy, AirPods frequently rotate this address to prevent tracking. The broadcast message consists of two parts: a **public** and an **encrypted** section.
 

FAQ.md

@@ -4,7 +4,7 @@
 
 CAPod shows you the battery level of your AirPods (left, right, and case) on your Android phone. It can also show a popup when you open the case, display a home screen widget, and optionally pause/play audio when you take an AirPod out of your ear.
 
-That's roughly it. Apple locks down most of their AirPods functionality to iPhones, so no Android app — CAPod included — can do things like control ANC, adjust EQ, change tap gestures, or update firmware. CAPod squeezes out everything that's technically possible.
+On phones with the updated Android Bluetooth stack — confirmed on Pixel devices on Android 16 / 17 builds as of April 2026, with other OEMs (Samsung, Xiaomi, OnePlus, etc.) rolling out the fix at their own pace — CAPod 5.0+ can also change AirPods settings such as ANC modes, stem actions, noise control, and more. The exact list of available controls depends on your specific AirPods model and firmware. EQ presets and firmware updates remain Apple-only and are not reachable from any Android app. See [Can CAPod control ANC, EQ, or tap gestures?](#can-capod-control-anc-eq-or-tap-gestures) below for details.
 
 ### Which AirPods and Beats are supported?
 
@@ -18,11 +18,32 @@ If your device isn't detected or shows limited info, email support@darken.eu wit
 
 Some fake/clone AirPods work, some don't — it depends on whether the clone broadcasts Apple-compatible Bluetooth LE data. Higher-quality clones that mimic Apple's protocol may be detected, while cheap ones typically aren't. There's no way to know in advance without trying.
 
-### Why can't CAPod control ANC, EQ, or tap gestures?
+### Can CAPod control ANC, EQ, or tap gestures?
 
-Apple's AirPods protocol has been reverse engineered, so in theory these features are possible. The blocker is actually an Android bug — Android currently can't establish the specific type of Bluetooth connection that AirPods require for settings changes.
+**Short answer:** Yes on phones that have the fixed Android Bluetooth stack. No on phones that haven't received the fix yet.
 
-This is tracked in our [GitHub issue #215](https://github.com/d4rken-org/capod/issues/215) and in the [official Android bug report](https://issuetracker.google.com/issues/371713238) (12,000+ upvotes). If/when Google fixes this, CAPod will add support for these features.
+**Historical context:** For a long time this was blocked by an Android bug that prevented the specific type of Bluetooth connection AirPods need for settings writes. It was tracked in [CAPod issue #215](https://github.com/d4rken-org/capod/issues/215) and the [upstream Android issuetracker 371713238](https://issuetracker.google.com/issues/371713238). Google has since fixed this upstream, and CAPod 5.0+ ships a client that uses the new connection type.
+
+**What CAPod 5.0+ can control** (the exact list depends on your specific AirPods model and firmware — CAPod only surfaces settings that model actually supports):
+
+- ANC, Transparency, and Off mode switching
+- Stem actions, press speed, and press-hold duration
+- Noise control on one AirPod, conversation awareness, and adaptive audio
+- Ear-detection toggle, listening-mode cycle, mic mode, end-call mic mute
+- Volume swipe, personalized / tone volume
+- Automatic IRK + encryption key retrieval for 1% battery granularity — usually; manual extraction (see the [Key Extraction Guide](AirPod-Keys)) remains available as a fallback if auto-retrieval doesn't complete
+
+**Which phones have the fix?** Confirmed on Pixel devices on Android 16 / 17 builds as of April 2026. Samsung, Xiaomi, OnePlus, and other OEMs depend on their own system updates — there's no guaranteed timeline, and availability is up to each OEM.
+
+**If controls don't show up even on a supported phone,** the device settings screen needs a live AAP (Apple Accessory Protocol) connection. Check that:
+
+1. The AirPods are paired and classically connected (not just showing battery in CAPod).
+2. The AirPods are visible in CAPod right now.
+3. You've given CAPod a few seconds to reconnect AAP if the case was just opened or the pods were just moved.
+
+**If your phone doesn't have the fix yet,** the device settings screen is unavailable, but battery display, popups, widgets, and auto-pause still work as before.
+
+**Still not possible on any Android phone:** EQ presets and firmware updates. These live on Apple-only systems CAPod can't reach.
 
 ### Why does the battery show in 10% increments instead of exact numbers?
 
@@ -30,6 +51,8 @@ Apple's public Bluetooth LE protocol only broadcasts battery in 10% steps (10%,
 
 CAPod can show 1% granularity if you extract the identity and encryption keys from the AirPods case using a PC (Windows, Linux, or macOS). Check the [Key Extraction Guide](AirPod-Keys) in the wiki for instructions.
 
+CAPod 5.0+ can also retrieve these keys automatically over AAP on phones that support the new connection type. When auto-retrieval succeeds, no manual extraction is needed. If it doesn't complete (for example, a profile mismatch or a partial key exchange), the manual guide above is still the fallback.
+
 ### The case battery is stuck or doesn't update
 
 The case doesn't broadcast battery information on its own — it needs at least one AirPod inserted to report its battery level. This is an Apple protocol limitation, not a CAPod bug.
@@ -101,7 +124,7 @@ The Pro upgrade keeps the app ad-free and supports solo development. CAPod is op
 
 ### Auto pause/play is slow, inconsistent, or only works for one AirPod
 
-CAPod relies on Bluetooth LE broadcasts to detect ear status, not a direct connection to the AirPods (which isn't possible due to an [Android system limitation](https://issuetracker.google.com/issues/371713238)). This means there can be a delay between removing an AirPod and the pause triggering.
+On phones that have the updated Android Bluetooth stack, CAPod 5.0+ can supplement BLE broadcasts with an AAP connection, which generally makes ear detection faster and more reliable. On phones that haven't received the fix yet, CAPod has to rely on BLE broadcast polling alone, so some delay is inherent between removing an AirPod and the pause triggering.
 
 You can reduce the delay by increasing the scan interval in CAPod's settings.
 

Home.md

@@ -10,6 +10,7 @@ CAPod brings AirPods battery monitoring and smart features to Android. It reads
 - **Auto pause/play** — Pause audio when you take an AirPod out
 - **Auto connect** — Automatically connect when AirPods are nearby
 - **Ear detection** — Know which pods are in use
+- **Device settings** — Control ANC modes, stem actions, and more on phones with the updated Android Bluetooth stack (CAPod 5.0+; see [FAQ](FAQ#can-capod-control-anc-eq-or-tap-gestures))
 
 ## Supported devices
 
@@ -24,7 +25,7 @@ All official AirPods and Beats models are supported — see the [full list in th
 
 ## Want more accurate battery readings?
 
-By default, battery shows in 10% steps (an Apple protocol limitation). You can unlock 1% granularity by extracting your AirPods' identity and encryption keys — see the **[Key Extraction Guide](AirPod-Keys)**.
+By default, battery shows in 10% steps (an Apple protocol limitation). You can unlock 1% granularity by extracting your AirPods' identity and encryption keys — see the **[Key Extraction Guide](AirPod-Keys)**. On phones with AAP support, CAPod 5.0+ usually retrieves these keys automatically; manual extraction is the fallback if auto-retrieval doesn't complete.
 
 ## Get help