librepods/linux

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
   

Setup

1. Edit main.h and update PHONE_MAC_ADDRESS with your phone's Bluetooth MAC address:

   #define 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:

   ./applinux
   

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