Turn your Raspberry Pi into a Wireless Portable Bluetooth Audio System A2DP

Picture of Turn your Raspberry Pi into a Wireless Portable Bluetooth Audio System A2DP
Howdy folks! I had the idea of turning my Raspberry Pi into something like the Beats By Dre portable audio system found here:,default,pd.html

It’s a cool product, don’t get me wrong, but I’m not really down to pay $400+ tax for some fancy looking speakers (which don't even give you rechargeable batteries, by the way). So I decided to set off to replicate the functionality without the hefty price tag.

OBJECTIVE: To create a Raspberry Pi that automatically boots into the command line and becomes discoverable via Bluetooth. Any Bluetooth-enabled device with the A2DP (Advanced Audio Distribution Profile) support will be able to push audio to the Pi through its Analog (default) or HDMI speaker output. When a Bluetooth device connects, the PI routes the connection through to Pulse audio and Bluetooth discoverability is turned off. The audio should play seamlessly from here. You can then disconnect your device (likely a smartphone) and the PI will become discoverable again via Bluetooth and another device is free to connect. The default pass key will be 0000 but most devices input this automatically so it should be hassle free!

NOTE: I did find that a lot of other people in the Linux community have attempted to do the same thing to their PI but not as successfully as I have! My setup allows the device to run headless (without a monitor) from boot and any Bluetooth device can connect and disconnect without an issue. I’ve seen a lot of other people with tutorials that make you login via command line first or login to the desktop and setup the Bluetooth connection manually. LAME! The goal of this is to be as similar to a *product* as possible. :) enjoy!

NOTE: This tutorial assumes you have a fair amount of Linux/command-line knowledge. I won’t be explaining basic commands or ideology so if this is above your head find a friend!

What is the Raspberry PI?
The Raspberry Pi is a credit-card sized computer that plugs into your TV and a keyboard. It’s a capable little PC which can be used for many of the things that your desktop PC does, like spreadsheets, word-processing and games. It also plays high-definition video. --Raspberry PI website

You can learn more about the PI and how to get one, here:

• Raspberry Pi
• Bluetooth v4.0+ micro USB dongle
• 4GB SD Card

Requirements for [portable audio]
• Battery-powered speaker(s)
• Battery pack for Raspberry Pi
• Enclosure to keep everything in
Remove these adsRemove these ads by Signing Up
1-40 of 168Next »
sobodash11 days ago

Made this and it's working great except for one problem. I have a Macbook Pro that recognizes the Pi as an audio devices, connects fine and switches to Bluetooth audio.

However, the Mac's audio does not appear to actually be streaming to the Pi. There is simply no sound at all. I tried toggling back and forth between the internal speakers and the Bluetooth Pi, but there was no real change.

Anyone have an ideas about what might be going on? I'm running Yosemite if it's relevant.

Oktavius sobodash10 hours ago

Hi, i have the same problem. Pairing with Iphone works very well. Connecting and pairing with my Macbook works but I can´t hear any music I play. Is there a solution to overcome this problem?

AndreaB32 days ago

Hi, many thanks for this tutorial.
I tried it on raspian wheezy 9/9/2014 (fresh install) and I'm stuck. My phone (android 4.2.2) shows the Pi as paired and connected to media audio, but I can't actually ear any output.
I looked around the internet and to try the connection I run

sudo l2ping <address>
but the raspberry said

Cannot connect: invalid exchange
I read all the comments here and didn't find a possible workaround.

Did someone manage to get this work with a recente realese of wheezy?

schmo901 year ago
after weeks of madness and no succes i got it finally working but with a complette different start script because the even kernel event did not work for me.

at first i decommended in the
sudo nano /etc/bluetooth/audio.conf

after that i made a script

sudo nano /

to get my bluetooth device mac adress

while [ 1 -lt 10 ]; do
  source=$(pactl list short sources |  grep -o "bluez.source.\(.*\)module" | sed 's/'\module'/''/g' |  sed 's/[ \t]*$//')
    if [ "$source" ]; then
      if [ $running -eq 1 ]; then
        sudo -u pi pactl load-module module-loopback source=$source sink=alsa_output.platform-bcm2835_AUD0.0.analog-stereo
     sudo hciconfig hci0 piscan
  sleep 5


sudo nano /etc/init.d/EnableBTMusic

#! /bin/sh
# /etc/init.d/blah

# Alles, was in jedem Fall ausgeführt werden soll, steht am Anfang
touch /var/lock/somefile.lock

# Bestimmte Funktionen werden per switch-case Anweisung geregelt
case "$1" in
    echo "Starte Beispielprogramm "
  sudo -u pi sh / &
    echo "Stoppe Beispielprogramm"
    # ./ --stop
    echo "Usage: /etc/init.d/ {start|stop}"
    exit 1

exit 0

 sudo chmod 755 /etc/init.d/EnableBTMusic
sudo update-rc.d EnableBTMusic defaults

with this changes i can hear music on my raspberry :-)
i hope i could help someone with that infos...

Hi, thanks for posting this.
I have the same issue you had, so, my phone says the devices are paired but no sound is actualli reaching the 3.5 mm jack.
I'm trying to get it to work using a 9/9/2014 wheezy, but I read in the comments that many people suggest to use a older kernel. Did your script work with a recent realese of raspian? I so I'll give it a try.

rpotee schmo901 year ago
For some reason, I need to ssh into my RPi to get this solution to work. Any work arounds? I have all of the configuration detailed for this project, plus your solution.
derekkg rpotee1 year ago
Me too! If I have Ethernet plugged into my pi, it works. If I don't, I can't connect. Did you ever figure out what the problem was?
rpotee derekkg1 year ago
I caved in and followed these instructions to install shairplay on my raspberrypi. Now, I can play music from my rooted Android tablet and iTunes over wifi, and it's much more reliable.
rpotee schmo901 year ago
This resolved my issue! But the volume was weak, so I added
amixer sset Master 100%
to the end of/
jaime44 days ago

Hello had good luck following your tutorial, everything works great only issue i have is volume is why too low, I've tried playing with the master volume and the sink threshold values in the sudo nano /usr/lib/udev/bluetooth with no changes. any ideas?

ron.laws8619 days ago

/usr/lib/udev/bluetooth does not exist...

sideeffekt7 months ago

I had issues with the udev section, my device was not showing up as an input device from udevadm monitor. So I had to change /etc/udev/rules.d/99-input.rules to correctly function when the device wasn't showing up as an input. Hopefully this will be helpful is anyone else comes across the same issue. I changed it to:

KERNEL=="hci0:12", SUBSYSTEM=="bluetooth", RUN+="/usr/lib/udev/bluetooth"
KERNEL=="hci0:11", SUBSYSTEM=="bluetooth", RUN+="/usr/lib/udev/bluetooth"
KERNEL=="hci0:13", SUBSYSTEM=="bluetooth", RUN+-"/usr/lib/udev/bluetooth"

This now covers the different ways my device is identified when it connects. It is almost always one of the devices above.

Then to get the /usr/lib/udev/bluetooth script to work I had to go through and completely piece together a new one that autopopulated the appropriate sink and source sections without relying on /sys/devices/virtual/input/ so my bluetooth script looks like this:


#Set User to run portions of the script as

# Turn off BT discover mode before connecting BT to audio
hciconfig hci0 noscan

#Set Volume
sudo -u "$BUSER" amixer set Master 100%

#Set Sink Volume
sudo -u "$BUSER" pacmd << !
set-sink-volume 0 65537

#Log add/remove status
echo "Executing bluetooth script...|$ACTION|" >> /var/log/bluetooth_dev

#Create audio sink variable as udev su/translated to user $BUSER for pactl command then script to log

BSINK=$(sudo -u "$BUSER" pactl list sinks short | tail -n 1 | awk '{print $2;}')

echo BSINK=$(sudo -u "$BUSER" pactl list sinks short | tail -n 1 | awk '{print $2;}') >> /var/log/bluetooth_dev

#Create buetooth source variable as udev su/translated to user $BUSER for pactl command then script to log

BSOURCE=$(sudo -u "$BUSER" pactl list sources short | grep bluez | awk '{print $2;}')

echo BSOURCE=$(sudo -u "$BUSER" pactl list sources short | grep bluez | awk '{print $2;}') >> /var/log/bluetooth_dev

#Run final pactl command as user $BUSER, then plug in variables, and finally write command to log file
sudo -u "$BUSER" pactl load-module module-loopback source="$BSOURCE" sink="$BSINK" rate=44100 adjust_time=0

echo sudo -u "$BUSER" pactl load-module module-loopback source="$BSOURCE" sink="$BSINK" rate=44100 adjust_time=0 >> /var/log/bluetooth_dev

# Turn on bluetooth discovery on disconnect
if [ "$ACTION" = "remove" ]
sudo hciconfig hci0 piscan

Thank you! The rewrite did the trick. So for everyone wondering how to get this working:

Get the image from Zonx, The one from 2 september 2013. then the following things right as the pi is booted up:

1. sudo apt-get update (never never never ever apt-get upgrade)

2. sudo apt-get install rpi-update

3. sudo BRANCH=next rpi-update

4. Then follow the instructions as normal

5. At the step 5 with the udev part add these extra things from sideeffekt:

KERNEL=="hci0:12", SUBSYSTEM=="bluetooth", RUN+="/usr/lib/udev/bluetooth"
KERNEL=="hci0:11", SUBSYSTEM=="bluetooth", RUN+="/usr/lib/udev/bluetooth"
KERNEL=="hci0:13", SUBSYSTEM=="bluetooth", RUN+-"/usr/lib/udev/bluetooth"

6. get the new script from sideeffekt.

With the original script i could connect but no sound, and with the new image from January this year I've had the famous 3 second sound bug en PI 'bluescreens'

Also, get a good bluetooth 4.0 dongle, just in case.

Big thanks to Dantheman, Zonx and Sideeffekt!

hey guys,

since i added the 3 new KERNEL-lines I'm able to connect to my raspy. Unfortunately I didn't get any sounds automaticaly due to the scripts. The debug tells me that the source an sink variables are empty.

Manually with this command I'm getting my device working fine:

pactl load-module module-loopback source=bluez_source.XX_XX_XX_XX_XX_XX

Any ideas why the debuggung looks like this:

~ $ tail -f /var/log/bluetooth_dev
sudo -u pi pactl load-module module-loopback source= sink= rate=44100 adjust_time=0
Executing bluetooth script...|add|
Executing bluetooth script...|add|
sudo -u pi pactl load-module module-loopback source= sink= rate=44100 adjust_time=0
sudo -u pi pactl load-module module-loopback source= sink= rate=44100 adjust_time=0

I hope it has nothing to do with my B+. I read something about a bad newer kernel, but an older Kernel I'm not able to install :-/

now it works automatically. I modified the bluetooth script (found here):

ACTION=$(expr "$ACTION" : "\([a-zA-Z]\+\).*")
if [ "$ACTION" = "add" ]; then
for f in /sys/devices/virtual/input/input*/name; do
mac=$(cat $f|sed 's/:/_/g')
sleep 1
if [ ! -z "$(su - pi -c 'pactl list short|grep '$mac)" ]; then
su - pi -c 'pactl load-module module-loopback source=bluez_source.'$mac' sink=alsa_output.platform-bcm2835_AUD0.0.analog-stereo rate=44100 adjust_time=0'

the scripts starts with the original string:

SUBSYSTEM=="input", GROUP="input", MODE="0660"
KERNEL=="input[0-9]*", RUN+="/usr/lib/udev/bluetooth"

I've had the same problem as Cole, has anyone fixed this yet?
DomR2 months ago

I have an odd problem, I've managed to get it to work, it will connect and play a song for about 10 seconds and then there will be no sound, the song will continue to play on my phone and it is still connected via bluetooth but no sound will come out!

To start it working again, I either have to restart the Pi or just restart bluetooth (sudo service bluetooth force-reload) and it will do the same thing.

Any ideas?

I have this exact same issue, I just set it up. I've looked at the running processes to see if just maybe bluetooth or pulse or maybe it died? Nope, i see them running the entire time (mine plays between 15 and 20 seconds then dies)

Ah yeah, other people have found what i found below in the comments. It's because pulseaudio is going to idle after 20 seconds. So there is a bit of code posted below to prevent that.

nreyes12 months ago

I'm having the same issue as Philrlewis

"Every time I try to set my class as 0x20041C in /var/lib/bluetooth/ it saves, but on reboot the class has reverted back to 0x4e041c. Any ideas how to stop this?"

Great instructable!!

I've followed the instructions closely, used the old kernel, and even followed some of the comment suggestions.
However, I'm getting "Connection Unsuccessful - Make sure bluetooth is on and in range"
Looks like the bluetooth blue light comes on intermittently on the Pi.

Any thoughts would be greatly appreciated!

Never got this working but here's a working Rasbpi-Bluetooth tutorial instead:

To follow up, I've tried these two bluetooth models off Amazon, both confirmed working with Raspberry Pi in the Amazon reviews. I don't think they're faulty here. (Low energy bluetooth) (Regular bluetooth)

I've also tried all the applicable comment recommendations (Diff script, diff kernel, etc.)

Running this didn't return anything.

tail -f /var/log/bluetooth_dev

RPCALIVE3 months ago

sudo apt-get upgrade should be sudo apt-get update

lukeg018 months ago

hmmm..... seems to work, got a device with a headset sign in the list.... now just ONE terrible problem.... i can't find the PIN code.... 0000 and 1234 did not help


lukeg01 lukeg018 months ago

fixed it using bluez agent, now... no audio not even for 20 sec, maybe worth noting, i'm using "Xbian" instead of raspbian, meaning everything with alas needs
needs the "sudo" command


DusanKo lukeg013 months ago


I hope i did not make two posts:)

Can You please give step by step instuctions how You managed the PIN pairing with bluez?

thank You lukeg01

wapenv4 months ago

After the 20 seconds fix it worked for me! But I'm searching for a command that stops playing... Because I also want to play internet radio...Someone a idea?

tbailey964 months ago

Thanks for this, I tried a few other methods before this one and couldn't make them work, this works, but the volume of the output from the 3.5mm jack is very low, as a result I need my amp turned up really high. I tried to fix this by increasing the master volume in the Bluetooth script to 200%, and that didn't have any affect, so has anyone got any ideas on how to make the pi kick out more volume? :)

Thanks In Advance,


sigilium4 months ago

Thanks for this, worked like a charm. Tomorrow morning my Raspi starts a new life in my car :)

I get quite nasty background noise from the analog output. Hope it's not so bad in car!

PeppoF4 months ago


I followed these steps.. I'm able to pair my Nexus 4 with the USB Bluetooth dongle (CSL v4.0 from amazon), but no sound is going out from speakers. I can see the device loaded correctly with pactl module in the bluetooth_dev log.

Now I have this version of Wheezy:

Linux raspberrypi 3.12.18+ #673 PREEMPT Thu Apr 24 18:34:24 BST 2014 armv6l GNU/Linux

Another thing I don't know if can cause problems, is the class of bluetooth. By default mine is 0x4e041c and I changed it to 0x20041c as suggested, but in the

/var/lib/bluetooth/><ADDRESS>/config file, the value changes back to 0x4e041c

(probably after a reboot or restart of bluetooth service).

Any suggestions? There could be compatibility problems with the dongle at this point, also if I can pair the device?


PeppoF PeppoF4 months ago

At last I made it.. I have changed two things, don't know which one (or both/none?) has worked.

First I put the class 0x4e041c on every configuration file and then I noticed that listing sink properties with

pactl list sinks

the "Mute" property was set to "Yes".. so I switched to "No" using this command:

pactl set-sink-mute alsa_output.platform-bcm2835_AUD0.0.analog-stereo 0

Anyway, after a reboot, it worked.

Now I have an issue with bluetooth pair... If I restart the bluetooth service, no device is able to pair again, until I reboot again the pi.

HaraldE4 months ago

At last I got this running on my Raspberry Pi model A, I got it working with Wheezy distro 2014-06-20. I did the apt-get update, apt-get upgrade and also updated the RPi firmware using the "sudo BRANCH=next dpi-update" command.

One error I believe I did was putting an ; in front of the resample-method = trivial line in /etc/pulse/daemon.conf , not sure about this though.

I struggeled a lot getting audio to play through the RPi, when I finally heard something it only lasted for about 20 seconds. I googled and found a fix at mrverralls blog:

add the following line at the end of /etc/pulse/client.conf :

extra-arguments = --exit-idle-time=-1 --log-target=syslog

Thank you for posting this instructable - I'm looking forward to install this setup in my 2004 Skoda Octavia :)

HaraldE HaraldE4 months ago

oh forgot url to mrverralls 20 sec timeout fix.
Thanks mrverrall

dantheman_213 (author) 1 year ago
Hmm I tested this extensively on the iPhone 4 and iPhone 5. Encountered 0 problems after countless connects/ disconnects. If you setup everything correctly, reboot your pi, and forget the device in your iPhone. Then wait to be seen again and connect. Should be okay! Remember to give it a second before disconnecting to reconnect.

hello, can you confirm me that your iphone is reconnection automaticaly without any intervention from your side? cand you please provide me the modifications for this to happen? i have managet to get the connection and sound, but no auto-reconnect after reboot. thanks.

Hi Dan, great job. I got everything working for Android, and I also tried with an old Samnsung phone with Windows mobile 5. The only problem is that iPhone is not connecting, it does not even show the Raspberry in the devices while discovering bluetooth. What could be wrong? I checked everyting many times and all looks fine. Thanks for your help.

PhilippeS14 months ago


I had the "20 seconds timeout issue". This page helped me out :

You just need to disable timeouts by adding a line in '/etc/pulse/client.conf'

extra-arguments = --exit-idle-time=-1 --log-target=syslog

citaine6 months ago


I followed the tutorial and worked well at first :D

then the sound stop and the only way to get the sound back is to use this command that I found on an other forum :

pactl load-module module-loopback source=1 sink=0

then the sound come back for 10 or 20 more sec and then stop.

If i use my command again, It will work for an other secs.

Could you help me with it ?



matty.kay citaine4 months ago

citaine, I was wondering if you ever figured out why this was happening. I am having the same issue.
I have output from my syslog pasted here:

Everything is up-to-date on this system:

kernel: Linux raspberrypi 3.12.22+ #691 PREEMPT Wed Jun 18 <snip>

bluez: 4.99-2
bluez-tools: 0.1.38+git662e-3
pulseaudio-module-bluetooth: 2.0-6.1
python-gobject: 3.2.2-2
python-gobject-2: 2.28.6-10

1-40 of 168Next »