Noise Control modes (Off, Transparency, Adaptive, Noise Cancellation)
Conversational Awareness
Battery monitoring
Auto play/pause on ear detection
Hearing Aid features
- Supports adjusting hearing aid- amplification, balance, tone, ambient noise reduction, own voice amplification, and conversation boost
- Supports setting the values for left and right hearing aids (this is not a hearing test! you need to have an audiogram to set the values)
Seamless handoff between Android and Linux

Prerequisites

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

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

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

Libpulse development headers

# On Arch Linux / EndevaourOS, these are included in the libpulse package, so you might already have them installed.
sudo pacman -S libpulse

# For Debian / Ubuntu
sudo apt-get install libpulse-dev

# For Fedora
sudo dnf install pulseaudio-libs-devel

Cmake

# For Arch Linux / EndeavourOS
sudo pacman -S cmake

# For Debian / Ubuntu
sudo apt-get install cmake

# For Fedora
sudo dnf install cmake

Setup

Build the application:

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

Run the application:
```
./librepods
```

Troubleshooting

Media Controls (Play/Pause/Skip) Not Working

If tap gestures on your AirPods aren't working for media control, you need to enable AVRCP support. The solution depends on your audio stack:

PipeWire/WirePlumber (Recommended)

Create ~/.config/wireplumber/wireplumber.conf.d/51-bluez-avrcp.conf:

monitor.bluez.properties = {
  # Enable dummy AVRCP player for proper media control support
  # This is required for AirPods and other devices to send play/pause/skip commands
  bluez5.dummy-avrcp-player = true
}

Then restart WirePlumber:

systemctl --user restart wireplumber

Warning

Do NOT run mpris-proxy with WirePlumber - it will conflict and break media controls.

PulseAudio

If you're using PulseAudio instead of PipeWire, enable and start mpris-proxy:

systemctl --user enable --now mpris-proxy

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

Hearing Aid

To use hearing aid features, you need to have an audiogram. To enable/disable hearing aid, you can use the toggle in the main app. But, to adjust the settings and set the audiogram, you need to use a different script which is located in this folder as hearing_aid.py. You can run it with:

python3 hearing_aid.py

The script will load the current settings from the AirPods and allow you to adjust them. You can set the audiogram by providing the values for 8 frequencies (250Hz, 500Hz, 1kHz, 2kHz, 3kHz, 4kHz, 6kHz, 8kHz) for both left and right ears. There are also options to adjust amplification, balance, tone, ambient noise reduction, own voice amplification, and conversation boost.

AirPods check for the DeviceID characteristic to see if the connected device is an Apple device and only then allow hearing aid features. To set the DeviceID characteristic, you need to add this line to your bluetooth configuration file (usually located at /etc/bluetooth/main.conf):

DeviceID = bluetooth:004C:0000:0000

Then, restart the bluetooth service:

sudo systemctl restart bluetooth

Here, you might need to re-pair your AirPods because they seem to cache this info.

Troubleshooting

It is possible that the AirPods disconnect after a short period of time and play the disconnect sound. This is likely due to the AirPods expecting some information from an Apple device. Since I have not implemented everything that an Apple device does, the AirPods may disconnect. You don't need to reconnect them manually; the script will handle reconnection automatically for hearing aid features. So, once you are done setting the hearing aid features, change back the DeviceID to whatever it was before.

Why a separate script?

Because I discovered that QBluetooth doesn't support connecting to a socket with its PSM, only a UUID can be used. I could add a dependency on BlueZ, but then having two bluetooth interfaces seems unnecessary. So, I decided to use a separate script for hearing aid features. In the future, QBluetooth will be replaced with BlueZ native calls, and then everything will be in one application.