Democratic Jukebox - your democratic music player
Project description
Democratic Jukebox - your democratic music player
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.
Required system libraries
libshout3, libshout3-dev and python-dev are required to build the dependecy python-shout.
General
Jukebox is available in english and german
Jukebox uses Facebook, Twitter and Github for authentication (see django-social-auth for more authentication providers)
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
Enter admin credentials and select authentication providers
Create the database
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 for authenticated users. See API reference
Dependencies
Django==1.3 mutagen==1.20 django-social-auth==0.6.0 djangorestframework==0.2.3 python-shout==0.2 python-daemon==1.6
License
MIT License. See License
Developers
Clone the git repository, change directory to jukebox/jukebox/ and replace the calls to “bin/jukebox” by “python manage.py”
Release Notes
0.1.0 - Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.