Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

Pi MusicBox

Pi MusicBox is the Swiss Army Knife of streaming music on the Raspberry Pi. With Pi MusicBox, you can create a cheap (Sonos-like) standalone streaming music player for Spotify and other online music services.

Maintainer Wanted

This project is outdated and requires more work than I am currently prepared to invest. If you are interested in becoming the maintainer then please get in touch.


  • Headless audio player based on Mopidy. Just connect your speakers or headphones - no need for a monitor.
  • Quick and easy setup with no Linux knowledge required.
  • Stream music from Spotify, SoundCloud, Google Music and YouTube.
  • Listen to podcasts (with iTunes and Podder directories) as well as online radio (TuneIn, Dirble and Soma FM).
  • Play MP3/OGG/FLAC/AAC music from your SD card, USB drives and network shares.
  • Remote controllable with a choice of browser-interfaces or with an MPD-client (e.g. MPDroid for Android).
  • AirTunes/AirPlay and DLNA streaming from your smartphone, tablet or computer.
  • Support for all kinds of USB, HifiBerry and IQ Audio soundcards.
  • Wi-Fi support (WPA, Raspbian supported Wi-Fi adapters only)
  • scrobbling.
  • Spotify Connect support.

Please note that Pi MusicBox does NOT currently support the Raspberry Pi 4.


  1. Download the latest release.
  2. Write the image to your SD card. See here for details.
  3. Customise the /boot/config/settings.ini file.
  4. Boot your Raspberry Pi and wait for PiMusicbox to start.
  5. Finish configuring the system using the web settings.

Creating an image

If you want to build an image from source, note that the current v0.7 image is an incremental update of v0.6 and can be generated as follows:

# 1. Install prerequisite packages (probably not an exhaustive list, sorry....)
sudo apt-get install git coreutils e2fsprogs zerofree util-linux qemu-user-static latexmk python-sphinx

# 2. Download and unzip very latest project source files (use for current release)
unzip && mv pimusicbox-develop src

# 3. Download and unzip base v0.6 image
unzip && mv musicbox0.6.img musicbox.img

# 4. Enlarge image so there is free space to work in
./src/ musicbox.img bigger

# 5. Run update script within base image (requires sudo).
./src/ musicbox.img

# 6. Go have a cup of tea/coffee while you wait...

# 7. Shrink the image and other finishing touches
./src/ musicbox.img finalise

Project resources


Copyright 2013-2020 Wouter van Wijk and contributors.

Licensed under the Apache License, Version 2.0. See the file LICENSE for the full license text.


An image (SD-card) to turn the Raspberry Pi into an easy to use MusicBox with Spotify playback and AirTunes streaming





No packages published