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

At one point in your life your play queue might get empty. Don't worry, the jukebox will keep on playing. The playback system figures out who is online using the web interface or API and plays music to their liking.

Required system libraries

libshout3, libshout3-dev and python-dev are required to build the dependecy python-shout.

• Jukebox is available in english, german and brazilian portuguese
• Jukebox uses Facebook, Twitter and Github for authentication (see django-social-auth for more authentication providers)

Install virtualenvwrapper via pip if not alreay done:

sudo pip install virtualenvwrapper

Set up a project for jukebox:

mkproject jukebox

Install the jukebox in your fresh virtual environment:

workon jukebox
pip install git+git@github.com:rejahrehim/jukebox.git

Now it's time to configure the jukebox

1. Create the database in MySql
2. Edit your database credentials in settings
3. Enter admin credentials and select authentication providers
4. Index your music

That's all

After Updating your database credentials in settings run this commands

jukebox jukebox_setup
jukebox syncdb
jukebox migrate
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:

jukebox runserver ip:port

Now you're ready to put music in the queue.

Currently there are two methods of playing the music chosen in jukebox.

shoutcast

Stream your music to a shoutcast compatible server

pip install jukebox-shout

See jukebox_shout for details and startup command.

mpg123

Play your music locally on the machine running the jukebox.

pip install git+https://github.com/rejahrehim/jukebox_mpg123.git

See jukebox_mpg123 for details and startup command.

Contribute!

Feel free to write additional playback modules and I'll add them to the list above.

There is no need to update your index every time a new song is added to your library, just use the live indexer package.

pip install jukebox-live-indexer

See jukebox_live_indexer for details and startup command.

jukebox_core provides a fully fledged REST API for authenticated users. See API reference

Jukebox supports google-like search filter. Available search fields: title, artist, album, genre, year.

title:(love to dance) artist:bobby
artist:(bobby baby) lucky
title:(in ten years) genre:electronic

MIT License. See License