Python bindings for Musicbrainz' NGS webservice
Latest commit 9c276a7 Oct 2, 2016 @mineo mineo Merge pull request #209 from mineo/py3-caa-bytes
 Convert the CAA response data to unicode before loading it via json

Signed-off-by: Wieland Hoffmann <>


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


# 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 )
musicbrainzngs.set_useragent("Example music app", "0.1", "")

# If you are connecting to a different server

See the file for more examples.

More documentation is available at Read the Docs.


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


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


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