MPD Web Client in Go
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
config gofmt Apr 19, 2014
init.d Add init script May 19, 2015
model Refactor Playlist and Controls into single Player Apr 26, 2015
player Refactor MpdPlayer: send commands through to player thread. Apr 27, 2015
static Fix more layout bugs Apr 20, 2015
.gitignore Add init script May 19, 2015
LICENSE Add license (apache v2) Apr 5, 2013 Add init script May 19, 2015
main.go Address go vet, use keyed fields Apr 27, 2015


This is pickup (in go), a web frontend for Music Player Daemon by Andy O'Neill

Pickup is my white whale... I've been playing with the idea since 2007. I have a large music collection, and my navigation of choice is by album, with easy search available. The "albums" interface in Google Play Music (web) is pretty close, but the google play uploader sucks and misses half of my songs.


It works, just about. You can add albums and tracks to the playlist, control volume, skip tracks, start/stop playback. You can view the playlist. It runs on the Raspberry Pi with room to run mpd as well. Because of the client-side architecture it is very fast. I hope to start iterating on the look-and-feel a bit soon now that it is functional.

Getting Started In Ubuntu

apt-get install golang-go
mkdir $HOME/go
export GOPATH=$HOME/go
go get

cd $HOME/go/src/
go build
./pickup --help

Getting Started Cross-Compiling for Raspberry Pi

In ubuntu, you need to build go yourself to cross-compile. Using these instructions download the source, run ./all.bash to get your native toolchain.

Next run this to build the ARM toolchain for the pi:

GOOS=linux GOARCH=arm GOARM=5 ./all.bash

Now you can cross compile pickup for the pi

cd ~/go/src/
GOOS=linux GOARCH=arm GOARM=5 go build

Now copy the whole pickup directory to your pi and run


Install As A Service

Copy init.d/pickup to /etc/init.d

Edit the script and set these vars to suit your setup. I'm lazy and just run as my main user, definitely don't do this on the internet!



I've written functional prototypes of this in C++, Python, C++ again (I was trying to run it on an NSLU2 embedded Linux machine with 32MB RAM) and now Go. It started off as a standalone player, then grew an xmms2 backend, and now is going to use mpd for playback, since I already use mpd everywhere and it just works. I'm writing it now in Go because I want to learn Go and I want to have this system. This is my first real project in go: any code review, criticism or contributions would be much appreciated.

Design Requirements

  • Run on embedded hardware. NSLU2 would be nice, Raspberry Pi would be fine.
  • Display results quickly even when the music is stored on a slow-ish network drive (i.e. some caching of available music).
  • Include more metadata than pure MPD, e.g. related artists, reviews etc. Can be loaded on the fly or stored locally.
  • Show random albums to play. Shuffle-by-album.
  • Assume /some/netsted/path/Artist/Album/Track.extension file format
  • Must have: play now / add to main playlist
  • Must have: play internet streams (e.g. DI Radio)
  • Must have: responsive frontend, single-page-app feel.

Design Approach

  • The Go implementation is a simple backend serving JSON to a javascript frontend, (single-page app in Backbone.js.)
  • The frontend loads the entire music collection up front. This takes less than a second and makes navigating around the collection extremely fast.


See Pickup on Trello