docs: add screenshots header to android README

docs: fix badge label encoding in README
docs: update README
2026-05-16 13:35:37 +00:00 · 2026-05-16 00:11:49 +05:30 · 2026-05-15 23:42:41 +05:30 · 2026-05-15 23:36:11 +05:30 · 2026-05-15 22:25:31 +05:30 · 2026-05-11 22:12:39 +05:30
52 changed files with 900 additions and 439 deletions
--- a/.github/ISSUE_TEMPLATE/01-bug-report-android.yml
+++ b/.github/ISSUE_TEMPLATE/01-bug-report-android.yml
@@ -0,0 +1,110 @@
+name: Bug report (Android)
+description: Report a bug in the Android app
+labels: ["bug", "android"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please fill in as much as you can.
+  - type: input
+    id: app-version
+    attributes:
+      label: App version
+      description: "Find this in `Settings → About → Version` in the app, or in your phone's app info."
+      placeholder: "v0.2.5 (build 46)"
+    validations:
+      required: true
+  - type: dropdown
+    id: app-source
+    attributes:
+      label: App source
+      options:
+        - GitHub
+        - Play
+        - Built from source
+    validations:
+      required: true
+  - type: input
+    id: device
+    attributes:
+      label: Device
+      description: Manufacturer and model.
+      placeholder: "Google Pixel 8 Pro"
+    validations:
+      required: true
+  - type: input
+    id: android-version
+    attributes:
+      label: Android / OS version
+      description: Include the OEM skin if relevant.
+      placeholder: "Android 16, OxygenOS 16, ColorOS 16, ..."
+    validations:
+      required: true
+  - type: dropdown
+    id: root-method
+    attributes:
+      label: Root / hook method
+      options:
+        - No root (native L2CAP support)
+        - Magisk + Xposed
+        - KernelSU + Xposed
+        - Other (describe in additional context)
+    validations:
+      required: true
+  - type: dropdown
+    id: airpods-model
+    attributes:
+      label: AirPods model
+      options:
+        - AirPods (1st gen)
+        - AirPods (2nd gen)
+        - AirPods (3rd gen)
+        - AirPods (4th gen)
+        - AirPods (4th gen) with ANC
+        - AirPods Pro (1st gen)
+        - AirPods Pro 2 (Lightning)
+        - AirPods Pro 2 (USB-C)
+        - AirPods Pro 3
+        - Other / not sure
+    validations:
+      required: true
+  - type: input
+    id: firmware
+    attributes:
+      label: AirPods firmware
+      description: Find this under `About` in the app once connected.
+      placeholder: "8454768"
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened
+      description: Describe what you observed and what you expected. Include steps to reproduce if applicable.
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: |
+        If you are rooted, give the app root access, open the app, go to `Settings → Troubleshooting → Collect Logs`, and attach the resulting file here.
+
+        Without logs most bugs are very hard to diagnose. If you are not, follow these instructions:
+        (Needs access to a computer, and USB/Wireless Debugging under developer options enabled)
+
+        Commands:
+        - Get the uid: Linux/Mac: `adb shell dumpsys package me.kavishdevar.librepods | grep uid`
+        - Start logs: `adb logcat --uid=<uid>,1002 >> librepods-logs.txt` (1002 is for bluetooth)
+        
+        Steps for proper logs
+        - force close the app
+        - turn off bluetooth
+        - start logs
+        - open the app
+        - turn on bluetooth and connect
+
+      placeholder: Paste log content or attach the file
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      description: Anything else that might help (screenshots, video, related issues, what you've already tried).
--- a/.github/ISSUE_TEMPLATE/02-bug-report-linux.yml
+++ b/.github/ISSUE_TEMPLATE/02-bug-report-linux.yml
@@ -0,0 +1,83 @@
+name: Bug report (Linux)
+description: Report a bug in the Linux program
+labels: ["bug", "linux"]
+title: "[Linux] "
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the report. Please fill in as much as you can.
+  - type: input
+    id: app-version
+    attributes:
+      label: App version
+      placeholder: "linux-v0.1.0, or linux-rust commit abc1234"
+    validations:
+      required: true
+  - type: dropdown
+    id: variant
+    attributes:
+      label: Variant
+      options:
+        - Rust rewrite (`linux-rust` branch)
+        - QT version (NOT MAINTAINED! issues will be closed)
+    validations:
+      required: true
+  - type: input
+    id: distro
+    attributes:
+      label: Distro and version
+      placeholder: "Arch Linux, Fedora 41, Ubuntu 24.04, NixOS 25.05"
+    validations:
+      required: true
+  - type: input
+    id: desktop
+    attributes:
+      label: Desktop environment / compositor
+      placeholder: "GNOME 47 (Wayland), KDE 6 (X11), Hyprland, ..."
+    validations:
+      required: true
+  - type: dropdown
+    id: install-method
+    attributes:
+      label: Install method (only official sources)
+      options:
+        - Built from source (`nix` or otherwise)
+        - Pre-built binary
+        - AppImage
+        - Other
+    validations:
+      required: true
+  - type: dropdown
+    id: airpods-model
+    attributes:
+      label: AirPods model
+      options:
+        - AirPods (1st gen)
+        - AirPods (2nd gen)
+        - AirPods (3rd gen)
+        - AirPods (4th gen)
+        - AirPods (4th gen) with ANC
+        - AirPods Pro (1st gen)
+        - AirPods Pro 2 (Lightning)
+        - AirPods Pro 2 (USB-C)
+        - AirPods Pro 3
+        - Other / not sure
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened
+      description: Describe what you observed and what you expected. Include steps to reproduce if applicable.
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs and stderr
+      description: Run the app from a terminal with `--debug` and paste the output.
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
--- a/.github/ISSUE_TEMPLATE/03-feature-request.yml
+++ b/.github/ISSUE_TEMPLATE/03-feature-request.yml
@@ -0,0 +1,31 @@
+name: Feature request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope
+      options:
+        - Android
+        - Linux
+        - Both
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or use case
+      description: What are you trying to do? What is missing or hard today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: How might it work? UI sketches, behavior, edge cases.
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
--- a/.github/workflows/ci-android.yml
+++ b/.github/workflows/ci-android.yml
@@ -6,6 +6,7 @@ on:
      - '*'
    paths:
      - 'android/**'
+      - 'root-module-manual/**'
  pull_request:
    paths:
      - 'android/**'
@@ -34,6 +35,7 @@ jobs:
          java-version: 21
      - uses: gradle/actions/setup-gradle@v4
      - name: Decode keystore
+        if: github.event_name != 'pull_request'
        run: echo "${{ secrets.RELEASE_KEYSTORE_FILE }}" | base64 --decode > android/release.keystore
      - name: Setup Android SDK
        uses: android-actions/setup-android@v3
@@ -42,6 +44,7 @@ jobs:
      - name: Install NDK
        run: sdkmanager "ndk;30.0.14904198"
      - name: Create local.properties
+        if: github.event_name != 'pull_request'
        run: |
          cat <<EOF > android/local.properties
          RELEASE_STORE_FILE=../release.keystore
@@ -49,7 +52,12 @@ jobs:
          RELEASE_KEY_ALIAS=${{ secrets.RELEASE_KEY_ALIAS }}
          RELEASE_KEY_PASSWORD=${{ secrets.RELEASE_KEY_PASSWORD }}
          EOF
-      - name: Build
+      - name: Build debug APK for PRs
+        if: github.event_name == 'pull_request'
+        run: ./gradlew assembleFossDebug
+        working-directory: android
+      - name: Build release artifacts
+        if: github.event_name != 'pull_request'
        run: ./gradlew packageReleaseArtifacts
        working-directory: android
      - name: Get app version
@@ -58,26 +66,37 @@ jobs:
      - id: vars
        run: echo "short_sha=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
      - uses: actions/upload-artifact@v4
+        if: github.event_name != 'pull_request'
        with:
          name: apk-release
          path: release/*release.apk

      - uses: actions/upload-artifact@v4
+        if: github.event_name == 'pull_request'
+        with:
+          name: apk-debug
+          path: android/app/build/outputs/apk/foss/debug/app-foss-debug.apk
+
+      - uses: actions/upload-artifact@v4
+        if: github.event_name != 'pull_request'
        with:
          name: apk-debug
          path: release/*debug.apk

      - uses: actions/upload-artifact@v4
+        if: github.event_name != 'pull_request'
        with:
          name: root-module-release
          path: release/*release.zip

      - uses: actions/upload-artifact@v4
+        if: github.event_name != 'pull_request'
        with:
          name: root-module-debug
          path: release/*debug.zip

      - uses: actions/upload-artifact@v4
+        if: github.event_name != 'pull_request'
        with:
          name: release-bundle
          path: release/*.aab
--- a/.github/workflows/ci-linux-rust.yml
+++ b/.github/workflows/ci-linux-rust.yml
@@ -1,4 +1,4 @@
-name: Linux Build & Release
+name: Linux CI (Rust)

 on:
  push:
--- a/README.md
+++ b/README.md
@@ -1,114 +1,136 @@
-<p align="center">
-  <img src="https://img.shields.io/github/stars/kavishdevar/librepods?style=for-the-badge&logoColor=white" />
-  <img src="https://img.shields.io/github/license/kavishdevar/librepods?style=for-the-badge" />
-  <img src="https://img.shields.io/github/v/release/kavishdevar/librepods?style=for-the-badge&logoColor=white&label=Release" />
-  <img src="https://img.shields.io/github/downloads/kavishdevar/librepods/total?style=for-the-badge&label=Downloads" />
-  <img src="https://img.shields.io/github/issues/kavishdevar/librepods?style=for-the-badge" />
-  
-  <a href="https://discord.gg/HhG4ycVum4">
-    <img src="https://img.shields.io/discord/1441416992027574375?style=for-the-badge&logoColor=white&color=5865F2&label=Discord" />
-  </a>
-</p>
-
 >[!IMPORTANT]
-Development paused due to lack of time until 17th May 2026 (JEE Advanced). PRs and issues might not be responded to until then.
+Development paused due to lack of time until June 2026 (JEE Advanced). PRs and issues might not be responded to until then.

-![LibrePods Banner](./imgs/banner.png)
+---
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./imgs/banner-dark.png" />
+  <source media="(prefers-color-scheme: light)" srcset="./imgs/banner.png" />
+  <img alt="LibrePods" src="./imgs/banner.png" />
+</picture>
+
+<div align="center" style="margin: 20px 0px;">
+<a href="https://github.com/kavishdevar/librepods/releases/latest">
+  <img src="https://img.shields.io/github/downloads/kavishdevar/librepods/total?label=GitHub%20Downloads" />
+</a>
+<a href="https://github.com/kavishdevar/librepods/actions/workflows/ci-android.yml">
+  <img src="https://github.com/kavishdevar/librepods/actions/workflows/ci-android.yml/badge.svg" />
+</a>
+<a href="https://github.com/kavishdevar/librepods/actions/workflows/ci-linux-rust.yml">
+  <img src="https://github.com/kavishdevar/librepods/actions/workflows/ci-linux-rust.yml/badge.svg" />
+</a>
+<a href="https://github.com/kavishdevar/librepods/issues">
+  <img src="https://img.shields.io/github/issues/kavishdevar/librepods" />  
+</a>
+<a href="https://discord.gg/HhG4ycVum4">
+  <img src="https://img.shields.io/discord/1441416992027574375?logoColor=white&color=5865F2&label=Discord" />
+</a>
+</div>

 # What is LibrePods?

-LibrePods unlocks Apple's exclusive AirPods features on non-Apple devices. Get access to noise control modes, adaptive transparency, ear detection, hearing aid, customized transparency mode, battery status, and more - all the premium features you paid for but Apple locked to their ecosystem.
+LibrePods allows you to use AirPods features that are exclusive to Apple devices. It implements the proprietary protocol used to exchange data between AirPods and Apple devices, enabling features like changing noise control modes, fast ear detection, accurate battery status, head gestures, conversational awareness, and more on non-Apple platforms.

-# Device Compatibility
+# Installation

-| Status | Device                | Features                                                   |
-| ------ | --------------------- | ---------------------------------------------------------- |
-| ✅      | AirPods Pro (2nd Gen) | Fully supported and tested                                 |
-| ✅      | AirPods Pro (3rd Gen) | Fully supported (except heartrate monitoring)              |
-| ✅      | AirPods Max           | Fully supported (client shows unsupported features)        |
-| ⚠️      | Other AirPods models  | Basic features (battery status, ear detection) should work |
-
-Most features should work with any AirPods. Currently, I've only got AirPods Pro 2 to test with. But, I believe the protocol remains the same for all other AirPods (based on analysis of the bluetooth stack on macOS).
-
-# Key Features
-
- **Noise Control Modes**: Easily switch between noise control modes without having to reach out to your AirPods to long press
- **Ear Detection**: Controls your music automatically when you put your AirPods in or take them out, and switch to phone speaker when you take them out
- **Battery Status**: Accurate battery levels
- **Head Gestures**: Answer calls just by nodding your head
- **Conversational Awareness**: Volume automatically lowers when you speak
- **Hearing Aid\***
- **Customize Transparency Mode\***
- **Multi-device connectivity\*** (upto 2 devices)
- **Other customizations**:
-  - Rename your AirPods
-  - Customize long-press actions
-  - All accessibility settings
-  - And more!
-
-&ast; Features marked with an asterisk require the VendorID to be change to that of Apple.
-
-# Platform Support
-
-## Linux
-for the old version see the [Linux README](./linux/README.md). (doesn't have many features, maintainer didn't have time to work on it)
-
-new version in development ([#241](https://github.com/kavishdevar/librepods/pull/241))
-
-![new version](https://github.com/user-attachments/assets/86b3c871-89a8-4e49-861a-5119de1e1d28)
+> [!IMPORTANT]
+> Before installing, please read the [feature availability](#feature-availability) and platform-specific READMEs.

 ## Android

-### Screenshots
+### README: [android/README.md](./android/README.md)

-|                                                                                         |                                                    |                                                                              |
-| --------------------------------------------------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------- |
-| ![Settings 1](./android/imgs/settings-1.png)                                            | ![Settings 2](./android/imgs/settings-2.png)       | ![Debug Screen](./android/imgs/debug.png)                                    |
-| ![Battery Notification and QS Tile for NC Mode](./android/imgs/notification-and-qs.png) | ![Popup](./android/imgs/popup.png)                 | ![Head Tracking and Gestures](./android/imgs/head-tracking-and-gestures.png) |
-| ![Long Press Configuration](./android/imgs/long-press.png)                              | ![Widget](./android/imgs/widget.png)               | ![Customizations 1](./android/imgs/customizations-1.png)                     |
-| ![Customizations 2](./android/imgs/customizations-2.png)                                | ![accessibility](./android/imgs/accessibility.png) | ![transparency](./android/imgs/transparency.png)                             |
-| ![hearing-aid](./android/imgs/hearing-aid.png)                                          | ![hearing-test](./android/imgs/hearing-test.png)   | ![hearing-aid-adjustments](./android/imgs/hearing-aid-adjustments.png)       |
+### Google Play Store
+
+If you are using a supported device/OS combination listed in the [root requirements section](/android/#root-requirement), you can install LibrePods from the Google Play Store. You can use the VendorID hook features with root even from the Play Store version.
+
+<a href="https://play.google.com/store/apps/details?id=me.kavishdevar.librepods"><img width="170" alt="GetItOnGooglePlay_Badge_Web_color_English" src="https://github.com/user-attachments/assets/2948308f-af92-443f-94d9-ee381c3a6ccc"/></a>


-here's a very unprofessional demo video
+### GitHub Releases

-https://github.com/user-attachments/assets/43911243-0576-4093-8c55-89c1db5ea533
+If you need xposed because of the [root requirement](#root-requirement), you will have to use the apk/zip from the [GitHub releases](https://github.com/kavishdevar/librepods/releases/latest).

-### Root Requirement
+### Root Module

-The app needs root because of a bug in the Android Bluetooth stack Fluoride/non-compliance of Apple with Bluetooth standards. You must have Xposed installed for the app to workaround this bug and connect to AirPods. 
+If you want LibrePods to have privileged Bluetooth permissions to 
+- show battery status in the system settings and widgets
+- show AirPods icon in the system settings (xposed is also currently required for this)
+- disconnect AirPods when you take them out of your ears

-[https://issuetracker.google.com/issues/371713238](https://issuetracker.google.com/issues/371713238)
+## Linux

-Please do not comment in the thread. The issue has already been resolved and should be available in Android 17 for all devices. 
+### README: [linux/README.md](./linux/README.md)

-However, if you are using ColorOS/OxygenOS 16, Android 16 QPR3 on Pixel (ensure you're on the latest Play system update), you don't need root for most features.
+### GitHub Releases

-> [!IMPORTANT]
-> This workaround with Xposed is not guaranteed to work on all devices.
+The app is ready to download as an AppImage or an executable. You can download the latest pre-release from the [GitHub releases](https://github.com/kavishdevar/librepods/releases?q="linux-v0").

-Features requiring the VendorID hook will still require root. These features include customizing transparency mode, setting up hearing aid, and use Bluetooth Multipoint.
+### Nightly Builds (recommended)

-### Troubleshooting steps for common errors
- Ensure the correct scope is set in LSPosed/Vector.
- Ensure there is no root-hiding module preventing the hook from loading on the Bluetooth app.
- Restart your phone after confirming the scope.
+You can also try the latest build of the new version from the [GitHub Actions artifacts](https://github.com/kavishdevar/librepods/actions/workflows/ci-linux-rust.yml). On the latest successful workflow run, download the **librepods-x86_64.AppImage** or **librepods** binary from **Artifacts**.

-### A few notes

- Due to recent AirPods' firmware upgrades, you must enable `Off listening mode` to switch to `Off`. This is because in this mode, loud sounds are not reduced.
+# Feature availability

- If you have take both AirPods out, the app will automatically switch to the phone speaker. But, Android might keep on trying to connect to the AirPods because the phone is still connected to them, just the A2DP profile is not connected. The app tries to disconnect the A2DP profile as soon as it detects that Android has connected again if they're not in the ear.
+| Feature                                                     | Linux | Android |
+| ----------------------------------------------------------- | ----- | ------- |
+| Changing Listening Mode                                     | ✅     | ✅       |
+| Ear detection                                               | ✅     | ✅       |
+| Battery status                                              | ✅     | ✅       |
+| Renaming AirPods <details><summary>Note for Android</summary>On Android, you need to re-pair your AirPods after renaming them because Android might not use the latest name.</details>                                            | ✅     | ✅       |
+| Loud Sound Reduction                                        | 🔴     | ⚪       |
+| Head Gestures                                               | ⛔     | ✅       |
+| Conversational Awareness                                    | ✅     | ✅       |
+| Automatically connect to AirPods                            | ✅     | ✅       |
+| Hearing Aid                                                 | 🔴     | ⚪       |
+| Transparency Mode customization                             | 🔴     | ⚪       |
+| Multi-device connectivity (Bluetooth Multipoint; 2 devices only) | ⚪     | ⚪       |
+| <details><summary>Other accessibility configs (click to expand)</summary><ul><li>Press speed</li><li>Press and Hold duration</li><li>Noise Cancellation with single AirPod</li><li>Volume control on swipe</li><li>Volume swipe speed</li></ul></details>       | 🔴     | ✅       |
+| <details><summary>Other general configs</summary><ul><li>Press and Hold to cycle between listening modes/invoke digital assistant (invoking digital assistant needs a recent firmware)</li><li>Configure call controls</li><li>Personalized volume</li><li>Loud Sound Reduction (needs <a href="#vendorid-spoofing">VendorID spoofing</a>)</li><li>Microphone side</li><li>Pause media when falling asleep (needs a recent firmware)</li><li>Enable <code>Off listening mode</code> to switch to <code>Off</code></li></ul></details>                   | 🔴     | ✅       |
+| [Head-tracked Spatial Audio](#spatial-audio)                | ❓     | ❓       |
+| [Heart Rate Monitoring](#heart-rate-monitoring)             | ⛔     | 🔴       |
+| [Find My](#find-my)                                         | ❓     | ❓       |
+| [High quality two-way audio](#high-quality-two-way-audio)   | 🔴     | 🔴       |

- When renaming your AirPods through the app, you'll need to re-pair them with your phone for the name change to take effect. This is a limitation of how Bluetooth device naming works on Android.
+| Emoji | Meaning                                                             |
+| ----- | ------------------------------------------------------------------- |
+| ✅     | Implemented and works well                                          |
+| ⚪     | Needs [VendorID spoofing](#vendorid-spoofing); use at your own risk |
+| 🔴     | Not implemented yet; planned                                        |
+| ⛔     | Will not be implemented                                             |
+| ❓     | Unknown                                                             |

- If you want the AirPods icon and battery status to show in Android Settings app, install the app as a system app by using the root module.
+## Find My

-# Changing VendorID in the DID profile to that of Apple
+The following features related to Find My are planned, but require further RE and might need root on Android:
+
+- Add your AirPods to the Find My network
+- Play sound through charging case to find it
+- Notify when leaving behind
+- Toggle case charging sounds
+
+## Spatial Audio
+
+The app does not currently provide head tracking information to Android for the OS to perform HRTF. This has not been explored completely, and it might need root. 
+
+Spatializing stereo sound is beyond this project's scope and will never be available. Many OEMs have an implementation of their own for this.
+
+## Heart Rate Monitoring (AirPods Pro 3 and later)
+This is being worked upon, check the #⁠reverse-engineering channel on the LibrePods Discord server for more information. If it is ever implemented, it will most likely need root on Android.
+
+## High quality two-way audio
+On iOS/iPadOS, you can continue using A2DP while AirPods send the audio stream from its microphone over AACP. 
+
+Since there is no way on Android to have a virtual audio source which can be used for calls where the LibrePods app can provide the higher quality microphone stream, the app will need root on Android.s
+
+&ast; Features marked with an asterisk require the VendorID to be change to that of Apple.
+
+# VendorID Spoofing

 Turns out, if you change the VendorID in DID Profile to that of Apple, you get access to several special features!

-You can do this on Linux by editing the DeviceID in `/etc/bluetooth/main.conf`. Add this line to the config file `DeviceID = bluetooth:004C:0000:0000`. For android you can enable the `act as Apple device` setting in the app's settings.
+You can do this on Linux by editing the DeviceID in `/etc/bluetooth/main.conf`. Add this line to the config file `DeviceID = bluetooth:004C:0000:0000`. For android you can enable the `act as Apple device` setting in the app's settings (shown only when Xposed is available and LibrePods module is enabled).

 ## Multi-device Connectivity

@@ -120,49 +142,123 @@ Accessibility settings like customizing transparency mode (amplification, balanc

 All hearing aid customizations can be done from Android (linux soon), including setting the audiogram result. The app doesn't provide a way to take a hearing test because it requires much more precision. It is much better to use an already available audiogram result. 

+# Protocol and Reverse Engineering
+
+Please refer to the Wireshark dissector plugin by Nojus ([@pabloaul](https://github.com/pabloaul)) for more information on the protocols used: [pabloaul/apple-wireshark](https://github.com/pabloaul/apple-wireshark)
+
+The dissector had not been used in LibrePods for most of the implementation; I had reverse engineered the protocol myself before this dissector was made. But many (future) features including two-way high quality audio and spatial audio would not have been possible without their RE efforts!
+
+# Use of AI
+
+## Android app
+
+These parts of the app were completely AI-generated: 
+- Head Gestures - all of it, including logic and the UI
+- The offset setup with r2+the xposed module (both versions)
+- Troubleshooter and LogCollector
+
+Rest everything- the background service, the Bluetooth manager classes (AACP and ATT), the entire UI, even the smallest components were written manually.
+
+Some parts of the UI components were borrowed from [Kyant0's demo app](https://github.com/Kyant0/AndroidLiquidGlass/tree/master/catalog), which is licensed under [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
+
+## Linux (rewrite)
+
+The `aacp.rs` and the `att.rs` files were translated from Kotlin to Rust with AI. Some parts of the `media_controller.rs` file, mainly the pulse integration, was also AI-generated.
+
 # Supporters

 A huge thank you to everyone supporting the project!
- @davdroman
- @tedsalmon
- @wiless
- @SmartMsg
- @lunaroyster
- @ressiwage

-# Special thanks
+<table>
+  <tr>
+    <td align="center">
+      <a href="https://github.com/davdroman">
+        <img src="https://github.com/davdroman.png?size=48" width="48" height="48"alt="davdroman"/><br />
+        @davdroman
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://github.com/tedsalmon">
+        <img src="https://github.com/tedsalmon.png?size=48" width="48" height="48"alt="tedsalmon"/><br />
+        @tedsalmon
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://github.com/wiless">
+        <img src="https://github.com/wiless.png?size=48" width="48" height="48"alt="wiless"/><br />
+        @wiless
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://github.com/SmartMsg">
+        <img src="https://github.com/SmartMsg.png?size=48" width="48" height="48"alt="SmartMsg"/><br />
+        @SmartMsg
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://github.com/lunaroyster">
+        <img src="https://github.com/lunaroyster.png?size=48" width="48" height="48"alt="lunaroyster"/><br />
+        @lunaroyster
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://github.com/ressiwage">
+        <img src="https://github.com/ressiwage.png?size=48" width="48" height="48"alt="ressiwage"/><br />
+        @ressiwage
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://github.com/kkjdroid">
+        <img src="https://github.com/kkjdroid.png?size=48" width="48" height="48"alt="kkjdroid"/><br />
+        @kkjdroid
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://github.com/CitrusJoules">
+        <img src="https://github.com/CitrusJoules.png?size=48" width="48" height="48"alt="CitrusJoules"/><br />
+        @CitrusJoules
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://github.com/DanielReyesDev">
+        <img src="https://github.com/DanielReyesDev.png?size=48" width="48" height="48"alt="DanielReyesDev"/><br />
+        @DanielReyesDev
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://github.com/sumitduster">
+        <img src="https://github.com/sumitduster.png?size=48" width="48" height="48"alt="sumitduster"/><br />
+        @sumitduster
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://github.com/GrifTheDev">
+        <img src="https://github.com/GrifTheDev.png?size=48" width="48" height="48"alt="GrifTheDev"/><br />
+        @GrifTheDev
+      </a>
+    </td>
+  </tr>
+</table>
+
+# Special Thanks
 - @tyalie for making the first documentation on the protocol! ([tyalie/AAP-Protocol-Definition](https://github.com/tyalie/AAP-Protocol-Defintion))
 - @rithvikvibhu and folks over at lagrangepoint for helping with the hearing aid feature ([gist](https://gist.github.com/rithvikvibhu/45e24bbe5ade30125f152383daf07016))
 - @devnoname120 for helping with the first root patch
 - @timgromeyer for making the first version of the linux app
 - @hackclub for hosting [High Seas](https://highseas.hackclub.com) and [Low Skies](https://low-skies.hackclub.com)!
+- Of course, everyone who has contributed to the project in any way, including by testing, sharing feedback, or just showing interest!

 # Alternates for other platforms:
 - CAPod - A companion app for AirPods on Android. ([play store](https://play.google.com/store/apps/details?id=eu.darken.capod) | [source code](https://github.com/d4rken-org/capod)). Use this if you're using Android version 16 QPR3 or below and are not rooted.
 - MagicPods for Steam Deck ([website](https://magicpods.app/steamdeck/))
 - MagicPods - if you're looking for "LibrePods for Windows"  ([ms store](https://apps.microsoft.com/store/detail/9P6SKKFKSHKM) [installer](https://magicpods.app/installer/MagicPods.appinstaller) | [website](https://magicpods.app/))

-# Nightly/Development Builds
-
-Want to try the latest features before they're officially released? You can grab nightly builds from GitHub Actions:
-
-### Android
-1. Go to the [Actions tab](https://github.com/kavishdevar/librepods/actions/workflows/ci-android.yml)
-2. Click on the most recent successful workflow run
-3. Scroll down to **Artifacts** and download the **Debug APK** zip file
-4. Extract the zip and install the `.apk` on your device
-
-> [!NOTE]
-> You need to be signed in to GitHub to download artifacts. Nightly builds are debug-signed and may not auto-update. You may need to uninstall the stable version first.
-
-### Linux (Rust)
-1. Go to the [Actions tab](https://github.com/kavishdevar/librepods/actions/workflows/ci-linux-rust.yml)
-2. Click on the most recent successful workflow run
-3. Download the **librepods-x86_64.AppImage** or **librepods** binary from **Artifacts**
-
-> [!WARNING]
-> Nightly builds are unstable and may contain bugs. Use at your own risk.
-
 # Star History

 <a href="https://www.star-history.com/#kavishdevar/librepods&type=date&legend=top-left">
--- a/android/README.md
+++ b/android/README.md
@@ -0,0 +1,67 @@
+## Root Requirement
+
+LibrePods *may* require root depending on your device/OS and what features you want access to:
+
+- Features requiring the VendorID hook ([the features marked with an asterisk here](https://github.com/kavishdevar/librepods#key-features)) will always require root regardless of your device/OS.
+- On **ColorOS/OxygenOS 16 and realme UI 7.0** and **Pixel devices on Android 16 QPR3** (with the latest Google Play system update), LibrePods does not need root for most features.
+- On other devices, LibrePods needs root because of a bug in the Android Bluetooth stack Fluoride/non-compliance of Apple with Bluetooth standards. You must have Xposed installed for the app to workaround this bug and connect to AirPods. [This issue is being tracked here](https://issuetracker.google.com/issues/371713238). **Please do not comment on the issue thread.** The issue has already been resolved and should be available in **Android 17** for all devices.
+
+> [!IMPORTANT]
+> This workaround with Xposed is not guaranteed to work on all devices.
+
+
+## Installation
+
+### Google Play Store
+
+If you are using a supported device/OS combination, you can install LibrePods from the Google Play Store. You can use the VendorID hook features with root even from the Play Store version.
+
+<a href="https://play.google.com/store/apps/details?id=me.kavishdevar.librepods"><img width="170" alt="GetItOnGooglePlay_Badge_Web_color_English" src="https://github.com/user-attachments/assets/2948308f-af92-443f-94d9-ee381c3a6ccc"/></a>
+
+### GitHub Releases
+
+If you need xposed because of the [root requirement](#root-requirement), you will have to use the apk/zip from the [GitHub releases](https://github.com/kavishdevar/librepods/releases/latest).
+
+### As a system app (root module)
+
+If you want LibrePods to have privileged Bluetooth permissions to 
+- show battery status in the system settings and widgets
+- show AirPods icon in the system settings (xposed is also currently required for this)
+- switch audio to phone speakers when you are not wearing your AirPods
+
+you can install the root module. This is optional and only provides extra features, but it is not required for the app to work.
+
+> [!IMPORTANT]
+> When using the root module, do not install the Play Store version. There might be issues because of the signature mismatch between the Play Store version and the root module.
+
+## Nightly/Development Builds
+
+Want to try the latest features before they're officially released? You can grab nightly builds from the [latest nightly release](https://github.com/kavishdevar/librepods/releases?q=nightly).
+
+> [!WARNING]
+> These builds are automatically generated from the latest code and may contain new features and bug fixes that haven't been included in a stable release yet. However, please note that they may also be less stable than official releases, so use them at your own risk.
+
+## Screenshots
+
+|                                                                                 |                                            |                                                                      |
+| ------------------------------------------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------- |
+| ![Settings 1](./imgs/settings-1.png)                                            | ![Settings 2](./imgs/settings-2.png)       | ![Head Tracking and Gestures](./imgs/head-tracking-and-gestures.png) |
+| ![Long Press Configuration](./imgs/long-press.png)                              | ![Customizations 1](./imgs/customizations-1.png)                                | ![accessibility](./imgs/accessibility.png) |
+| ![transparency](./imgs/transparency.png)                                        | ![hearing-aid](./imgs/hearing-aid.png)     | ![hearing-test](./imgs/hearing-test.png)   |
+| ![hearing-aid-adjustments](./imgs/hearing-aid-adjustments.png)                  | ![Battery Notification and QS Tile for NC Mode](./imgs/notification-and-qs.png) | ![Widget](./imgs/widget.png)               |
+
+
+here's a very unprofessional demo video
+
+https://github.com/user-attachments/assets/43911243-0576-4093-8c55-89c1db5ea533
+
+### Troubleshooting steps for common errors
+- Ensure the correct scope is set in LSPosed/Vector.
+- Ensure there is no root-hiding module preventing the hook from loading on the Bluetooth app.
+- Restart your phone after confirming the scope.
+
+### A few notes
+
+- Due to recent AirPods' firmware upgrades, you must enable `Off listening mode` to switch to `Off`. This is because in this mode, loud sounds are not reduced.
+
+- When renaming your AirPods through the app, you'll need to re-pair them with your phone for the name change to take effect. This is a limitation of how Bluetooth device naming works on Android.
--- a/android/app/build.gradle.kts
+++ b/android/app/build.gradle.kts
@@ -1,6 +1,6 @@
 import java.util.Properties

-val appVersionName = "0.2.8"
+val appVersionName = "0.2.9"

 plugins {
    alias(libs.plugins.android.application)
@@ -10,17 +10,29 @@ plugins {
    id("kotlin-parcelize")
 }

+val localPropsFile = rootProject.file("local.properties")
 val props = Properties().apply {
-    load(rootProject.file("local.properties").inputStream())
+    if (localPropsFile.exists()) {
+        load(localPropsFile.inputStream())
+    }
 }

+val releaseSigningAvailable = listOf(
+    "RELEASE_STORE_FILE",
+    "RELEASE_STORE_PASSWORD",
+    "RELEASE_KEY_ALIAS",
+    "RELEASE_KEY_PASSWORD"
+).all { props[it]?.toString()?.isNotBlank() == true }
+
 android {
    signingConfigs {
-        create("release") {
-            storeFile = file(props["RELEASE_STORE_FILE"] as String)
-            storePassword = props["RELEASE_STORE_PASSWORD"] as String
-            keyAlias = props["RELEASE_KEY_ALIAS"] as String
-            keyPassword = props["RELEASE_KEY_PASSWORD"] as String
+        if (releaseSigningAvailable) {
+            create("release") {
+                storeFile = file(props["RELEASE_STORE_FILE"] as String)
+                storePassword = props["RELEASE_STORE_PASSWORD"] as String
+                keyAlias = props["RELEASE_KEY_ALIAS"] as String
+                keyPassword = props["RELEASE_KEY_PASSWORD"] as String
+            }
        }
    }
    namespace = "me.kavishdevar.librepods"
@@ -28,9 +40,8 @@ android {

    defaultConfig {
        applicationId = "me.kavishdevar.librepods"
-        minSdk = 33
        targetSdk = 37
-        versionCode = 49
+        versionCode = 52
        versionName = appVersionName
    }
    buildTypes {
@@ -46,22 +57,34 @@ android {
                }
            }
            buildConfigField("Boolean", "PLAY_BUILD", "false")
-            signingConfig = signingConfigs.getByName("release")
+            if (releaseSigningAvailable) {
+                signingConfig = signingConfigs.getByName("release")
+            }
+            defaultConfig {
+                minSdk = 33
+            }
        }
        debug {
            buildConfigField("Boolean", "PLAY_BUILD", "false")
-            signingConfig = signingConfigs.getByName("release")
+            if (releaseSigningAvailable) {
+                signingConfig = signingConfigs.getByName("release")
+            }
            versionNameSuffix = "-debug"
+            defaultConfig {
+                minSdk = 33
+            }
        }
-        create("playRelease") {
-            initWith(getByName("release"))
+    }
+    productFlavors {
+        create("foss") {
+            dimension = "env"
+            buildConfigField("Boolean", "PLAY_BUILD", "false")
+        }
+        create("play") {
+            dimension = "env"
            buildConfigField("Boolean", "PLAY_BUILD", "true")
            versionNameSuffix = "-play"
-        }
-        create("playDebug") {
-            initWith(getByName("debug"))
-            buildConfigField("Boolean", "PLAY_BUILD", "true")
-            versionNameSuffix = "-youshouldnothavethis"
+            minSdk = 36
        }
    }
    compileOptions {
@@ -91,25 +114,6 @@ android {
    ndkVersion = "30.0.14904198"

    flavorDimensions += "env"
-
-    productFlavors {
-        create("normal") {
-            dimension = "env"
-            externalNativeBuild {
-                cmake {
-                    arguments += "-DIS_XPOSED=OFF"
-                }
-            }
-        }
-        create("xposed") {
-            dimension = "env"
-            externalNativeBuild {
-                cmake {
-                    arguments += "-DIS_XPOSED=ON"
-                }
-            }
-        }
-    }
 }

 dependencies {
@@ -139,9 +143,10 @@ dependencies {
    implementation(libs.backdrop)
 //    implementation(libs.hilt)
 //    implementation(libs.hilt.compiler)
-    add("xposedCompileOnly", libs.libxposed.api)
-    add("xposedImplementation", libs.libxposed.service)
-    add("playReleaseImplementation", libs.billing)
+    compileOnly(libs.libxposed.api)
+    implementation(libs.libxposed.service)
+    implementation(libs.play.review)
+    implementation(libs.play.review.ktx)
 }

 aboutLibraries {
@@ -184,14 +189,14 @@ fun registerRootModuleZipTask(
 }

 val zipRelease = registerRootModuleZipTask(
-    "zipXposedReleaseModule",
-    "xposed",
+    "zipReleaseModule",
+    "foss",
    "release"
 )

 val zipDebug = registerRootModuleZipTask(
-    "zipXposedDebugModule",
-    "xposed",
+    "zipDebugModule",
+    "foss",
    "debug"
 )

@@ -200,22 +205,22 @@ val collect = tasks.register<Copy>("collectReleaseArtifacts") {
    dependsOn(
        zipRelease,
        zipDebug,
-        "bundleXposedPlayRelease"
+        "bundlePlayRelease"
    )

    into(releaseDir)

-    from(layout.buildDirectory.dir("outputs/apk/xposed/release")) {
+    from(layout.buildDirectory.dir("outputs/apk/foss/release")) {
        include("*.apk")
        rename(".*", "LibrePods-FOSS-v$appVersionName-release.apk")
    }

-    from(layout.buildDirectory.dir("outputs/apk/xposed/debug")) {
+    from(layout.buildDirectory.dir("outputs/apk/foss/debug")) {
        include("*.apk")
        rename(".*", "LibrePods-FOSS-v$appVersionName-debug.apk")
    }

-    from(layout.buildDirectory.dir("outputs/bundle/xposedPlayRelease")) {
+    from(layout.buildDirectory.dir("outputs/bundle/playRelease")) {
        include("*.aab")
    }

--- a/android/app/src/main/cpp/CMakeLists.txt
+++ b/android/app/src/main/cpp/CMakeLists.txt
@@ -3,8 +3,6 @@ cmake_minimum_required(VERSION 3.22.1)
 project("l2c_fcr_hook")
 set(CMAKE_CXX_STANDARD 23)

-option(IS_XPOSED "Build Xposed components" OFF)
-
 add_library(bluetooth_socket SHARED
        bluetooth_socket.cpp
 )
@@ -24,40 +22,36 @@ target_link_libraries(bluetooth_socket
        log
 )

-if(IS_XPOSED)

-    set(XPOSED_SRC_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../../xposed/cpp)
+set(XPOSED_SRC_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../../xposed/cpp)

-    add_library(l2c_fcr_hook SHARED
-            ${XPOSED_SRC_DIR}/l2c_fcr_hook.cpp
+add_library(l2c_fcr_hook SHARED
+        l2c_fcr_hook.cpp

-            ${XPOSED_SRC_DIR}/xz/xz_crc32.c
-            ${XPOSED_SRC_DIR}/xz/xz_crc64.c
-            ${XPOSED_SRC_DIR}/xz/xz_sha256.c
-            ${XPOSED_SRC_DIR}/xz/xz_dec_stream.c
-            ${XPOSED_SRC_DIR}/xz/xz_dec_lzma2.c
-            ${XPOSED_SRC_DIR}/xz/xz_dec_bcj.c
-    )
+        xz/xz_crc32.c
+        xz/xz_crc64.c
+        xz/xz_sha256.c
+        xz/xz_dec_stream.c
+        xz/xz_dec_lzma2.c
+        xz/xz_dec_bcj.c
+)

-    target_include_directories(l2c_fcr_hook PRIVATE
-            ${XPOSED_SRC_DIR}
-            ${XPOSED_SRC_DIR}/xz
-    )
+target_include_directories(l2c_fcr_hook PRIVATE
+        xz
+)

-    target_compile_definitions(l2c_fcr_hook PRIVATE
-            XZ_DEC_X86
-            XZ_DEC_ARM
-            XZ_DEC_ARMTHUMB
-            XZ_DEC_ARM64
-            XZ_DEC_ANY_CHECK
-            XZ_USE_CRC64
-            XZ_USE_SHA256
-            XZ_DEC_CONCATENATED
-    )
+target_compile_definitions(l2c_fcr_hook PRIVATE
+        XZ_DEC_X86
+        XZ_DEC_ARM
+        XZ_DEC_ARMTHUMB
+        XZ_DEC_ARM64
+        XZ_DEC_ANY_CHECK
+        XZ_USE_CRC64
+        XZ_USE_SHA256
+        XZ_DEC_CONCATENATED
+)

-    target_link_libraries(l2c_fcr_hook
-            android
-            log
-    )
-
-endif()
+target_link_libraries(l2c_fcr_hook
+        android
+        log
+)
--- a/android/app/src/xposed/cpp/l2c_fcr_hook.cpp
+++ b/android/app/src/xposed/cpp/l2c_fcr_hook.cpp
--- a/android/app/src/xposed/cpp/l2c_fcr_hook.h
+++ b/android/app/src/xposed/cpp/l2c_fcr_hook.h
--- a/android/app/src/xposed/cpp/xz/xz.h
+++ b/android/app/src/xposed/cpp/xz/xz.h
--- a/android/app/src/xposed/cpp/xz/xz_config.h
+++ b/android/app/src/xposed/cpp/xz/xz_config.h
--- a/android/app/src/xposed/cpp/xz/xz_crc32.c
+++ b/android/app/src/xposed/cpp/xz/xz_crc32.c
--- a/android/app/src/xposed/cpp/xz/xz_crc64.c
+++ b/android/app/src/xposed/cpp/xz/xz_crc64.c
--- a/android/app/src/xposed/cpp/xz/xz_dec_bcj.c
+++ b/android/app/src/xposed/cpp/xz/xz_dec_bcj.c
--- a/android/app/src/xposed/cpp/xz/xz_dec_lzma2.c
+++ b/android/app/src/xposed/cpp/xz/xz_dec_lzma2.c
--- a/android/app/src/xposed/cpp/xz/xz_dec_stream.c
+++ b/android/app/src/xposed/cpp/xz/xz_dec_stream.c
--- a/android/app/src/xposed/cpp/xz/xz_lzma2.h
+++ b/android/app/src/xposed/cpp/xz/xz_lzma2.h
--- a/android/app/src/xposed/cpp/xz/xz_private.h
+++ b/android/app/src/xposed/cpp/xz/xz_private.h
--- a/android/app/src/xposed/cpp/xz/xz_sha256.c
+++ b/android/app/src/xposed/cpp/xz/xz_sha256.c
--- a/android/app/src/xposed/cpp/xz/xz_stream.h
+++ b/android/app/src/xposed/cpp/xz/xz_stream.h
--- a/android/app/src/xposed/java/me/kavishdevar/librepods/LibrePodsApplication.kt
+++ b/android/app/src/xposed/java/me/kavishdevar/librepods/LibrePodsApplication.kt
@@ -12,6 +12,7 @@ import me.kavishdevar.librepods.utils.XposedServiceHolder
 import me.kavishdevar.librepods.utils.XposedState

 class LibrePodsApplication: Application(), XposedServiceHelper.OnServiceListener, DefaultLifecycleObserver {
+
    override fun onCreate() {
        XposedServiceHelper.registerListener(this)
        BillingManager.provider = BillingProviderFactory.create(this)
--- a/android/app/src/main/java/me/kavishdevar/librepods/MainActivity.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/MainActivity.kt
@@ -24,6 +24,7 @@ package me.kavishdevar.librepods
 // import me.kavishdevar.librepods.utils.RadareOffsetFinder
 //import dagger.hilt.android.AndroidEntryPoint
 import android.annotation.SuppressLint
+import android.app.Activity
 import android.content.BroadcastReceiver
 import android.content.ComponentName
 import android.content.Context
@@ -65,7 +66,6 @@ import androidx.compose.foundation.layout.padding
 import androidx.compose.foundation.layout.size
 import androidx.compose.foundation.rememberScrollState
 import androidx.compose.foundation.shape.RoundedCornerShape
-import androidx.compose.foundation.text.input.rememberTextFieldState
 import androidx.compose.foundation.verticalScroll
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.Notifications
@@ -87,13 +87,11 @@ import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.draw.clip
 import androidx.compose.ui.draw.scale
-import androidx.compose.ui.focus.FocusRequester
 import androidx.compose.ui.geometry.Offset
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.graphics.drawscope.rotate
 import androidx.compose.ui.graphics.vector.ImageVector
 import androidx.compose.ui.platform.LocalContext
-import androidx.compose.ui.platform.LocalSoftwareKeyboardController
 import androidx.compose.ui.platform.LocalWindowInfo
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.res.vectorResource
@@ -114,6 +112,7 @@ import com.google.accompanist.permissions.ExperimentalPermissionsApi
 import com.google.accompanist.permissions.MultiplePermissionsState
 import com.google.accompanist.permissions.isGranted
 import com.google.accompanist.permissions.rememberMultiplePermissionsState
+import com.google.android.play.core.review.ReviewManagerFactory
 import com.kyant.backdrop.backdrops.layerBackdrop
 import com.kyant.backdrop.backdrops.rememberLayerBackdrop
 import dev.chrisbanes.haze.hazeSource
@@ -122,14 +121,8 @@ import dev.chrisbanes.haze.rememberHazeState
 import me.kavishdevar.librepods.data.AirPodsNotifications
 import me.kavishdevar.librepods.data.ControlCommandRepository
 import me.kavishdevar.librepods.presentation.components.AppInfoCard
-import me.kavishdevar.librepods.presentation.components.ConfirmationDialog
 import me.kavishdevar.librepods.presentation.components.DeviceInfoCard
-import me.kavishdevar.librepods.presentation.components.SelectItem
-import me.kavishdevar.librepods.presentation.components.StyledBottomSheet
-import me.kavishdevar.librepods.presentation.components.StyledButton
 import me.kavishdevar.librepods.presentation.components.StyledIconButton
-import me.kavishdevar.librepods.presentation.components.StyledInputField
-import me.kavishdevar.librepods.presentation.components.StyledSelectList
 import me.kavishdevar.librepods.presentation.screens.AccessibilitySettingsScreen
 import me.kavishdevar.librepods.presentation.screens.AdaptiveStrengthScreen
 import me.kavishdevar.librepods.presentation.screens.AirPodsSettingsScreen
@@ -159,6 +152,7 @@ import kotlin.io.encoding.ExperimentalEncodingApi

 lateinit var serviceConnection: ServiceConnection
 lateinit var connectionStatusReceiver: BroadcastReceiver
+lateinit var testReviewReceiver: BroadcastReceiver

 //@AndroidEntryPoint
@ExperimentalMaterial3Api
@@ -225,8 +219,6 @@ fun Main() {
    val context = LocalContext.current
    val sharedPreferences = context.getSharedPreferences("settings", MODE_PRIVATE)
    if (!isSupported(sharedPreferences) && !XposedState.bluetoothScopeEnabled) {
-        val showDialog = remember { mutableStateOf(false) }
-        val showPlayBypassVisible = remember { mutableStateOf(false) }
        val hazeState = rememberHazeState()
        val backdrop = rememberLayerBackdrop()
        val isDarkTheme = isSystemInDarkTheme()
@@ -243,7 +235,7 @@ fun Main() {
                .background(if (isDarkTheme) Color.Black else Color(0xFFF2F2F7)),
            contentAlignment = Alignment.Center
        ) {
-            Column (
+            Column(
                modifier = Modifier
                    .padding(horizontal = 16.dp)
                    .verticalScroll(scrollState),
@@ -288,173 +280,25 @@ fun Main() {
                                .padding(horizontal = 12.dp, vertical = 16.dp)
                        )
                    }
-                    StyledButton(
-                        onClick = { showDialog.value = true },
-                        backdrop = rememberLayerBackdrop(),
+                    Spacer(modifier = Modifier.height(4.dp))
+                    Text(
+                        text = stringResource(R.string.enable_app_in_xposed_or_update_device),
+                        style = TextStyle(
+                            fontFamily = FontFamily(Font(R.font.sf_pro)),
+                            fontWeight = FontWeight.Light,
+                            color = if (isDarkTheme) Color.White else Color.Black,
+                            fontSize = 14.sp
+                        ),
                        modifier = Modifier
-                            .fillMaxWidth(),
-                        isInteractive = false,
-                        surfaceColor = if (isDarkTheme) Color(0xFF862424) else Color(0xFFC94646)
-                    ) {
-                        Text(
-                            text = stringResource(R.string.bypass_compatibility_check),
-                            style = TextStyle(
-                                fontFamily = FontFamily(Font(R.font.sf_pro)),
-                                fontWeight = FontWeight.Medium,
-                                color = Color.White,
-                                fontSize = 16.sp
-                            ),
-                        )
-                    }
-                    Spacer(modifier = Modifier.height(24.dp))
+                            .fillMaxWidth()
+                            .padding(horizontal = 16.dp, vertical = 16.dp)
+                    )
                    DeviceInfoCard()
                    AppInfoCard()
                }
                Spacer(modifier = Modifier.height(48.dp))
            }
        }
-
-        ConfirmationDialog(
-            showDialog = showDialog,
-            title = stringResource(R.string.bypass_compatibility_check),
-            message = stringResource(R.string.bypass_compatiblity_check_confirmation),
-            confirmText = stringResource(R.string.yes),
-            dismissText = stringResource(R.string.no),
-            onConfirm = {
-                showDialog.value = false
-                if (BuildConfig.PLAY_BUILD) {
-                    showPlayBypassVisible.value = true
-                } else {
-                    sharedPreferences.edit {
-                        putBoolean("bypass_device_check.v2", true)
-                    }
-                    val intent = Intent(context, MainActivity::class.java)
-                    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK)
-                    context.startActivity(intent)
-                }
-            },
-            onDismiss = {
-                showDialog.value = false
-            },
-            backdrop = backdrop
-//            hazeState = hazeState
-        )
-
-        if (BuildConfig.PLAY_BUILD) {
-            StyledBottomSheet(
-                visible = showPlayBypassVisible.value,
-                onDismiss = {
-                    showPlayBypassVisible.value = false
-                    showDialog.value = true
-                },
-                backdrop = backdrop
-            ) { innerBackdrop, _ ->
-                val contentColor = if (isDarkTheme) Color.White else Color.Black
-
-                var acknowledged by remember { mutableStateOf(false) }
-                val inputState = rememberTextFieldState("")
-
-                val isValid = acknowledged && inputState.text.trim() == "OK"
-
-                val sfPro = FontFamily(Font(R.font.sf_pro))
-
-                Column(verticalArrangement = Arrangement.spacedBy(12.dp)) {
-                    Text(
-                        text = stringResource(R.string.bypass_compatibility_check),
-                        style = TextStyle(
-                            fontFamily = sfPro,
-                            fontWeight = FontWeight.SemiBold,
-                            fontSize = 18.sp,
-                            color = contentColor
-                        ),
-                        modifier = Modifier.padding(horizontal = 12.dp)
-                    )
-
-                    Text(
-                        text = stringResource(R.string.compatibility_play_dialog_confirmation),
-                        style = TextStyle(
-                            fontFamily = sfPro,
-                            fontWeight = FontWeight.Medium,
-                            fontSize = 14.sp,
-                            color = contentColor
-                        ),
-                        modifier = Modifier.padding(horizontal = 12.dp)
-                    )
-
-                    StyledSelectList(
-                        items = listOf(
-                            SelectItem(
-                                name = stringResource(R.string.read_compatibility_requirements),
-                                selected = acknowledged,
-                                onClick = { acknowledged = !acknowledged }
-                            )
-                        )
-                    )
-
-                    val focusRequester = remember { FocusRequester() }
-                    val keyboardController = LocalSoftwareKeyboardController.current
-
-                    LaunchedEffect(Unit) {
-                        focusRequester.requestFocus()
-                        keyboardController?.show()
-                    }
-
-                    StyledInputField(
-                        inputState = inputState,
-                        focusRequester = focusRequester,
-                        placeholder = stringResource(R.string.type_ok_to_continue, "OK")
-                    )
-
-                    Row(
-                        modifier = Modifier.fillMaxWidth(),
-                        horizontalArrangement = Arrangement.spacedBy(24.dp)
-                    ) {
-                        StyledButton(
-                            onClick = { showPlayBypassVisible.value = false },
-                            backdrop = innerBackdrop,
-                            modifier = Modifier.weight(1f),
-                        ) {
-                            Text(
-                                text = stringResource(R.string.no),
-                                style = TextStyle(
-                                    fontFamily = sfPro,
-                                    fontWeight = FontWeight.Medium,
-                                    fontSize = 14.sp,
-                                    color = contentColor
-                                )
-                            )
-                        }
-                        StyledButton(
-                            onClick =  {
-                                showPlayBypassVisible.value = false
-                                sharedPreferences.edit {
-                                    putBoolean("bypass_device_check.v2", true)
-                                    val intent = Intent(context, MainActivity::class.java)
-                                    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK)
-                                    context.startActivity(intent)
-                                }
-                            },
-                            backdrop = innerBackdrop,
-                            isInteractive = isValid,
-                            modifier = Modifier.weight(1f),
-                            enabled = isValid,
-                            surfaceColor = if (isDarkTheme) Color(0xFF0091FF) else Color(0xFF0088FF)
-                        ) {
-                            Text(
-                                text = stringResource(R.string.proceed),
-                                style = TextStyle(
-                                    fontFamily = sfPro,
-                                    fontWeight = FontWeight.Medium,
-                                    fontSize = 14.sp,
-                                    color = if (isValid) contentColor else contentColor.copy(alpha = 0.4f)
-                                )
-                            )
-                        }
-                    }
-                }
-            }
-        }
-
        return
    }

@@ -515,6 +359,31 @@ fun Main() {

        val navController = rememberNavController()

+        LaunchedEffect(Unit) {
+            if (BuildConfig.PLAY_BUILD) {
+                val now = System.currentTimeMillis()
+                val firstConn =
+                    sharedPreferences.getLong("first_connection_successful_time", 0L)
+
+                val alreadyPrompted =
+                    sharedPreferences.getBoolean("review_prompted", false)
+
+                val oneDay = 24 * 60 * 60 * 1000L
+
+                if (
+                    firstConn != 0L &&
+                    !alreadyPrompted &&
+                    (now - firstConn) > oneDay
+                ) {
+                    triggerReviewFlow(context as? Activity ?: return@LaunchedEffect)
+
+                    sharedPreferences.edit {
+                        putBoolean("review_prompted", true)
+                    }
+                }
+            }
+        }
+
        Box(
            modifier = Modifier.fillMaxSize()
        ) {
@@ -652,6 +521,12 @@ fun Main() {
                override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
                    val binder = service as AirPodsService.LocalBinder
                    airPodsService.value = binder.getService()
+
+                    if (!sharedPreferences.contains("first_connection_successful_time")) {
+                        sharedPreferences.edit {
+                            putLong("first_connection_successful_time", System.currentTimeMillis())
+                        }
+                    }
                }

                override fun onServiceDisconnected(name: ComponentName?) {
@@ -677,6 +552,17 @@ fun Main() {
    }
 }

+private fun triggerReviewFlow(activity: Activity) {
+    val manager = ReviewManagerFactory.create(activity)
+    val request = manager.requestReviewFlow()
+    request.addOnCompleteListener { task ->
+        if (task.isSuccessful) {
+            val reviewInfo = task.result
+            manager.launchReviewFlow(activity, reviewInfo)
+        }
+    }
+}
+
@OptIn(ExperimentalPermissionsApi::class, ExperimentalMaterial3Api::class)
@Composable
 fun PermissionsScreen(
--- a/android/app/src/main/java/me/kavishdevar/librepods/bluetooth/AACPManager.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/bluetooth/AACPManager.kt
@@ -109,7 +109,8 @@ class AACPManager {
            EAR_DETECTION_CONFIG(0x0A), AUTOMATIC_CONNECTION_CONFIG(0x20), OWNS_CONNECTION(0x06), PPE_TOGGLE_CONFIG(
                0x37
            ),
-            PPE_CAP_LEVEL_CONFIG(0x38);
+            PPE_CAP_LEVEL_CONFIG(0x38),
+            DYNAMIC_END_OF_CHARGE(0x3B);

            companion object {
                fun fromByte(byte: Byte): ControlCommandIdentifiers? =
--- a/android/app/src/xposed/java/me/kavishdevar/librepods/data/XposedRemotePrefImpl.kt
+++ b/android/app/src/xposed/java/me/kavishdevar/librepods/data/XposedRemotePrefImpl.kt
--- a/android/app/src/main/java/me/kavishdevar/librepods/presentation/screens/AirPodsSettingsScreen.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/presentation/screens/AirPodsSettingsScreen.kt
@@ -131,7 +131,6 @@ fun AirPodsSettingsScreen(viewModel: AirPodsViewModel, navController: NavControl
        viewModel.refreshInitialData()
    }

-    isSystemInDarkTheme()
    val hazeStateS = remember { mutableStateOf(HazeState()) }

    StyledScaffold(
@@ -398,6 +397,16 @@ fun AirPodsSettingsScreen(viewModel: AirPodsViewModel, navController: NavControl
                    }
                }

+                item(key = "spacer_dynamic_end_of_charge") { Spacer(modifier = Modifier.height(16.dp)) }
+                item(key = "dynamic_end_of_charge") {
+                    StyledToggle(
+                        label = stringResource(R.string.optimized_charging),
+                        description = stringResource(R.string.optimized_charging_description),
+                        checked = state.dynamicEndOfCharge,
+                        onCheckedChange = viewModel::setDynamicEndOfCharge
+                    )
+                }
+
                item(key = "spacer_accessibility") { Spacer(modifier = Modifier.height(16.dp)) }
                item(key = "accessibility") {
                    NavigationButton(
@@ -542,19 +551,22 @@ fun AirPodsSettingsScreen(viewModel: AirPodsViewModel, navController: NavControl
                    }
                    Spacer(Modifier.height(16.dp))
                }
-                StyledButton(
-                    onClick = {
-                        viewModel.reconnectFromSavedMac()
-                    }, backdrop = backdrop, modifier = Modifier.fillMaxWidth(0.9f)
-                ) {
-                    Text(
-                        text = stringResource(R.string.reconnect_to_last_device), style = TextStyle(
-                            fontSize = 16.sp,
-                            fontWeight = FontWeight.Medium,
-                            fontFamily = FontFamily(Font(R.font.sf_pro)),
-                            color = if (isSystemInDarkTheme()) Color.White else Color.Black
+                if (state.connectionSuccessful) {
+                    StyledButton(
+                        onClick = {
+                            viewModel.reconnectFromSavedMac()
+                        }, backdrop = backdrop, modifier = Modifier.fillMaxWidth(0.9f)
+                    ) {
+                        Text(
+                            text = stringResource(R.string.reconnect_to_last_device),
+                            style = TextStyle(
+                                fontSize = 16.sp,
+                                fontWeight = FontWeight.Medium,
+                                fontFamily = FontFamily(Font(R.font.sf_pro)),
+                                color = if (isSystemInDarkTheme()) Color.White else Color.Black
+                            )
                        )
-                    )
+                    }
                }
            }
        }
--- a/android/app/src/main/java/me/kavishdevar/librepods/presentation/screens/AppSettingsScreen.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/presentation/screens/AppSettingsScreen.kt
@@ -20,6 +20,7 @@ package me.kavishdevar.librepods.presentation.screens

 import android.content.Intent
 import android.content.pm.PackageManager
+import android.net.Uri
 import android.os.Build
 import android.widget.Toast
 import androidx.compose.foundation.background
@@ -157,6 +158,48 @@ fun AppSettingsScreen(
                    enabled = state.isPremium
                )

+                Text(
+                    text = stringResource(R.string.popup_animations), style = TextStyle(
+                        fontSize = 14.sp,
+                        fontWeight = FontWeight.Bold,
+                        color = textColor.copy(alpha = 0.6f),
+                        fontFamily = FontFamily(Font(R.font.sf_pro))
+                    ), modifier = Modifier.padding(16.dp, bottom = 2.dp, top = 24.dp)
+                )
+
+                Spacer(modifier = Modifier.height(2.dp))
+
+                Column(
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .background(
+                            backgroundColor, RoundedCornerShape(28.dp)
+                        )
+                        .padding(vertical = 4.dp)
+                ) {
+                    StyledToggle(
+                        label = stringResource(R.string.show_bottom_sheet_popup),
+                        description = stringResource(R.string.show_bottom_sheet_popup_description),
+                        checked = state.showBottomSheetPopup,
+                        onCheckedChange = viewModel::setShowBottomSheetPopup,
+                        independent = false
+                    )
+
+                    HorizontalDivider(
+                        thickness = 1.dp,
+                        color = Color(0x40888888),
+                        modifier = Modifier.padding(horizontal = 12.dp)
+                    )
+
+                    StyledToggle(
+                        label = stringResource(R.string.show_island_popup),
+                        description = stringResource(R.string.show_island_popup_description),
+                        checked = state.showIslandPopup,
+                        onCheckedChange = viewModel::setShowIslandPopup,
+                        independent = false
+                    )
+                }
+
                Text(
                    text = stringResource(R.string.conversational_awareness), style = TextStyle(
                        fontSize = 14.sp,
@@ -500,10 +543,23 @@ fun AppSettingsScreen(
                    name = stringResource(R.string.github_issues),
                    navController = navController,
                    onClick = {
-                        val intent = Intent(
-                            Intent.ACTION_VIEW,
-                            "https://github.com/kavishdevar/librepods/issues".toUri()
+                        val appVersion = Uri.encode("v${BuildConfig.VERSION_NAME} (${BuildConfig.VERSION_CODE})")
+                        val device = Uri.encode("${Build.MANUFACTURER} ${Build.MODEL}")
+                        val androidVersion = Uri.encode("${Build.ID} (${Build.DISPLAY})")
+                        val appSource = Uri.encode(
+                            when {
+                                BuildConfig.PLAY_BUILD -> "Play"
+                                else -> "GitHub"
+                            }
                        )
+                        val url = "https://github.com/kavishdevar/librepods/issues/new" +
+                            "?template=01-bug-report-android.yml" +
+                            "&app-source=$appSource" +
+                            "&app-version=$appVersion" +
+                            "&device=$device" +
+                            "&android-version=$androidVersion"
+
+                        val intent = Intent(Intent.ACTION_VIEW, url.toUri())
                        context.startActivity(intent)
                    },
                    independent = false
--- a/android/app/src/main/java/me/kavishdevar/librepods/presentation/screens/HeadTrackingScreen.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/presentation/screens/HeadTrackingScreen.kt
@@ -197,7 +197,7 @@ fun HeadTrackingScreen(viewModel: AirPodsViewModel, navController: NavController
                    label = "Head Gestures",
                    checked = state.headGesturesEnabled,
                    onCheckedChange = { viewModel.setHeadGesturesEnabled(it) },
-                    enabled = state.isPremium,
+                    enabled = state.isPremium || state.headGesturesEnabled,
                    description = stringResource(R.string.head_gestures_details)
                )

--- a/android/app/src/main/java/me/kavishdevar/librepods/presentation/viewmodel/AirPodsViewModel.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/presentation/viewmodel/AirPodsViewModel.kt
@@ -89,7 +89,11 @@ data class AirPodsUiState(
    val hearingAidData: ByteArray = byteArrayOf(),

    val isPremium: Boolean = false,
-    val vendorIdHook: Boolean = false
+    val vendorIdHook: Boolean = false,
+
+    val dynamicEndOfCharge: Boolean = false,
+
+    val connectionSuccessful: Boolean = false
 )

 class AirPodsViewModel(
@@ -268,9 +272,16 @@ class AirPodsViewModel(
                val current = state.controlStates[identifier]
                if (current?.contentEquals(value) == true) return@update state

-                state.copy(
-                    controlStates = state.controlStates + (identifier to value)
-                )
+                if (identifier == ControlCommandIdentifiers.DYNAMIC_END_OF_CHARGE) {
+                    state.copy(
+                        dynamicEndOfCharge = value[0] == 0x01.toByte(),
+                        controlStates = state.controlStates + (identifier to value)
+                    )
+                } else {
+                    state.copy(
+                        controlStates = state.controlStates + (identifier to value)
+                    )
+                }
            }
        }

@@ -305,6 +316,7 @@ class AirPodsViewModel(
            ControlCommandIdentifiers.AUTOMATIC_CONNECTION_CONFIG,
            ControlCommandIdentifiers.OWNS_CONNECTION,
            ControlCommandIdentifiers.PPE_TOGGLE_CONFIG,
+            ControlCommandIdentifiers.DYNAMIC_END_OF_CHARGE
        )
        for (identifier in identifiersList) {
            observeControl(identifier)
@@ -342,6 +354,9 @@ class AirPodsViewModel(
            ) ?: "CYCLE_NOISE_CONTROL_MODES"
        )
        val vendorIdHook = xposedRemotePref.getBoolean("vendor_id_hook", false)
+        val dynamicEndOfCharge = sharedPreferences.getBoolean("dynamic_end_of_charge", false)
+
+        val connectionSuccessful = sharedPreferences.getBoolean("connection_successful", false)

        _uiState.update {
            it.copy(
@@ -351,7 +366,9 @@ class AirPodsViewModel(
                headGesturesEnabled = headGesturesEnabled,
                leftAction = leftAction,
                rightAction = rightAction,
-                vendorIdHook = vendorIdHook
+                vendorIdHook = vendorIdHook,
+                dynamicEndOfCharge = dynamicEndOfCharge,
+                connectionSuccessful = connectionSuccessful
            )
        }
    }
@@ -371,6 +388,14 @@ class AirPodsViewModel(
        }
    }

+    fun setDynamicEndOfCharge(enabled: Boolean) {
+        service.aacpManager.sendControlCommand(ControlCommandIdentifiers.DYNAMIC_END_OF_CHARGE.value, enabled)
+        sharedPreferences.edit { putBoolean("dynamic_end_of_charge", enabled) }
+        _uiState.update {
+            it.copy(dynamicEndOfCharge = enabled)
+        }
+    }
+
    private fun loadControlList() {
        _uiState.update {
            it.copy(
--- a/android/app/src/main/java/me/kavishdevar/librepods/presentation/viewmodel/AppSettingsViewModel.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/presentation/viewmodel/AppSettingsViewModel.kt
@@ -32,7 +32,9 @@ data class AppSettingsUiState(
    val cameraPackageError: String? = null,
    val vendorIdHook: Boolean = false,
    val isPremium: Boolean = false,
-    val connectionSuccessful: Boolean = false
+    val connectionSuccessful: Boolean = false,
+    val showBottomSheetPopup: Boolean = true,
+    val showIslandPopup: Boolean = true
 )

 class AppSettingsViewModel(application: Application) : AndroidViewModel(application) {
@@ -86,7 +88,9 @@ class AppSettingsViewModel(application: Application) : AndroidViewModel(applicat
                conversationalAwarenessVolume = sharedPreferences.getInt("conversational_awareness_volume", 43).toFloat(),
                cameraPackageValue = sharedPreferences.getString("custom_camera_package", "") ?: "",
                vendorIdHook = xposedRemotePref.getBoolean("vendor_id_hook", false),
-                connectionSuccessful = sharedPreferences.getBoolean("connection_successful", false)
+                connectionSuccessful = sharedPreferences.getBoolean("connection_successful", false),
+                showBottomSheetPopup = sharedPreferences.getBoolean("show_bottom_sheet_popup", true),
+                showIslandPopup = sharedPreferences.getBoolean("show_island_popup", true)
            )
        }
    }
@@ -176,4 +180,14 @@ class AppSettingsViewModel(application: Application) : AndroidViewModel(applicat
        xposedRemotePref.putBoolean("vendor_id_hook", enabled)
        _uiState.update { it.copy(vendorIdHook = enabled) }
    }
+
+    fun setShowBottomSheetPopup(enabled: Boolean) {
+        sharedPreferences.edit { putBoolean("show_bottom_sheet_popup", enabled) }
+        _uiState.update { it.copy(showBottomSheetPopup = enabled) }
+    }
+
+    fun setShowIslandPopup(enabled: Boolean) {
+        sharedPreferences.edit { putBoolean("show_island_popup", enabled) }
+        _uiState.update { it.copy(showIslandPopup = enabled) }
+    }
 }
--- a/android/app/src/main/java/me/kavishdevar/librepods/services/AirPodsService.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/services/AirPodsService.kt
@@ -126,6 +126,7 @@ import me.kavishdevar.librepods.utils.SystemApisUtils.METADATA_UNTETHERED_RIGHT_
 import me.kavishdevar.librepods.utils.SystemApisUtils.METADATA_UNTETHERED_RIGHT_LOW_BATTERY_THRESHOLD
 import java.nio.ByteBuffer
 import java.nio.ByteOrder
+import java.time.LocalDateTime
 import kotlin.io.encoding.Base64
 import kotlin.io.encoding.ExperimentalEncodingApi

@@ -526,7 +527,7 @@ class AirPodsService : Service(), SharedPreferences.OnSharedPreferenceChangeList

        initializeConfig()

-        ancModeReceiver = object : BroadcastReceiver() {
+        externalBroadcastReceiver = object : BroadcastReceiver() {
            override fun onReceive(context: Context?, intent: Intent?) {
                if (intent?.action == "me.kavishdevar.librepods.SET_ANC_MODE") {
                    if (intent.hasExtra("mode")) {
@@ -555,15 +556,23 @@ class AirPodsService : Service(), SharedPreferences.OnSharedPreferenceChangeList
                            "Cycling ANC mode from $currentMode to $nextMode"
                        )
                    }
+                } else  if (intent?.action == "me.kavishdevar.librepods.CONVO_DETECT") {
+                    if (intent.hasExtra("enabled")) {
+                        val enabled = intent.getBooleanExtra("enabled", false)
+                        aacpManager.sendControlCommand(
+                            AACPManager.Companion.ControlCommandIdentifiers.CONVERSATION_DETECT_CONFIG.value,
+                            enabled
+                        )
+                    }
                }
            }
        }

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-            registerReceiver(ancModeReceiver, ancModeFilter, RECEIVER_EXPORTED)
+            registerReceiver(externalBroadcastReceiver, externalBroadcastFilter, RECEIVER_EXPORTED)
        } else {
            @Suppress("UnspecifiedRegisterReceiverFlag") registerReceiver(
-                ancModeReceiver, ancModeFilter
+                externalBroadcastReceiver, externalBroadcastFilter
            )
        }
        val audioManager = this@AirPodsService.getSystemService(AUDIO_SERVICE) as AudioManager
@@ -1636,6 +1645,9 @@ class AirPodsService : Service(), SharedPreferences.OnSharedPreferenceChangeList

    var popupShown = false
    fun showPopup(service: Service, name: String) {
+        if (!sharedPreferences.getBoolean("show_bottom_sheet_popup", true)) {
+            return
+        }
        if (!Settings.canDrawOverlays(service)) {
            Log.d(TAG, "No permission for SYSTEM_ALERT_WINDOW")
            return
@@ -1660,6 +1672,9 @@ class AirPodsService : Service(), SharedPreferences.OnSharedPreferenceChangeList
        otherDeviceName: String? = null
    ) {
        Log.d(TAG, "Showing island window")
+        if (!sharedPreferences.getBoolean("show_island_popup", true)) {
+            return
+        }
        if (!Settings.canDrawOverlays(service)) {
            Log.d(TAG, "No permission for SYSTEM_ALERT_WINDOW")
            return
@@ -2391,8 +2406,11 @@ class AirPodsService : Service(), SharedPreferences.OnSharedPreferenceChangeList
        }
    }

-    val ancModeFilter = IntentFilter("me.kavishdevar.librepods.SET_ANC_MODE")
-    var ancModeReceiver: BroadcastReceiver? = null
+    val externalBroadcastFilter = IntentFilter().apply {
+        addAction("me.kavishdevar.librepods.SET_ANC_MODE")
+        addAction("me.kavishdevar.librepods.CONVO_DETECT")
+    }
+    var externalBroadcastReceiver: BroadcastReceiver? = null

    @SuppressLint("InlinedApi", "MissingPermission", "UnspecifiedRegisterReceiverFlag")
    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
@@ -2695,6 +2713,14 @@ class AirPodsService : Service(), SharedPreferences.OnSharedPreferenceChangeList
                        )
                        Log.d(TAG, "<LogCollector:Complete:Success> Socket connected")
                        sharedPreferences.edit { putBoolean("connection_successful", true) }
+                        if (!sharedPreferences.contains("first_connection_successful_time")) {
+                            sharedPreferences.edit {
+                                putLong(
+                                    "first_connection_successful_time",
+                                    System.currentTimeMillis()
+                                )
+                            }
+                        }
                        sendBroadcast(Intent(AirPodsNotifications.AIRPODS_L2CAP_CONNECTED))
                    } catch (e: Exception) {
 //                        sharedPreferences.edit { putBoolean("connection_successful", false) }
@@ -3098,7 +3124,7 @@ class AirPodsService : Service(), SharedPreferences.OnSharedPreferenceChangeList
            e.printStackTrace()
        }
        try {
-            unregisterReceiver(ancModeReceiver)
+            unregisterReceiver(externalBroadcastReceiver)
        } catch (e: Exception) {
            e.printStackTrace()
        }
--- a/android/app/src/xposed/java/me/kavishdevar/librepods/utils/KotlinModule.kt
+++ b/android/app/src/xposed/java/me/kavishdevar/librepods/utils/KotlinModule.kt
--- a/android/app/src/main/java/me/kavishdevar/librepods/utils/RootlessSupport.kt
+++ b/android/app/src/main/java/me/kavishdevar/librepods/utils/RootlessSupport.kt
@@ -23,7 +23,7 @@ import android.os.Build

 fun isSupported(sharedPreferences: SharedPreferences): Boolean {
    val isPixel = Build.MANUFACTURER.lowercase() == "google"
-    val isOppoOrOnePlus = Build.MANUFACTURER.lowercase() in listOf("oneplus", "oppo")
+    val isOppoFamily = Build.MANUFACTURER.lowercase() in listOf("oneplus", "oppo", "realme")
    val isBypassFlagActive = sharedPreferences.getBoolean("bypass_device_check.v2", false)

    if (isBypassFlagActive) return true
@@ -31,14 +31,14 @@ fun isSupported(sharedPreferences: SharedPreferences): Boolean {
    if (isPixel) {
        when (Build.VERSION.SDK_INT) {
            36 -> {
-                return Build.ID == "CP1A.260305.018" || Build.ID == "CP1A.260405.005"
+                return Build.ID.startsWith("CP1A")
            }

            37 -> {
                return true
            }
        }
-    } else if (isOppoOrOnePlus) {
+    } else if (isOppoFamily) {
        return Build.VERSION.SDK_INT >= 36
    }
    return false
--- a/android/app/src/xposed/java/me/kavishdevar/librepods/utils/XposedServiceHolder.kt
+++ b/android/app/src/xposed/java/me/kavishdevar/librepods/utils/XposedServiceHolder.kt
--- a/android/app/src/main/res/values-de/strings.xml
+++ b/android/app/src/main/res/values-de/strings.xml
@@ -0,0 +1,7 @@
+<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="MissingTranslation">
+    <string name="popup_animations">Popup-Animationen</string>
+    <string name="show_bottom_sheet_popup">Popup unten</string>
+    <string name="show_bottom_sheet_popup_description">Zeigt das Popup im iOS-Stil unten an, wenn AirPods sich verbinden.</string>
+    <string name="show_island_popup">Dynamic Island Popup</string>
+    <string name="show_island_popup_description">Zeigt das Popup im Dynamic-Island-Stil oben für Verbindungs- und Übergabe-Ereignisse.</string>
+</resources>
--- a/android/app/src/main/res/values-es/strings.xml
+++ b/android/app/src/main/res/values-es/strings.xml
@@ -210,4 +210,9 @@
    <string name="listening_mode_transparency_description">Deja entrar los sonidos externos</string>
    <string name="listening_mode_adaptive_description">Ajuste dinámico del ruido externo</string>
    <string name="listening_mode_noise_cancellation_description">Bloquea los sonidos externos</string>
+    <string name="popup_animations">Animaciones emergentes</string>
+    <string name="show_bottom_sheet_popup">Ventana emergente inferior</string>
+    <string name="show_bottom_sheet_popup_description">Muestra la ventana emergente estilo iOS en la parte inferior cuando los AirPods se conectan.</string>
+    <string name="show_island_popup">Ventana emergente Dynamic Island</string>
+    <string name="show_island_popup_description">Muestra la ventana emergente estilo Dynamic Island en la parte superior para eventos de conexión y traspaso.</string>
 </resources>
--- a/android/app/src/main/res/values-fr/strings.xml
+++ b/android/app/src/main/res/values-fr/strings.xml
@@ -210,4 +210,9 @@
    <string name="listening_mode_transparency_description">Laisser entrer les sons extérieurs</string>
    <string name="listening_mode_adaptive_description">Ajuster dynamiquement les sons extérieurs</string>
    <string name="listening_mode_noise_cancellation_description">Bloquer les sons extérieurs</string>
+    <string name="popup_animations">Animations contextuelles</string>
+    <string name="show_bottom_sheet_popup">Fenêtre contextuelle en bas</string>
+    <string name="show_bottom_sheet_popup_description">Afficher la fenêtre contextuelle de style iOS en bas de l\'écran lors de la connexion des AirPods.</string>
+    <string name="show_island_popup">Fenêtre Dynamic Island</string>
+    <string name="show_island_popup_description">Afficher la fenêtre de style Dynamic Island en haut de l\'écran pour les événements de connexion et de transfert.</string>
 </resources>
--- a/android/app/src/main/res/values-pt/strings.xml
+++ b/android/app/src/main/res/values-pt/strings.xml
@@ -210,4 +210,9 @@
    <string name="listening_mode_transparency_description">Permite sons externos</string>
    <string name="listening_mode_adaptive_description">Ajusta dinamicamente o ruído externo</string>
    <string name="listening_mode_noise_cancellation_description">Bloqueia sons externos</string>
+    <string name="popup_animations">Animações de pop-up</string>
+    <string name="show_bottom_sheet_popup">Pop-up inferior</string>
+    <string name="show_bottom_sheet_popup_description">Exibe o pop-up estilo iOS na parte inferior quando os AirPods se conectam.</string>
+    <string name="show_island_popup">Pop-up Dynamic Island</string>
+    <string name="show_island_popup_description">Exibe o pop-up estilo Dynamic Island no topo da tela em eventos de conexão e transferência.</string>
 </resources>
--- a/android/app/src/main/res/values/strings.xml
+++ b/android/app/src/main/res/values/strings.xml
@@ -140,6 +140,11 @@
    <string name="widget">Widget</string>
    <string name="show_phone_battery_in_widget">Show phone battery in widget</string>
    <string name="show_phone_battery_in_widget_description">Display your phone\'s battery level in the widget alongside AirPods battery</string>
+    <string name="popup_animations">Popup Animations</string>
+    <string name="show_bottom_sheet_popup">Bottom sheet popup</string>
+    <string name="show_bottom_sheet_popup_description">Show the iOS-style modal popup at the bottom when AirPods connect.</string>
+    <string name="show_island_popup">Dynamic Island popup</string>
+    <string name="show_island_popup_description">Show the Dynamic Island-style popup at the top for connection and takeover events.</string>
    <string name="conversational_awareness_volume">Conversational Awareness Volume</string>
    <string name="quick_settings_tile">Quick Settings Tile</string>
    <string name="open_dialog_for_controlling">Open dialog for controlling</string>
@@ -247,7 +252,8 @@
        \n• Google Pixel® running 17 Beta 3 and above
        \n• OnePlus devices running OxygenOS 16 or later
        \n• Oppo devices running ColorOS 16 or later
-        \n\nFor details, see the project documentation.</string>
+        \n\nFor details, see the project documentation.
+    </string>
    <string name="name_your_own_price">(Name your own price)</string>
    <string name="compatibility_play_dialog_confirmation">
        This device may not be supported due to platform limitations and requires an Xposed framework. Tick the checkbox below and type OK to continue.
@@ -267,4 +273,7 @@
    <string name="app_enabled_in_xposed">App enabled in Xposed</string>
    <string name="subject">Subject</string>
    <string name="describe_your_issue">Describe your issue</string>
+    <string name="optimized_charging">Optimized Charge Limit</string>
+    <string name="optimized_charging_description">AirPods can learn from your daily usage and determine when to charge to an optmized limit and when to allow or full charge. This limit adapts to your daily usage and preserves your battery lifespan over time.\nThis setting may not affect unsupported AirPods, or AirPods on an older firmware version.</string>
+    <string name="enable_app_in_xposed_or_update_device">Enable LibrePods in Xposed or update your device to proceed.</string>
 </resources>
--- a/android/app/src/xposed/resources/META-INF/xposed/java_init.list
+++ b/android/app/src/xposed/resources/META-INF/xposed/java_init.list
--- a/android/app/src/xposed/resources/META-INF/xposed/module.prop
+++ b/android/app/src/xposed/resources/META-INF/xposed/module.prop
--- a/android/app/src/xposed/resources/META-INF/xposed/native_init.list
+++ b/android/app/src/xposed/resources/META-INF/xposed/native_init.list
--- a/android/app/src/xposed/resources/META-INF/xposed/scope.list
+++ b/android/app/src/xposed/resources/META-INF/xposed/scope.list
--- a/android/app/src/normal/java/me/kavishdevar/librepods/LibrePodsApplication.kt
+++ b/android/app/src/normal/java/me/kavishdevar/librepods/LibrePodsApplication.kt
@@ -1,21 +0,0 @@
-package me.kavishdevar.librepods
-
-import android.app.Application
-import androidx.lifecycle.DefaultLifecycleObserver
-import androidx.lifecycle.LifecycleOwner
-import androidx.lifecycle.ProcessLifecycleOwner
-import me.kavishdevar.librepods.billing.BillingManager
-import me.kavishdevar.librepods.billing.BillingProviderFactory
-
-class LibrePodsApplication: Application(), DefaultLifecycleObserver {
-    override fun onCreate() {
-        BillingManager.provider = BillingProviderFactory.create(this)
-        ProcessLifecycleOwner.get().lifecycle.addObserver(this)
-
-        super<Application>.onCreate()
-    }
-
-    override fun onResume(owner: LifecycleOwner) {
-        BillingManager.provider.queryPurchases()
-    }
-}
--- a/android/app/src/normal/java/me/kavishdevar/librepods/data/XposedRemotePrefImpl.kt
+++ b/android/app/src/normal/java/me/kavishdevar/librepods/data/XposedRemotePrefImpl.kt
@@ -1,11 +0,0 @@
-package me.kavishdevar.librepods.data
-
-class XposedRemotePrefImpl: XposedRemotePref {
-    override fun isAvailable(): Boolean { return false }
-
-    override fun getBoolean(key: String, def: Boolean): Boolean {
-        return false
-    }
-
-    override fun putBoolean(key: String, value: Boolean) { }
-}
--- a/android/gradle/libs.versions.toml
+++ b/android/gradle/libs.versions.toml
@@ -1,24 +1,25 @@
 [versions]
 accompanistPermissions = "0.37.3"
-agp = "9.1.0"
-kotlin = "2.3.20"
+agp = "9.1.1"
+kotlin = "2.3.21"
 coreKtx = "1.18.0"
 lifecycleRuntimeKtx = "2.10.0"
 activityCompose = "1.13.0"
-composeBom = "2026.03.01"
+composeBom = "2026.05.00"
 annotations = "26.1.0"
-navigationCompose = "2.9.7"
+navigationCompose = "2.9.8"
 constraintlayout = "2.2.1"
 haze = "1.7.2"
 hazeMaterials = "1.7.2"
 dynamicanimation = "1.1.0"
-aboutLibraries = "14.0.1"
+aboutLibraries = "14.2.0"
 materialIconsCore = "1.7.8"
 backdrop = "2.0.0-alpha03"
 billing = "8.3.0"
 hilt = "2.59.2"
 xposed = "101.0.0"
 lifecycleProcess = "2.10.0"
+play = "2.0.2"

 [libraries]
 accompanist-permissions = { module = "com.google.accompanist:accompanist-permissions", version.ref = "accompanistPermissions" }
@@ -49,6 +50,8 @@ hilt-compiler = { group = "com.google.dagger", name = "hilt-compiler", version.r
 libxposed-api = { group = "io.github.libxposed", name = "api", version.ref = "xposed" }
 libxposed-service = { group = "io.github.libxposed", name = "service", version.ref = "xposed" }
 androidx-lifecycle-process = { group = "androidx.lifecycle", name = "lifecycle-process", version.ref = "lifecycleProcess" }
+play-review = { group = "com.google.android.play", name="review", version.ref = "play" }
+play-review-ktx = { group = "com.google.android.play", name="review-ktx", version.ref = "play" }

 [plugins]
 android-application = { id = "com.android.application", version.ref = "agp" }
--- a/extras/update_nonpatch.json
+++ b/extras/update_nonpatch.json
@@ -1,6 +1,6 @@
 {
  "version": "v0.2.6",
  "versionCode": 46,
-  "zipUrl": "https://github.com/kavishdevar/librepods/releases/download/v0.2.3/LibrePods-FOSS-v0.2.3-release.zip",
-  "changelog": "https://raw.githubusercontent.com/kavishdevar/librepods/main/CHANGELOG.md"
-}
+  "zipUrl": "https://github.com/kavishdevar/librepods/releases/download/v0.2.6/LibrePods-FOSS-v0.2.6-release.zip",
+  "changelog": "https://raw.githubusercontent.com/kavishdevar/librepods/main/extras/CHANGELOG.md"
+}
--- a/imgs/banner-dark.png
+++ b/imgs/banner-dark.png
--- a/linux/README.md
+++ b/linux/README.md
@@ -1,3 +1,26 @@
+# LibrePods on Linux
+
+A new rewrite is being worked upon. Please look at the list of features in the root README to see what's supported in the new version. 
+
+The rewrite can be found in the `linux/rust` branch [here](https://github.com/kavishdevar/librepods/tree/linux/rust/linux-rust). Follow the development in [PR #241](https://github.com/kavishdevar/librepods/pull/241). 
+
+
+## Installation
+
+### GitHub Releases
+
+The app is ready to download as an AppImage or an executable. You can download the latest pre-release from the [GitHub releases](https://github.com/kavishdevar/librepods/releases?q="linux-v0").
+
+### Nightly Builds (recommended)
+
+You can also try the latest build of the new version from the [GitHub Actions artifacts](https://github.com/kavishdevar/librepods/actions/workflows/ci-linux-rust.yml). On the latest successful workflow run, download the **librepods-x86_64.AppImage** or **librepods** binary from **Artifacts**.
+
+
+![new version screenshot](https://github.com/user-attachments/assets/86b3c871-89a8-4e49-861a-5119de1e1d28)
+
+<details>
+  <summary>README for the old version</summary>
+
 # LibrePods Linux

 ![screenshot](imgs/main-app.png)
@@ -189,3 +212,5 @@ It is possible that the AirPods disconnect after a short period of time and play
 ### Why a separate script?

 Because I discovered that QBluetooth doesn't support connecting to a socket with its PSM, only a UUID can be used. I could add a dependency on BlueZ, but then having two bluetooth interfaces seems unnecessary. So, I decided to use a separate script for hearing aid features. In the future, QBluetooth will be replaced with BlueZ native calls, and then everything will be in one application.
+
+</details>
--- a/root-module-manual/.gitignore
+++ b/root-module-manual/.gitignore
@@ -1 +0,0 @@
-system/
--- a/root-module-manual/system/etc/permissions/privapp-permissions-librepods.xml
+++ b/root-module-manual/system/etc/permissions/privapp-permissions-librepods.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<permissions>
+    <privapp-permissions package="me.kavishdevar.librepods">
+        <permission name="android.permission.BLUETOOTH_PRIVILEGED"/>
+        <permission name="android.permission.MODIFY_PHONE_STATE"/>
+        <permission name="android.permission.INTERACT_ACROSS_USERS"/>
+        <permission name="android.permission.LOCAL_MAC_ADDRESS"/>
+    </privapp-permissions>
+</permissions>
Author	SHA1	Message	Date
Kavish Devar	0101428108	docs: add screenshots header to android README	2026-05-16 00:11:49 +05:30
Kavish Devar	37c1837d0b	docs: fix badge label encoding in README	2026-05-15 23:42:41 +05:30
Kavish Devar	154ed17c05	docs: update README	2026-05-15 23:36:11 +05:30
Kavish Devar	362e34202a	ci: rename linux ci	2026-05-15 22:25:31 +05:30
Kavish Devar	5bc5079e13	update android bug report template	2026-05-11 22:12:39 +05:30
Kavish Devar	64d233d427	android: use issue template	2026-05-11 22:10:14 +05:30
Kavish Devar	ea2c2b811b	update app source options	2026-05-11 21:55:25 +05:30
Kavish Devar	6f28df734e	ci: build only unsigned debug apks on PR	2026-05-11 21:48:27 +05:30
Kavish Devar	c15e15a6b7	update app source options in android bug report template	2026-05-11 21:44:35 +05:30
thisisAcidic	75a52cdfd7	add GitHub issue templates (#565 ) * chore: add GitHub issue templates for Android, Linux, and feature requests * remove btl2capfix module option and add instructions for logs Updated bug report template for Android to clarify logging instructions and options for rooted devices. * Refine Linux bug report template details Updated labels and descriptions for clarity in the bug report template. --------- Co-authored-by: Kavish Devar <mail@kavishdevar.me>	2026-05-11 21:35:04 +05:30
Kavish Devar	d1b32d5a00	android: add permissions file to root module	2026-05-10 15:41:35 +05:30
Kavish Devar	044aff731f	android: keep only xposed flavor also changed Build.ID check to startsWith("CP1A")	2026-05-07 21:12:10 +05:30
Kavish Devar	216c97f9ca	android: add CP1A.260505.005 to comptible build ids on Pixel	2026-05-06 17:29:23 +05:30
Kavish Devar	fd3774b513	android: bump version	2026-05-05 13:18:08 +05:30
Kavish Devar	b7336940e6	android: add convo detect broadcast	2026-05-05 13:17:31 +05:30
Kavish Devar	b2ba830a80	android: hide reconnect when app hasn't connected once	2026-05-05 13:11:50 +05:30
Kavish Devar	f08769e62f	android: add optmized charge limit config	2026-05-05 13:05:54 +05:30
thisisAcidic	d1933c3b67	android: add popup toggles (#561 ) * android: add toggles to disable bottom sheet and dynamic island popups * android: translations for popup customization (de, es, fr, pt)	2026-05-05 12:48:22 +05:30
thisisAcidic	fb44f01ac0	android: allow non-premium users to disable head gestures (#564 )	2026-05-03 01:41:23 +05:30
thisisAcidic	93a93cbe68	fix: sync magisk update json with current release URLs (#563 )	2026-05-03 00:59:43 +05:30
Nikhil Maddirala	a4898293b8	docs: update readme root requirements (#557 ) * Update readme root requirements Clarified root requirements for LibrePods depending on device/OS and features needed. * Revise Xposed workaround note in README Updated warning about Xposed/LSPosed workaround for compatibility.	2026-05-01 20:06:42 +05:30