This library implements webservice bindings for the Musicbrainz NGS site, also known as /ws/2.

For more information on the musicbrainz webservice see http://wiki.musicbrainz.org/XML_Web_Service.

# 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 development server
musicbrainzngs.set_hostname("echoprint.musicbrainz.org")

See the query.py file for more examples.

More documentation is available at Read the Docs.

1. Fork the repository on Github.
2. Make and test whatever changes you desire.
3. Signoff and commit your changes using git commit -s.
4. Send a pull request.

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

• Adrian Sampson
• Galen Hazelwood
• Greg Ward
• Ian McEwen
• Johannes Dewender
• Michael Marineau
• Patrick Speiser
• Paul Bailey
• Ryan Helinski
• Sam Doshi
• Simon Chopin
• Thomas Vander Stichele
• Wieland Hoffmann

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.