Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

A Django-based readonly web music library application.

Project Description

Exordium is a read-only web-based music library system for Django. Exordium will read mp3 and ogg files from the host filesystem and provide an online interface to browse, download (as zipfiles or otherwise), and stream.

The HTML5 media player jPlayer is used to provide arbitrary streaming of music.

Exordium was built with a very specific set of operational goals and does not attempt to be a generic library suitable for widespread use. There are, in fact, no configuration options beyond those to define the file paths/URLs necessary for basic usage. Patches to add/change functionality will be happily received so long as they don’t interfere with or disable the current functionality by default, but there is no internal development goal to make Exordium a generic solution.

Detailed information about what Exordium expects from your library, and its assumptions and limitations, can be found either in the docs/ directory, Exordium’s Website, or It’s highly recommended to at least glance through these to get a feel for how Exordium will function.

The name “Exordium” comes from the fictional technology of the same name in Alastair Reynolds’ “Revelation Space” novels. It’s not a perfect name for the app, given that the Revelation Space Exordium would make a pretty lousy music library, but at least there’s some element of data storage and retrieval. Exordium the web-based music library, as opposed to its fictional counterpart, is only capable of retrieving music which has been imported to it in the past. I’ll be sure to contact all the major news organizations if I figure out a way to get it to retrieve music stored in the future.


Exordium is only currently tested on Python 3.4 and Django 1.10.

Exordium requires the following additional third-party modules:

  • mutagen (built on 1.34.1)
  • Pillow (built on 3.3.1)
  • django-tables2 (built on 1.2.5)
  • django-dynamic-preferences (built on 0.8.2), which in turn requires:
    • six (built on 1.10.0)
    • persisting_theory (built on 0.2.1)

Quick start

  1. If Exordium hasn’t been installed via pip or some other method which automatically installs dependencies, install its dependencies:

    pip install -r requirements.txt
  2. Add exordium, django_tables2, and dynamic_preferences to your INSTALLED_APPS setting like this:

  3. Include the exordium URLconf in your project like this:

    url(r'^exordium', include('exordium.urls')),
  4. Run python migrate exordium to create the Exordium models.

  5. Run python migrate dynamic_preferences to create the Dynamic Preferences models, if this wasn’t already configured on your Django install.

  6. Run python loaddata --app exordium initial_data to load some initial data into the database. (This is not actually strictly speaking necessary.)

  7. If running this from a webserver with static files present, make sure to run python collectstatic at some point to get the static files put in place properly, or otherwise configure your static file delivery solution.

  8. Either start the development server with python runserver or bring up your existing server. Visit the administrative area in “Dynamic Preferences > Global preferences” and set the values for the following:

    • Exordium Library Base Path: This is what defines where your music library can be found on disk.
    • Exordium Media URL: This is the base URL which provides direct access to the files in your library. Omit the trailing slash, though things will probably work fine even if it’s in there. Without this set properly, song download links will be broken and the streaming player will not work properly.
    • Exordium Zip File Generation Path: Path on the filesystem to store zipfile album downloads. This is the one location in which the user running Django needs write access.
    • Exordium Zip File Retrieval URL: This is the base URL providing web access to that zipfile directory.

    Without the last two options, Exordium will still function fine, but the album-download button will not be rendered. Exordium will also function without the “Exordium Media URL” option being set properly, though with the caveats mentioned above.

  9. If Zipfile downloads are configured, a process should be put into place to delete the zipfiles after a period of time. I personally use a cronjob to do this:

    0 2 * * * /usr/bin/find /var/audio/exordiumzips -type f -name "*.zip" -mtime +2 -print -exec unzip -v {} \; -exec rm {} \;
  10. Visit the “Library Upkeep” link from the Exordium main page and click on “Start Process” to begin the initial import into Exordium!

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django_exordium-1.0.0-py3-none-any.whl (357.5 kB) Copy SHA256 Checksum SHA256 py3 Wheel Oct 18, 2016
django-exordium-1.0.0.tar.gz (2.9 MB) Copy SHA256 Checksum SHA256 Source Oct 18, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting