Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install jukebox

How to install jukebox

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install jukebox
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
0.4.1 Available View build log
Linux (32-bit)
0.4.1 Available View build log
Linux (64-bit)
0.4.1 Available View build log
Lastest release
version 0.4.1 on Jun 28th, 2013

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.

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.

Democratic Jukebox - your democratic music player


  • Jukebox is available in english and german
  • 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 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

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

See jukebox_shout for details and startup command.


Play your music locally on the machine running the jukebox.

pip install jukebox-mpg123

See jukebox_mpg123 for details and startup command.


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

Live indexing

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

Search filters

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


You want to contribute to this project? Just fork the repo and do this:

mkproject jukebox
git clone git@github.com:[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 for how to do this.

Release Notes


  • Initial release


  • Fixed installer bugs
  • Added personal history
  • Added system tests for api


  • Language switch
  • Sortable lists
  • Google-like search operators
  • Autoplay tries to play appropriate music
  • Improved web interface


  • fixed issue with autoplay


  • Added jukebox_watch
  • Added list of voters
  • Minor improvements


  • Improved exception handling
  • Added rss for current song
  • Minor bug fixes


  • Update dependencies
  • Fix authentication problems
  • Switch from inotify to watchdog


  • Fix manifest


  • Fix to skip unauthorized sessions
  • Updated wsgi handler


  • Update mutagen (Thanks guys for removing old packages)
  • Fixed minor bugs (Thanks to saz)


  • Fix buggy pypi package


  • Split jukebox in different packages
  • Strip artist from album data


  • Add missing wsgi file

Subscribe to package updates

Last updated Jun 28th, 2013

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.