Status: Deprecated as of May 2011. This library is not compatible with the current MusicBrainz schema, but will still work with older versions and with the ws/1 legacy web service.

The python-musicbrainz2 package is a client library written in python that provides easy object oriented access to the MusicBrainz Database using the XML Web Service. It has been written from scratch and uses a different model than its predecessor, python-musicbrainz.

API documentation can be created from the source code using epydoc and is also available online. The source distribution comes with example code which demonstrates some of the most important features.

Questions about python-musicbrainz2 can be asked on the MusicBrainz developers mailing list.


download.gifpython-musicbrainz2-0.7.4.tar.gz (current release)
MD5: 40ac802d832deca737cce57235cb23a5


The python-musicbrainz2 library is licensed under a BSD style license.

Source Code

The source code of python-musicbrainz2 is available using anonymous Subversion access. Read the Subversion document for instructions on how to use Subversion and checkout the python-musicbrainz2 source code. Alternatively, you can browse the python-musicbrainz2 Subversion repository directly using the source browser.

svn checkout python-musicbrainz2


If you find a bug, please report it on the bug tracker (use python-musicbrainz2 as the component) after checking to make sure it hasn't been listed yet. Also make sure you have read the relevant documentation (README.txt, INSTALL.txt, API documentation, FAQs) before doing so. Bugs regarding the XML Web Service itself should be filed under the XML Webservice component.


ctypes 0.9.6 doesn't compile using gcc-4.0 on Mac OS X

According to 1157, you have to patch ctypes to make it compile. There is a patch against ctypes-0.9.6. You may also use ctypes- or later which seems to compile, but this version doesn't work with the old python-tunepimp package, so picard-0.6 won't work. picard-0.7 doesn't require the old python-tunepimp anymore and will work.

Previous Version

python-musicbrainz was a python wrapper for libmusicbrainz that used the RDF web service, it was a straight python to c binding, and used ctypes to avoid having to write c code. It has been deprecated and replaced with python-musicbrainz2.

Next Version

Planning for the next version of the library, supporting the NGS schema was at python-musicbrainz3. However that was never finished and python-musicbrainzngs is a working binding for the NGS schema. You can use python-discid if you need support for reading Disc IDs.