Skip to content

Commit c93b5e2

Browse files
authored
update workaround instructions and feature list
1 parent 2550aec commit c93b5e2

File tree

1 file changed

+9
-58
lines changed

1 file changed

+9
-58
lines changed

README.md

Lines changed: 9 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,10 @@
88

99
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).
1010

11-
## Implemented Features
11+
## Features
1212

13-
| Feature | Linux | Android |
14-
| --- | --- | --- |
15-
| Ear Detection |||
16-
| Battery Levels |||
17-
| Conversational Awareness |||
18-
| Changing Noise Control modes |||
19-
| Configure AirPods' Settings |||
20-
| Popup |||
13+
Check the [pinned issue](https://github.com/kavishdevar/aln/issues/20) for a list.
2114

22-
> [!NOTE]
23-
> This just includes features that are already implemented for at least one of the platforms. There is no list for any planned features.
2415

2516
## Linux — Deprecated, awaiting a rewrite!
2617
ANY ISSUES ABOUT THE LINUX VERSION WILL BE CLOSED.
@@ -43,55 +34,15 @@ This tray app communicates with a daemon with the help of a UNIX socket. The dae
4334

4435
### Installation
4536

46-
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). This repository provides a workaround for the bug, specifically for Android 14 QPR3 and Android 15 initial release and the QPR1 update (stock versions).
37+
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). This project provides a root module which patches the bug.
4738

4839
> [!CAUTION]
49-
> **This workaround requires root access** to implement and it might not work on other android OEM skins. Try at your own risk!!
50-
51-
### Workaround
52-
53-
#### Step 1: Download the Required Files
54-
- Go to the [first release](https://github.com/kavishdevar/aln/releases/tag/v0.0.1).
55-
- Download the required files depending upon your Android version - `bt.sh`, `module.prop`, and `libbluetooth_jni-a14.so` (for android 14) or `libbluetooth_jni-a15.so` (for android 15).
56-
57-
#### Step 2: Set Up the Directory Structure
58-
59-
- Use a file manager with root access (eg. Solid FIle Explorer or MT manager) or a shell (using adb, or a terminal app like Termux) and create a folder structure like this (`upper` and `work` are also folders):
60-
61-
```
62-
/data/local/tmp/overlay:
63-
upper
64-
work
65-
```
66-
- Rename the appropriate file to `libbluetooth_jni.so` and place it in the `upper` folder
67-
```
68-
/data/local/tmp/overlay/upper:
69-
libbluetooth_jni.so
70-
```
71-
- Create a duplicate of the overlay folder inside tmp and name it overlay2.
72-
73-
#### Step 3: Add the Boot Script
74-
75-
- Place the `bt.sh` script in `/data/adb/post-fs-data.d/`.
76-
- This script ensures the fix is applied during system startup.
77-
78-
#### Step 4: Create a Magisk Module
79-
- Create a `btl2capfix` folder in `/data/adb/modules/` and copy the `module.prop`into the folder.
80-
```
81-
/data/adb/modules/btl2capfix:
82-
module.prop
83-
```
84-
- Create `system/lib64` under `btl2capfix` and copy the `libbluetooth_jni.so` into `lib64`
85-
```
86-
/data/adb/modules/btl2capfix/system/lib64:
87-
libbluetooth_jni.so
88-
```
89-
90-
#### Step 5: Verify the Fix
91-
- Reboot your device.
92-
- The Bluetooth bug should now be resolved.
93-
94-
Once the issue is resolved by Google developers or you've addressed it through the above root-based method, download and install the `app-release.apk` from the releases, and you're good to go!
40+
> **This workaround requires root access.** Try at your own risk.
41+
42+
To install it, just download the `btl2capfix.zip` from the latest release and install it from your root manager app.
43+
44+
Tested with
45+
- KernelSU
9546

9647
### Features
9748

0 commit comments

Comments
 (0)