MB-DiscID - Ruby bindings for MusicBrainz libdiscid

About

MB-DiscID provides Ruby bindings for the MusicBrainz DiscID library libdiscid. It allows you to calculate MusicBrainz DiscIDs from audio CDs which you can use to find the release entry for your CD in the MusicBrainz database.

Requirements

  • Ruby >= 1.8.6

  • libdiscid >= 0.1.0

Installation

Before installing rdiscid make sure you have libdiscid installed. See musicbrainz.org/doc/libdiscid for more information on how to do this.

Installation with RubyGems

gem install mb-discid

Installation on Windows operating systems.

For Windows a binary gem mb-discid-x.x.x-mswin32.gem is available. To install it follow the instructions below:

  1. Make sure you have at least Ruby 1.8.6 installed.

  2. Install RubyGems, if you don’t already have it.

  3. Download libdiscid-0.1.1-win32bin.zip from musicbrainz.org/doc/libdiscid.

  4. Copy the file discid.dll from libdiscid-0.1.1-win32bin.zip to your Ruby bin directory (normally C:\ruby\bin).

  5. Run gem install mb-discid to install MB-DiscID.

  6. To test the installation try to run examples/discid.rb.

Installing from source

rake install

Usage

See the documentation of MusicBrainz::DiscID or the example files in the examples directory for usage information.

Contact

MB-DiscID is part of the RBrainz project which provides a library to query the MusicBrainz XML web service. For more information about MB-DiscID or RBrainz visit rbrainz.rubyforge.org.

If you have any questions or suggestions regarding MB-DiscID please write to the rbrainz-user mailinglist. If you find bugs or if you have any feature requests please use the RBrainz bug tracker.

License

MB-DiscID is Copyright © 2007 Philipp Wolfer. It is free softare distributed under a BSD style license. See LICENSE for details.

$Id: README 298 2009-11-19 09:26:45Z phw $