Avalon Music Server

The Avalon Music Server is a Python WSGI application and several CLI scripts that, together, scan metadata from a music collection, store it in a database, and expose it as a JSON web service. It is available under the MIT license.

The Avalon Music Server is able to read metadata from ogg, flac, and mp3 files. Clients can then query the server for information about songs, albums, artists, and genres in the collection.

Features include:

  • Support for Mp3, Vorbis (Ogg), or Flac audio files
  • Support for multiple database backends
  • Simple JSON interface including fast prefix matching
  • Unicode output support
  • Python 2.6 – 3.4

To install it simply run

$ pip install avalonms

Then, to scan your music collection

$ avalon-scan ~/Music

Then, start the application using a WSGI server like Gunicorn

$ gunicorn --preload avalon.app.wsgi:application

The documentation linked below will go into more detail about how to configure and run the Avalon Music Server in a production environment, how to interact with it using the JSON web service, and how to set up an environment to develop it.

Indices and tables