librepods/linux/README.md

LibrePods Linux

A native Linux application to control your AirPods, with support for:

• Noise Control modes (Off, Transparency, Adaptive, Noise Cancellation)
• Conversational Awareness
• Battery monitoring
• Auto play/pause on ear detection
• Seamless handoff between phone and PC

Prerequisites

1. Your phone's Bluetooth MAC address (can be found in Settings > About Device)

2. Qt6 packages

   # For Arch Linux / EndeavourOS
   sudo pacman -S qt6-base qt6-connectivity qt6-multimedia-ffmpeg qt6-multimedia
   
   # For Debian
   sudo apt-get install qt6-base-dev qt6-declarative-dev qt6-connectivity-dev qt6-multimedia-dev \
        qml6-module-qtquick-controls qml6-module-qtqml-workerscript qml6-module-qtquick-templates \
        qml6-module-qtquick-window qml6-module-qtquick-layouts
   
    # For Fedora
    sudo dnf install qt6-qtbase-devel qt6-qtconnectivity-devel \
        qt6-qtmultimedia-devel qt6-qtdeclarative-devel
   

3. OpenSSL development headers

   # On Arch Linux / EndevaourOS, these are included in the OpenSSL package, so you might already have them installed.
   sudo pacman -S openssl
   
   # For Debian / Ubuntu
   sudo apt-get install libssl-dev
   
   # For Fedora
   sudo dnf install openssl-devel
   

Setup

1. Set the PHONE_MAC_ADDRESS environment variable to your phone's Bluetooth MAC address by running the following:

   export PHONE_MAC_ADDRESS="XX:XX:XX:XX:XX:XX"  # Replace with your phone's MAC
   

2. Build the application:

   mkdir build
   cd build
   cmake ..
   make -j $(nproc)
   

3. Run the application:

   ./librepods
   

Usage

• Left-click the tray icon to view battery status
• Right-click to access the control menu:
  • Toggle Conversational Awareness
  • Switch between noise control modes
  • View battery levels
  • Control playback