History:FreeDB Gateway

From MusicBrainz Wiki
Revision as of 20:45, 4 June 2009 by Dupuy (talk | contribs) (Application instructions: add KDE system settings)

The MusicBrainz to FreeDB gateway (mb2freedb) is a service that allows FreeDB clients to access MusicBrainz data through the FreeDB protocol.

How to Access It

The mb2freedb gateway is setup at the Oregon State University Open Source Lab and can be accessed using the following settings:

host freedb.musicbrainz.org
via http
port 80
path /~cddb/cddb.cgi

It should be just a matter of changing the host and possibly the path, as the other settings are standard for most applications.

Application instructions

  • Exact Audio Copy (EAC): To access the "FreeDB / Database Options" page either press F12 or click the toolbar button EAC and scroll down to "FreeDB / Database Options". On the FreeDB Tab you will see the entry "FreeDB server". Enter "http://freedb.musicbrainz.org:80/~cddb/cddb.cgi" and click OK. That's it! (If you use version 0.95, see additional instructions).
  • MediaMonkey: Navigate to Tools >> Options.. then General >> Network (Proxy & FreeDB). Set the protocol to "HTTP" and host to "freedb.musicbrainz.org". User name and domain remain optional. If you receive socket 11004 errors, ensure that MediaMonkey has access out either your Windows or 3rd party firewall.
  • KDE: To set the CDDB preferences used by various KDE applications, open System Settings, select the Advanced tab, and double click on CDDB Retrieval. Make sure that you have checked Enable MusicBrainz lookup so that MusicBrainz is used directly if possible; then set the Freedb server to freedb.musicbrainz.org (the other settings default values are fine).


  • Because the gateway is running on a mirror server, any changes made on the main MusicBrainz site will take time to propagate, normally this is no more than a hour after the edit has been applied, but occasionally it can take longer.
  • CDs with data tracks such as videos are supported, but will return one less track than normally expected from FreeDB. This might cause a problem with some clients.
  • The genre will always be set to Unknown.
  • The year is always set to the first one on the matching database entry. As re-releases with the same track listing are always combined with the original, the year returned might not match that of the disc in hand.
  • Data is always returned in UTF-8 to cater for extended character sets. For most albums, this isn't a problem. But, for full compatibility a FreeDB client that supports protocol version 6 is required. If the characters look garbled in your FreeDB enabled application, this is probably the reason why.
  • Obviously only albums on MusicBrainz with Disc IDs attached will return matches!
    • If the album you want to check doesn't have your disc ID attached, follow the process on How To Add Disc IDs to add it.

Bug Reporting/Questions

Our Bug Tracker has a component for mb2freedb, please report all problems there, including as much detail as possible:

If you want to play with the source code, it's here: http://bugs.musicbrainz.org/browser/mb2freedb/trunk/