Short answer
Restart the Bluetooth service with sudo systemctl restart bluetooth, then remove the device and pair it again. Headphones that connect but sound flat or silent: check the output and the playback profile. AirPods pair like other headphones; if they won’t, there is a workaround below.
The steps work on Ubuntu 22.04 and on 24.04 LTS and newer. Where they differ, it says so: 22.04 uses PulseAudio for sound, newer releases use PipeWire.
1. Basic checks
- Open Settings Bluetooth and make sure Bluetooth is on.
- Charge the device and put it in pairing mode (see its manual).
- Disconnect it from your phone. Many headphones connect to one device at a time.
- Run
rfkill list bluetooth. If it saysSoft blocked: yes, runsudo rfkill unblock bluetooth
Hard blocked: yes means a switch or key on the laptop turns Bluetooth off, often the airplane-mode key. Press it, or check the BIOS settings.
2. Restart the Bluetooth service
- Run
sudo systemctl restart bluetooth - Run
systemctl status bluetoothand look foractive (running). Press Q to leave.
3. Remove the device and pair it again
In Settings Bluetooth, click the device, then Forget Device (on 22.04: Remove Device). Put it in pairing mode and click it again in the list.
Or in a terminal: run bluetoothctl, then type these at the [bluetooth]# prompt, one per line:
power on
devices
remove XX:XX:XX:XX:XX:XX
scan on
pair XX:XX:XX:XX:XX:XX
trust XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX
quitReplace XX:XX:XX:XX:XX:XX with the address that devices or scan on shows. trust makes the device reconnect by itself next time.
4. Headphones connect, but sound bad or silent
Open Settings Sound and pick the headphones under Output Device.
Bluetooth headsets have two modes: High Fidelity Playback for music, and a headset mode for calls that sounds flat. Poor sound usually means headset mode.
- Install the sound control tool:
sudo apt install pavucontrol - Open PulseAudio Volume Control and click the Configuration tab.
- For your headphones, choose High Fidelity Playback (A2DP Sink) in the Profile list. The name can include the codec, such as SBC or LDAC.
Headset mode turns on by itself when an app uses the headphones’ microphone, such as a video call. That is normal.
No high-quality profile, or no sound at all? Reinstall the Bluetooth sound support, then restart Bluetooth and connect again:
- Ubuntu 24.04 and newer:
sudo apt install --reinstall libspa-0.2-bluetooth, then log out and back in. - Ubuntu 22.04:
sudo apt install --reinstall pulseaudio-module-bluetooth, thenpulseaudio -k
5. Pair AirPods with Ubuntu
- Put both AirPods in the case and open the lid.
- Hold the button on the back of the case until the light flashes white. On AirPods 4, AirPods 5 and AirPods Pro 3, double-tap the front of the case instead.
- In Settings Bluetooth, click your AirPods.
AirPods show up but won’t pair, or keep disconnecting? Try sections 1 to 3 first. If that fails, an older workaround helps some people: make Ubuntu use classic Bluetooth only, just to pair them.
- Run
sudo nano /etc/bluetooth/main.conf - Under
[General], change the line#ControllerMode = dualtoControllerMode = bredr - Save with Ctrl + O, Enter, and close with Ctrl + X.
- Run
sudo systemctl restart bluetoothand pair the AirPods again. - Once they are paired, change the line back to
#ControllerMode = dualand restart Bluetooth.
On a non-Apple device, AirPods work as normal Bluetooth headphones for music and calls, without Siri.
6. Still not working
- Update the system:
sudo apt update && sudo apt full-upgrade, then restart. Fixes for Bluetooth chips arrive in kernel and firmware updates. - Check the adapter:
bluetoothctl list. If nothing is listed, Ubuntu sees no Bluetooth adapter. Look for errors withsudo dmesg | grep -i bluetooth. A USB Bluetooth adapter is a quick fallback. - Try the device with another computer or phone. If it fails there too, the device is the problem.
- Blueman (
sudo apt install blueman) shows more Bluetooth options than Settings, such as profiles.
Check the result
Test it now
Headphone test
It plays sound in the left and right ear, one at a time. If you hear each on its own side, the headphones play in stereo.
Using the headset’s microphone? Check it with the mic test. Want better sound than SBC? See LDAC and aptX on Ubuntu.