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.
Setup
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:
shoutcast
See jukebox_shout
mpg123
See jukebox_mpg123
Feel free to fork jukebox and add additional playback modules.
API
jukebox_core provides a fully fledged REST API. See API reference.
Product's homepage
Requirements:
· Python
· Django
· Mutagen
· django-social-auth
· django-rest-framework
· python-shout
· python-daemon
· libshout
What's New in This Release: [ read full changelog ]
· Improved exception handling
· Added rss for current song
· Minor bug fixes