RBrainz is a Ruby client library to query the MusicBrainz database using the MusicBrainz XML web service.

RBrainz follows the design of the MusicBrainz client library reference implementation and supports the MusicBrainz XML Metadata Schema Version 1.2.

Usage:

A simple example on how to use RBrainz is shown below. For more detailed instructions see the API documentation.

require 'rbrainz'

include MusicBrainz

# With the ArtistInclude object we can control what
# kind of information the MusicBrainz server will
# include in its answer.
artist_includes = Webservice::ArtistIncludes.new(
:aliases => true,
:releases => ['Album', 'Official'],
:artist_rels => true,
:release_rels => true,
:track_rels => true,
:label_rels => true,
:url_rels => true
)

# Query the webservice for the artist with a given ID.
# The result will contain all the information
# specified in artist_includes.
query = Webservice::Query.new
id = 'c0b2500e-0cef-4130-869d-732b23ed9df5'
artist = query.get_artist_by_id(id, artist_includes)

# Display the fetched artist data together with
# all release titles.
print

What's New in This Release: [ read full changelog ]

· This is a bugfix release which fixes querying for release groups. This functionality was accidentally broken in 0.5.0.