Skip to content


Subversion checkout URL

You can clone with
Download ZIP
The Social Music Player!
Tree: 7710ff0c0d

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


UDJ is a social music player. It allows many people to control a single music player democratically. Checkout the UDJ homepage for more information. This is the official UDJ server. For details on the API for interacting with this server checkout the UDJ-0.5 REST API. You can also checkout the source for any of our several clients:

Running The Test Server

Installing Requirements

The udj server requires several python packages. They can be found in requirements.txt and installed with the command

pip install -r requirements.txt

It is suggested that before executing the above command you first setup a virtual environment in which to work. This will greatly help in preventing and conflicts you may have between any currently installed python packages and the ones required by UDJ. For more information about virtual environment, please visit the virtualenv homepage.

Also note that UDJ uses geodjango so you'll need to have a spatial database. For more information on setting up a spatial database and getting it working with geodjango, please view the geodjango documentation. We recommend setting up a PostGIS database, however UDJ should work in theory with other spatial databases supported by geodjango.

Configuring the Test Server

In order to run the test server, there are several key variables that you must provide to the file. This can easily be done by creating a file called The file will load this file and use any variables put in it. A skeleton of what a typical looks like can be found in settings_local.skel. Once you have all your settings configured, you can populate your database with test data by executing

python loaddata udj/fixtures/test_fixture.json

This populates the database with dummy data and creates an admin user with the username admin and the password udj.

Running the Test Server

Once you have everything setup, you can run the server by running the following command:

`python runserver`

Who Are You?

UDJ is a team effort lead by Kurtis Nusbaum. I really like computers and programming.


If you have any questions or comments, feel free to post them to the UDJ mailing list.


UDJ is licensed under the GPLv2.

Something went wrong with that request. Please try again.