The big time of local mp3 libraries is over. Therefore this project has been abandoned and is currently unmaintained. Maybe have a look at https://qca.st/ which provides jukebox functionalities for music streaming services.
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
.. image:: http://static.jensnistler.de/jukebox.png :height: 404px :width: 872px :scale: 100% :alt: Democratic Jukebox - your democratic music player
django-social-auth <https://github.com/omab/django-social-auth>_ for more authentication providers)
virtualenvwrapper <https://pypi.python.org/pypi/virtualenvwrapper> via
pip <http://pypi.python.org/pypi/pip> if not alreay done:
sudo pip install virtualenvwrapper
Set up a project for jukebox:
Install the jukebox in your fresh virtual environment:
workon jukebox pip install jukebox
Now it's time to configure the jukebox
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.
Stream your music to a shoutcast compatible server
pip install jukebox-shout
jukebox_shout <https://github.com/lociii/jukebox_shout>_ for details and startup command.
Play your music locally on the machine running the jukebox.
pip install jukebox-mpg123
jukebox_mpg123 <https://github.com/lociii/jukebox_mpg123>_ for details and startup command.
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
jukebox_live_indexer <https://github.com/lociii/jukebox_live_indexer>_ for details and startup command.
jukeboxcore provides a fully fledged REST API for authenticated users. See
API reference <https://github.com/lociii/jukebox/blob/master/jukebox/jukebox_core/docs/API.rst>
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
You want to contribute to this project? Just fork the repo and do this:
mkproject jukebox git clone firstname.lastname@example.org:[username]/jukebox.git . git remote add upstream git://github.com/lociii/jukebox.git pip install -r requirements.txt cd jukebox
Follow up configuring jukebox like described in Setup. Use ./manage.py instead of the jukebox command.
You can now create a branch to make your actual changes and send a pull request. See
this article <https://www.openshift.com/wiki/github-workflow-for-submitting-pull-requests>_ for how to do this.
Luan Fonseca de Farias <https://github.com/luanfonceca>_
Peter Hoffmann <https://github.com/hoffmann>_
Amir H. Hajizamani <https://github.com/amirhhz>_
Gabriel Duman <https://github.com/gabber7>_
Steffen Zieger <https://github.com/saz>_
Jonas Baumann <https://github.com/jone>_