Skip to content
An image (SD-card) to turn the Raspberry Pi into an easy to use MusicBox with Spotify playback and AirTunes streaming
Branch: develop
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Update authors.rst Mar 18, 2019
filechanges Use upstream shaireport-sync config. Jan 7, 2019
.env.sample Upgrade script now checks for at least 1GB free space. Mar 17, 2017
.gitignore Removed xmbc files and updated gitignore Jul 26, 2017
.mailmap Update .mailmap Aug 27, 2015
LICENSE Add Apache 2.0 license Feb 10, 2016
README.rst Fixed broken (wrong) changelog link Mar 18, 2019 Use $(..) instead of legacy `..` Nov 6, 2018 Release v0.7.0RC3 Mar 15, 2017 Bump kernel to 4.14.89. (Fixes #513) Jan 7, 2019 Bump kernel to 4.14.89. (Fixes #513) Jan 7, 2019


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.


  • 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.


  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-2017 Wouter van Wijk and contributors.

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

You can’t perform that action at this time.