Like my stuff? I'm now live coding on Twitch several times a week. Come join me while I build software, teach concepts, and sometimes play 8 bit video games.

Jeremy Morgan on Twitch

I installed Arch Linux on my new laptop a couple of months ago, and strangely enough, never used Bluetooth on it yet. Bluetooth in Arch Linux can be fun and interesting at times.

I wanted to use my favorite Sony headphones on my laptop (It only has Arch Linux on it, no Windows!), so I thought I’d document the process.

Bluetooth in Arch Linux

Step 1: Install Bluez and Blueman

The first step is to install some utilities.

I will install:

sudo pacman -S bluez
sudo pacman -S bluez-utils
sudo pacman -S blueman

These should install without a problem. You’ll see a neat icon here:

Bluetooth in Arch Linux

Next, make sure the btusb Kernel module is loaded:

lsmod | grep btusb

Bluetooth in Arch Linux

Here’s a trick to help it find adapters, even if you plug one in:

sudo vim /etc/bluetooth/main.conf

Search for autoenable:

Bluetooth in Arch Linux

Save the file.

2. Enable the Service

Next, we want to try starting up the service:

sudo systemctl start bluetooth.service

If you want it to start up automatically, enable it:

sudo systemctl enable bluetooth.service

Now we should be up and running. You can turn on all adapters with Blueman:

Bluetooth in Arch Linux

Now you should be ready to connect and pair.

3. Pairing

Blueman makes pairing pretty easy:

Bluetooth in Arch Linux

Select a device:

Bluetooth in Arch Linux

Start pairing:

Bluetooth in Arch Linux

And you’re done connecting!

Bluetooth in Arch Linux

If you’re connecting headphones like I am, there are a few more steps.

Connecting Audio

First off, I’ll install pulseaudio and the Bluetooth extension.

sudo pacman -S pulseaudio
sudo pacman -S pulseaudio-bluetooth

Start up pulseaudio:

sudo systemctl pulseaudio start

If you want it to start up automatically:

sudo systemctl start pulseaudio

One utility I like to use to control audio (point it towards my speakers or the headphones) is Pavucontrol.

sudo pacman -S pavucontrol

This is a great way to switch back and forth:

Bluetooth in Arch Linux

Note: If You Have a2dp

If your audio devices uses a2dp (Advanced Audio Distribution Profile), you may get the following error:

Bluetooth in Arch Linux

Connection Failed: Protocol not available

Here’s how to fix it. There’s a gdm fix, so it connects upon login (if you’re using GDM)

cd ~/src
git clone
makepkg -i

You’ll also need to do this:

Here’s a hotfix that I found that worked. Check out this gist.

Use this content for your file:

mkdir -p ~/.config/scripts/xorg
vim ~/.config/scripts/xorg/
sh ~/.config/scripts/xorg/

Create a udev rules file and add this content

sudo vim /etc/udev/rules.d/20-bt-auto-enable-a2dp.rules

Now you should be up and running and listening to audio! It worked for my WH-1000MX3 headphones.

Bluetooth in Arch Linux

Bluetooth in Arch Linux

Questions, comments? Let me know!

Get notified when new tutorials are posted:

Published: Apr 30, 2020 by Jeremy Morgan. Contact me before republishing this content.