An open API service indexing awesome lists of open source software.

https://github.com/alastair/python-musicbrainzngs

Python bindings for Musicbrainz' NGS webservice
https://github.com/alastair/python-musicbrainzngs

Last synced: 4 days ago
JSON representation

Python bindings for Musicbrainz' NGS webservice

Awesome Lists containing this project

README

        

Musicbrainz NGS bindings
########################

This library implements webservice bindings for the Musicbrainz NGS site, also known as /ws/2
and the `Cover Art Archive `_.

For more information on the musicbrainz webservice see ``_.

Usage
*****

.. code:: python

# Import the module
import musicbrainzngs

# If you plan to submit data, authenticate
musicbrainzngs.auth("user", "password")

# Tell musicbrainz what your app is, and how to contact you
# (this step is required, as per the webservice access rules
# at http://wiki.musicbrainz.org/XML_Web_Service/Rate_Limiting )
musicbrainzngs.set_useragent("Example music app", "0.1", "http://example.com/music")

# If you are connecting to a different server
musicbrainzngs.set_hostname("beta.musicbrainz.org")

See the ``query.py`` file for more examples.

More documentation is available at
`Read the Docs `_.

Contribute
**********

If you want to contribute to this repository, please read `the
contribution guidelines
`_ first.

Authors
*******

These bindings were written by `Alastair Porter `_.
Contributions have been made by:

* `Adrian Sampson `_
* `Corey Farwell `_
* `Galen Hazelwood `_
* `Greg Ward `_
* `Ian McEwen `_
* `Jérémie Detrey `_
* `Johannes Dewender `_
* `Michael Marineau `_
* `Patrick Speiser `_
* `Pavan Chander `_
* `Paul Bailey `_
* `Rui Gonçalves `_
* `Ryan Helinski `_
* `Sam Doshi `_
* `Shadab Zafar `_
* `Simon Chopin `_
* `Thomas Vander Stichele `_
* `Wieland Hoffmann `_

License
*******

This library is released under the simplified BSD license except for the file
``musicbrainzngs/compat.py`` which is licensed under the ISC license.
See COPYING for details.