Skip to main content

Python bindings for the MusicBrainz NGS and the Cover Art Archive webservices

Project description

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 http://wiki.musicbrainz.org/XML_Web_Service.

Usage

# 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:

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

musicbrainzngs-0.7.1.tar.gz (117.5 kB view hashes)

Uploaded source

Built Distribution

musicbrainzngs-0.7.1-py2.py3-none-any.whl (25.3 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page