Your music metadata, exposed as a web service
Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
avalon
doc
ext
fabfile
test
.gitignore
.pylintrc
.travis.yml
LICENSE
MANIFEST.in
README.rst
requirements-dev.txt
requirements-prod.txt
requirements.txt
setup.cfg
setup.py
tox.ini

README.rst

Avalon Music Server

https://travis-ci.org/tshlabs/avalonms.png?branch=master

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

  • 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

Installation

To install it simply run

$ pip install avalonms

Usage

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

Documentation

The latest documentation is available at https://avalonms.readthedocs.io/en/latest/

Source

The source is available at https://github.com/tshlabs/avalonms

Download

Python packages are available at https://pypi.python.org/pypi/avalonms

Changes

The change log is available at https://avalonms.readthedocs.io/en/latest/changes.html