History:FreeDB Gateway: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
((Imported from MoinMoin))
(s/cddb/freedb/ (Imported from MoinMoin))
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
=MusicBrainz to CDDB Gateway=
=MusicBrainz to FreeDB Gateway=


The [[MusicBrainz]] to CDDB gateway ('''mb2cddb''') is a service that allows [[CDDB]]/[[FreeDB]] clients to access MB-data through the CDDB protocol.
The [[MusicBrainz]] to [[FreeDB]] gateway ('''mb2freedb''') is a service that allows [[FreeDB]] clients to access MB-data through the [http://ftp.freedb.org/pub/freedb/misc/freedb_CDDB_protcoldoc.zip FreeDB protocol].


==How to Access It==
==How to Access It==


The mb2cddb gateway is setup on [[User:inhouseuk|inhouseuk]]'s test/development server and can be accessed using the following settings:
The mb2freedb gateway is setup on [[User:inhouseuk|inhouseuk]]'s test/development server and can be accessed using the following settings:


<pre>host www.mb.inhouse.co.uk
<pre>host www.mb.inhouse.co.uk
Line 13: Line 13:
</pre>
</pre>


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


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 mod has been applied, but occasionally it can take longer.
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.


==Limitations==
==Limitations==


* CD's with data tracks such as videos, will '''never''' return a match. This is because freedb clients always count the data track and include it in the query, thus resulting in one more track than stored in [[MusicBrainz]]. This is impossible to fix.
* CD's 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 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.
* Currently the year is not being set.
* Data is always returned in UTF-8 to cater with extended character sets. For most albums, this isn't a problem. But, for full compatability 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.
* Data is always returned in UTF-8 to cater with extended character sets. For most albums, this isn't a problem. But, for full compatability 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 ID|DiscID]]s attached will return matches!
* Obviously only albums on [[MusicBrainz]] with [[Disc ID|DiscID]]s 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|HowToAddDiscIDs]] to add it.
* If the album you want to check doesn't have your disc ID attached, follow the process on [[How To Add Disc IDs|HowToAddDiscIDs]] to add it.
Line 28: Line 28:
==Bug Reporting / Questions==
==Bug Reporting / Questions==


Our [[Bug Tracker|BugTracker]] has a component for mb2cddb, please report all problems there, including as much detail as possible:
Our [[Bug Tracker|BugTracker]] has a component for mb2freedb, please report all problems there, including as much detail as possible:
* Problem seen
* Problem seen
* Software and version
* Software and version
* The album url, eg: [http://musicbrainz.org/album/b84ee12a-09ef-421b-82de-0441a926375b.html http://musicbrainz.org/album/b84ee12a-09ef-421b-82de-0441a926375b.html]
* The release url, eg: [http://musicbrainz.org/album/b84ee12a-09ef-421b-82de-0441a926375b.html http://musicbrainz.org/album/b84ee12a-09ef-421b-82de-0441a926375b.html]
* The freedb id if you have it
* The [[FreeDB]] id if you have it
* approximate date/time, preferably in GMT/UTC so inhouseuk can check against his logs.
* approximate date/time, preferably in GMT/UTC so inhouseuk can check against his logs.


[[User:inhouseuk|inhouseuk]] will also surely answer any further questions about the service. ;)
[[User:inhouseuk|inhouseuk]] will also surely answer any further questions about the service. ;)


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


[[Category:To Be Reviewed]] [[Category:Products]]
[[Category:To Be Reviewed]] [[Category:Products]]

Revision as of 20:51, 4 May 2007

MusicBrainz to FreeDB Gateway

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

How to Access It

The mb2freedb gateway is setup on inhouseuk's test/development server and can be accessed using the following settings: 

host www.mb.inhouse.co.uk
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.

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.

Limitations

  • CD's 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 with extended character sets. For most albums, this isn't a problem. But, for full compatability 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 DiscIDs attached will return matches!
  • If the album you want to check doesn't have your disc ID attached, follow the process on HowToAddDiscIDs to add it.

Bug Reporting / Questions

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

inhouseuk will also surely answer any further questions about the service. ;)

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

Retrieved from "https://wiki.musicbrainz.org/index.php?title=History:FreeDB_Gateway&oldid=14391"