README

Path: README
Last Update: Sat Feb 23 07:12:05 +0000 2019

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.2.2 (>= 0.3.0 for MCN and ISRC support)

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 (c) 2007-2013 Philipp Wolfer. It is free softare distributed under a BSD style license. See LICENSE for details.

$Id$

[Validate]