Repolode
Submit
librepods-org

librepods-org/librepods

Open-source app that unlocks AirPods features like noise control, ear detection and battery status on Linux and Android.

Open-source alternative to:Apple AirPods app

View on GitHub
Stars
30,388
Forks
1,804
Open issues
324
Last commit
4 days ago

What is it?

LibrePods implements the proprietary protocol AirPods use to talk to Apple devices, bringing features that are normally exclusive to Apple hardware to non-Apple platforms. Supported capabilities include switching listening and noise control modes, ear detection, accurate battery readings, renaming AirPods, automatic connection, and conversational awareness. The Android app also supports head gestures and a range of press, swipe and call-control settings.

The Linux and Android versions differ in coverage. Hearing aid settings, transparency mode customization and heart rate monitoring are available on Android, with some items still experimental or planned for Linux. Some features require enabling VendorID spoofing, which makes the device report itself as an Apple device and is noted as a use-at-your-own-risk option. Spatial audio head tracking and Find My integration are listed as unknown or unexplored.

The project is licensed under GPL-3.0 and is developed by the LibrePods contributors, who document the protocol reverse engineering work openly.

Key features

  • 01Switch AirPods listening and noise control modes from Linux or Android.
  • 02Detect when AirPods are in or out of the ear.
  • 03Show battery status for AirPods.
  • 04Automatically connect to AirPods and rename them.
  • 05Enable conversational awareness and configurable press and swipe gestures on Android.
  • 06Customize hearing aid settings from the Android app.

Use cases

  • Using AirPods with a Linux desktop and wanting battery and noise control access.
  • Getting Apple-only AirPods features on an Android phone.
  • Experimenting with Bluetooth protocol reverse engineering on AirPods.

Quick start

  1. 1

    Open the Android installation guide from the README

  2. 2

    Open the Linux installation guide from the README

Things to know

  • Several features are not implemented on Linux, such as Head Gestures, Hearing Aid and Transparency Mode customization.
  • Some features require VendorID spoofing, which the README says is used at your own risk.
  • Several features are experimental, planned, or unknown, including Find My, Spatial Audio and two-way audio.
  • Some Android features need Xposed or root access.

Topics

#airpods#bluetooth#android#linux#reverse-engineering#accessibility#hearing-aid#accessiblity#battery-monitor#conversational-awareness

FAQ

What is librepods?
Open-source app that unlocks AirPods features like noise control, ear detection and battery status on Linux and Android. LibrePods implements the proprietary protocol AirPods use to talk to Apple devices, bringing features that are normally exclusive to Apple hardware to non-Apple platforms. Supported capabilities include switching listening and noise control modes, ear detection, accurate battery readings, renaming AirPods, automatic connection, and conversational awareness. The Android app also supports head gestures and a range of press, swipe and call-control settings.
Is librepods free to use? What license does it have?
librepods is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is librepods still maintained?
Actively maintained. The last commit to librepods was on Oct 17, 2026.
What can I use librepods for?
Using AirPods with a Linux desktop and wanting battery and noise control access. Getting Apple-only AirPods features on an Android phone. Experimenting with Bluetooth protocol reverse engineering on AirPods.
How do I install librepods?
Open the Android installation guide from the README Open the Linux installation guide from the README
Where can I get librepods?
The source code and installation instructions are on GitHub: https://github.com/librepods-org/librepods

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects