Pi MusicBox

Make your Raspberry Pi stream!

Welcome to the Swiss Army Knife of streaming music using the Raspberry Pi. With Pi MusicBox, you can create a cheap (Sonos-like) standalone streaming music player for Spotify, Google Music, SoundCloud, Webradio, Podcasts and other music from the cloud. Or from your own collection from a device in your network. It won't drain the battery of your phone when playing. The music won't stop if you play a game on your phone.

Connect a 25$ Raspberry Pi to your (DIY) audio system, easily configure MusicBox and go! Control the music from your couch using a phone, tablet, laptop or PC, no tinkering required. AirPlay and DLNA streaming also included!




DIY Projects using Pi MusicBox

Pi MusicBox is proud to provide the software for an increasing number of Do It Yourself audioboxes, like these:


Here you can find an image for the SD Card for you Pi. It's around 290MB in (compressed) size; 950MB uncompressed:

This can take a while, so in the meantime, please spread the word!


The instructions below are quite compact. Users have created more elaborated instructions.


Extract the zip-file. Put the resulting image on your sd-card by following these instuctions. The image is for a 1GB card, but you can put it on a larger one, for more space if you want to put audio files on the card. A manual is included in the Zip.


  1. You can edit all settings in the new settings page from the webclient. To access it, you need a network connection. To enable Wifi, you can either first connect the Pi using a cable and use the settings page, or fill in the wifi-settings in the ini file on the SD Card. For that:
  2. Put the SD-card into your computer. Open the contents of the 'config' folder of SD-Card in your Finder/Explorer.
  3. Add your Wifi network and password to the file (and edit other settings if you want) settings.ini It has instructions on what to put where.
  4. MusicBox will autodetect usb audiocards/speakers/boxes and hdmi. It's possible to override this in the settings. For example if you want to use analog out while having hdmi connected.

Detailed instructions can be found in the Manual. But it's written for MusicBox 0.4...

Start me up!

  1. Put the card in the Pi
  2. Connect cables (You don't have to connect a monitor to the Pi if you don't want to)
  3. To use Wifi and USB-Audio you have to plugin the devices before you start the Pi. Restart if you plug them in later.
  4. Power on your Pi
  5. Wait for a while... So in the meantime, follow us!

Accessing the music

  1. Point your browser to the Pi. Depending on your network and computers, it will be available at this address: http://musicbox.local
  2. Most OS X/iOS and Windows devices probably will find it immediately. If it doesn't work, you could try to install Apple Bonjour/iTunes in Windows to make it work. Linux should also work if Avahi or Samba/Winbind is installed.
  3. Using Android, you have to point your browser to the MusicBox using the IP-address of your Pi, e.g. (fill in your own!). There is no way to change that for now, unless Android would support it, The IP-address is printed on the screen when MusicBox is started. Connect a monitor/tv to find out. Or use a network/bonjour scanning utility.

Support & Contact

Please refer to the Frequently Asked Questions and the Manual before asking questions.

You can discuss features and problems on the forum. Please report bugs about MusicBox itself at the repo at Github. You can also try the #mopidy channel on Freenode, or the Raspberry Pi forums.

What's new?

Take a look at the changes to see what has changed


This is system not totally secured. Don't run it outside a firewall!


Pi MusicBox is based on the following great projects: