Jukebox For Linux

Ever wanted to listen to music with a larger group of people e.g. in your office? Who decides what to play? Make your music player democratic and give everyone the chance to promote their favourite song.

Jukebox is a Python app that provides a web interface to search your music library and vote for songs to be played. The more votes a song gets, the sooner you will listen to it.

Install virtualenv via pip if not alreay done:

sudo pip install virtualenv

Set up a virtualenv for jukebox:

virtualenv --no-site-packages jukebox

Install ez_setup and finally jukebox in your fresh virtual environment:

cd jukebox bin/pip install ez_setup bin/pip install jukebox

Now it's time to configure the jukebox

1. Enter admin credentials and select authentication providers 2. Create the database 3. Index your music

That's all

bin/jukebox jukebox_setup bin/jukebox syncdb bin/jukebox jukebox_index --path=/path/to/library

The django builtin development webserver will be sufficient to serve your office or party. Just start it up:

bin/jukebox runserver ip:port

Now you're ready to put music in the queue. Jukebox offers several methods to play it:

See jukebox_shout

See jukebox_mpg123

Feel free to fork jukebox and add additional playback modules.

jukebox_core provides a fully fledged REST API. See API reference.