a few small changes

Author: kavishdevar

.github/workflows/ci.yml

@@ -47,7 +47,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/download-artifact@v4
       - name: Export APK_NAME for later use
-        run: echo "APK_NAME=ALN-$(echo ${{ github.sha }} | cut -c1-7).apk" >> $GITHUB_ENV
+        run: echo "APK_NAME=LibrePods-$(echo ${{ github.sha }} | cut -c1-7).apk" >> $GITHUB_ENV
       - name: Rename .apk file
         run: mv "./Debug APK/debug/"*.apk "./$APK_NAME"
       - name: Decode keystore file

AAP Definitions.md

@@ -429,8 +429,8 @@ Once tracking is active, the AirPods stream sensor packets with the following co
 
 # LICENSE
 
-AirPods like Normal (ALN) - Bringing Apple-only features to Linux and Android for seamless AirPods functionality!
-Copyright (C) 2024 Kavish Devar
+LibrePods - AirPods liberated from Apple’s ecosystem
+Copyright (C) 2025 LibrePods contributors
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as published

CHANGELOG.md

@@ -1,4 +1,4 @@
 ## btl2capfix v0.0.3
-- ([#34](https://github.com/kavishdevar/aln/pull/34)) @devnoname120 Add on-device libbluetooth patcher using a Magisk/KernelSU module (arm64-only)
+- ([#34](https://github.com/kavishdevar/librepods/pull/34)) @devnoname120 Add on-device libbluetooth patcher using a Magisk/KernelSU module (arm64-only)
 
-_[See more here](https://github.com/kavishdevar/aln/releases)_
+_[See more here](https://github.com/kavishdevar/librepods/releases)_

CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Welcome to AirPods Like Normal contributing guide <!-- omit in toc -->
+# Welcome to LibrePods contributing guide <!-- omit in toc -->
 
-Thank you for considering a contribution to AirPods Like Normal! Your support helps bring Apple-exclusive AirPods features to Linux and Android.
+Thank you for considering a contribution to LibrePods! Your support helps bring Apple-exclusive AirPods features to Linux and Android.
 
 Read our [Code of Conduct](./CODE_OF_CONDUCT.md) to keep our community approachable and respectful.
 
@@ -25,19 +25,19 @@ To develop for the Android App, Android Studio is the preferred IDE. And you can
 
 #### Create a new issue
 
-If you find a bug or want to suggest a feature, check if an issue already exists by searching through our [existing issues](https://github.com/kavishdevar/aln/issues). If no relevant issue exists, open a new one and fill in the details.
+If you find a bug or want to suggest a feature, check if an issue already exists by searching through our [existing issues](https://github.com/kavishdevar/librepods/issues). If no relevant issue exists, open a new one and fill in the details.
 
 #### Solve an issue
 
-Browse our [issues list](https://github.com/kavishdevar/aln/issues) to find an interesting issue to work on. Use labels to filter issues and pick one that matches your expertise. If you’d like to work on an issue, open a PR with your solution.
+Browse our [issues list](https://github.com/kavishdevar/librepods/issues) to find an interesting issue to work on. Use labels to filter issues and pick one that matches your expertise. If you’d like to work on an issue, open a PR with your solution.
 
 ### Make Changes
 
 #### Make changes locally
 
 1. Fork the repository and clone it to your local environment.
 ```
-git clone https://github.com/kavishdevar/aln.git
+git clone https://github.com/kavishdevar/librepods.git
 cd AirPods-Like-Normal
 ```
 2. Create a working branch to start your changes.
@@ -67,4 +67,4 @@ Once your PR is open, a team member will review it. They may ask questions or re
 
 ### Your PR is merged!
 
-Congratulations! :tada: Once merged, your contributions will be publicly available in AirPodsLikeNormal.
+Congratulations! :tada: Once merged, your contributions will be publicly available in LibrePods.

README.md

@@ -1,47 +1,58 @@
-# ALN - AirPodsLikeNormal
-*Bringing AirPods' Apple-exclusive features on linux and android!*
+# LibrePods
 
-## [XDAForums Thread](https://xdaforums.com/t/app-root-for-now-airpodslikenormal-unlock-apple-exclusive-airpods-features-on-android.4707585/)
+![LibrePods Banner](/imgs/banner.png)
 
-## Tested device(s)
-- AirPods Pro 2
+*AirPods liberated from Apple's ecosystem*
 
-Other devices might work too. Features like ear detection and battery should be available for any AirPods! Although the app will show unsupported features/settings. I will not be able test any other devices than the ones I already have (i.e. the AirPods Pro 2).
+[![XDA Thread](https://img.shields.io/badge/XDA_Forums-Thread-orange)](https://xdaforums.com/t/app-root-for-now-airpodslikenormal-unlock-apple-exclusive-airpods-features-on-android.4707585/)
 
-## Features
+## What is LibrePods?
 
-Check the [pinned issue](https://github.com/kavishdevar/aln/issues/20) for a list. 
+LibrePods unlocks Apple's exclusive AirPods features on non-Apple devices. Get access to noise control modes, adaptive transparency, ear detection, battery status, and more - all the premium features you paid for but Apple locked to their ecosystem.
 
+## Device Compatibility
 
-## CrossDevice Stuff
+| Status | Device | Features |
+|--------|--------|----------|
+| ✅ | AirPods Pro (2nd Gen) | Fully supported and tested |
+| ⚠️ | Other AirPods models | Basic features (battery status, ear detection) should work |
 
-> [!IMPORTANT]
-> This feature is still in development and might not work as expected. No support is provided for this feature.
+Most features should work with any AirPods. Currently, testing is only performed with AirPods Pro 2.
 
-### Features
+## Key Features
 
-- **Battery Status**: Get battery status on any device when you connect your AirPods to one of them.
-- **Control AirPods**: Control your AirPods from either of your device when you connect to one, like changing the noise control mode, toggling conversational awareness, and more.
-- **Automatic Device Switching**: Automatically switch between your Linux and Android device, like when you receive a call, start playing music on Android while you're connected to Linux, and more!
+- **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
+- **Other customizations**:
+  - Rename your AirPods
+  - Customize long-press actions
+  - Few accessibility features
+  - And more!
 
-Check out the demo below!
+See our [pinned issue](https://github.com/kavishdevar/librepods/issues/20) for a complete feature list and roadmap.
 
-https://github.com/user-attachments/assets/d08f8a51-cd52-458b-8e55-9b44f4d5f3ab
+## Platform Support
 
+### Linux
 
-## Linux
+The Linux version runs as a system tray app. Connect your AirPods and enjoy:
 
-The Linux version is a simple tray-app, with a modern and adaptive ui. Still WIP, but most things work (battery, ear-detection, auto-pause, rename, etc.)
+- Battery monitoring
+- Ear detection with auto-pause
+- Device renaming
+- Media controls
 
-Check out the README file in [linux](/linux) folder for more info.
+> [!NOTE]
+> Work in progress, but core functionality is stable and usable.
 
-## Android
+For installation and detailed info, see the [Linux README](/linux/README.md).
 
-> Can I use aln without root?
+### Android
 
-**No, it's not possible to use aln without root.** You will have to root your device if you want to use aln, and there is no way around it. **No exceptions.**
-
-### Screenshots
+#### Screenshots
 
 | | | |
 |-------------------|-------------------|-------------------|
@@ -50,46 +61,75 @@ Check out the README file in [linux](/linux) folder for more info.
 | ![Long Press Configuration](/android/imgs/long-press.png) | ![Widget](/android/imgs/widget.png) | ![Customizations](/android/imgs/customizations.png) |
 | ![audio-popup](/android/imgs/audio-connected-island.png) | | |
 
-### Installation
-
-Currently, there's a [bug in the Android Bluetooth stack](https://issuetracker.google.com/issues/371713238) that prevents the app from working (upvote the issue - click the '+1' icon on the top right corner of IssueTracker).
+#### Root Requirement
 
 > [!CAUTION]
-> Until Google merges the fix **you will only be able to use aln if you are rooted**. There are **no exceptions**, don't ask about it.
+> **You must have a rooted device to use LibrePods on Android.** This is due to a [bug in the Android Bluetooth stack](https://issuetracker.google.com/issues/371713238). Please upvote the issue by clicking the '+1' icon on the IssueTracker page.
+> 
+> There are **no exceptions** to the root requirement until Google merges the fix.
 
-In order to use aln you will have to install the module using your favorite root manager in OverlayFS mode (KernelSU, Apatch, or Magisk). If you don't know what this means, no support is provided: you will have to search by yourself on Google or ask in some Android rooting communities on Telegram. 
+#### Installation Methods
 
-The module to install is available in the releases section under the name `btl2capfix.zip`.
+##### Method 1: Xposed Module (Recommended)
+This method is less intrusive and should be tried first:
 
-### Android – features
+1. Install LSPosed, or another Xposed provider on your rooted device
+2. Download the LibrePods app from the releases section, and install it.
+3. Enable the Xposed module for the bluetooth app in your Xposed manager
+4. Follow the instructions in the app to set up the module.
+5. Open the app and connect your AirPods
 
-#### Renaming the Airpods
-When you rename the Airpods using the app, you'll need to re-pair it with your phone. Currently, user-level apps cannot directly rename a Bluetooth device. After re-pairing, your phone will display the updated name!
+##### Method 2: Root Module (Backup Option)
+If the Xposed method doesn't work for you:
 
-#### Noise Control Modes
+1. Download the `btl2capfix.zip` module from the releases section
+2. Install it using your preferred root manager (KernelSU, Apatch, or Magisk).
+3. Reboot your device
+4. Connect your AirPods
 
-- Active Noise Cancellation (ANC): Blocks external sounds using microphones and advanced algorithms for an immersive audio experience; ideal for noisy environments.
-- Transparency Mode: Allows external sounds to blend with audio for situational awareness; best for environments where you need to stay alert.
-- Off Mode: Disables noise control for a natural listening experience, conserving battery in quiet settings.
-- Adaptive Transparency: Dynamically reduces sudden loud noises while maintaining environmental awareness, adjusting seamlessly to fluctuating noise levels.
+##### Method 3: Patching it yourself
+If you prefer to patch the Bluetooth stack yourself, follow these steps:
 
-> [!IMPORTANT]
-> Due to recent AirPods' firmware upgrades, you must enable `Off listening mode` to switch to `Off`. This is because in this mode, louds sounds are not reduced!
+1. Look for the library in use by running `lsof | grep libbluetooth`
+2. Find the library path (e.g., `/system/lib64/libbluetooth_jni.so`)
+3. Find the `l2c_fcr_chk_chan_modes` function in the library
+4. Patch the function to always return `1` (true)
+5. Repack the library and push it back to the device. You can do this by creating a root module yourself.
+6. Reboot your device
+
+If you're unfamiliar with these steps, search for tutorials online or ask in Android rooting communities.
+
+#### 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, louds sounds are not reduced!
 
-#### Conversational Awareness
+- 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.
 
-Automatically lowers audio volume and enhances voices when you start speaking, making it easier to engage in conversations without removing your AirPods.
+- 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.
 
-#### Automatic Ear Detection
+## Development Resources
 
-Recognizes when the AirPods are in your ears to automatically play or pause audio and adjust functionality accordingly.
+For developers interested in the protocol details, check out the [AAP Definitions](/AAP%20Definitions.md) documentation.
 
-## Check out the packet definitions at [AAP Definitions](/AAP%20Definitions.md)
+## CrossDevice Stuff
+
+> [!IMPORTANT]
+> This feature is still in early development and might not work as expected. No support is provided for this feature yet.
+
+### Features in Development
+
+- **Battery Status Sync**: Get battery status on any device when you connect your AirPods to one of them
+- **Cross-device Controls**: Control your AirPods from either device when connected to one
+- **Automatic Device Switching**: Seamlessly switch between Linux and Android devices based on active audio sources
+
+Check out the demo below:
+
+https://github.com/user-attachments/assets/d08f8a51-cd52-458b-8e55-9b44f4d5f3ab
 
 # License
 
-AirPodsLikeNormal (ALN) - Bringing Apple-only features to Linux and Android for seamless AirPods functionality!
-Copyright (C) 2024 Kavish Devar
+LibrePods - AirPods liberated from Apple’s ecosystem
+Copyright (C) 2025 LibrePods contributors
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as published

android/app/build.gradle.kts

@@ -6,21 +6,15 @@ plugins {
 }
 
 android {
-    namespace = "me.kavishdevar.aln"
+    namespace = "me.kavishdevar.librepods"
     compileSdk = 35
 
     defaultConfig {
-        applicationId = "me.kavishdevar.aln"
+        applicationId = "me.kavishdevar.librepods"
         minSdk = 28
         targetSdk = 35
-        versionCode = 3
-        versionName = "0.0.3"
-
-        externalNativeBuild {
-            cmake {
-                cppFlags += ""
-            }
-        }
+        versionCode = 4
+        versionName = "0.1.0"
     }
 
     buildTypes {

android/app/src/main/AndroidManifest.xml

@@ -5,6 +5,8 @@
     <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE" />
+    <uses-permission android:name="android.permission.INTERACT_ACROSS_USERS"
+        tools:ignore="ProtectedPermissions" />
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
     <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
     <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
@@ -37,7 +39,7 @@
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
-        android:theme="@style/Theme.ALN"
+        android:theme="@style/Theme.LibrePods"
         tools:ignore="UnusedAttribute"
         tools:targetApi="31">
         <receiver
@@ -67,22 +69,31 @@
             android:name=".CustomDevice"
             android:exported="true"
             android:label="@string/title_activity_custom_device"
-            android:theme="@style/Theme.ALN">
+            android:theme="@style/Theme.LibrePods">
             <intent-filter>
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity
             android:name=".MainActivity"
             android:exported="true"
-            android:theme="@style/Theme.ALN">
+            android:theme="@style/Theme.LibrePods">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
 
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
 
+        <activity
+            android:name=".QuickSettingsDialogActivity"
+            android:exported="false"
+            android:theme="@style/Theme.TransparentDialog"
+            android:launchMode="singleTask"
+            android:excludeFromRecents="true"
+            android:taskAffinity=""
+             />
+
         <service
             android:name=".services.AirPodsService"
             android:enabled="true"