Skip to content

Commit a489829

Browse files
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.
1 parent 845f261 commit a489829

1 file changed

Lines changed: 4 additions & 8 deletions

File tree

README.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -76,19 +76,15 @@ https://github.com/user-attachments/assets/43911243-0576-4093-8c55-89c1db5ea533
7676

7777
### Root Requirement
7878

79-
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.
79+
LibrePods **may** require root depending on your device/OS and what features you want access to:
8080

81-
[https://issuetracker.google.com/issues/371713238](https://issuetracker.google.com/issues/371713238)
82-
83-
Please do not comment in the thread. The issue has already been resolved and should be available in Android 17 for all devices.
84-
85-
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.
81+
- 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.
82+
- On **ColorOS/OxygenOS 16** and **Pixel devices on Android 16 QPR3** (with the latest Google Play system update), LibrePods does not need root for most features (except those requiring the VendorID hook mentioned above).
83+
- 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.
8684

8785
> [!IMPORTANT]
8886
> This workaround with Xposed is not guaranteed to work on all devices.
8987
90-
Features requiring the VendorID hook will still require root. These features include customizing transparency mode, setting up hearing aid, and use Bluetooth Multipoint.
91-
9288
### Troubleshooting steps for common errors
9389
- Ensure the correct scope is set in LSPosed/Vector.
9490
- Ensure there is no root-hiding module preventing the hook from loading on the Bluetooth app.

0 commit comments

Comments
 (0)