History:FreeDB Gateway: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(for the mb2cddb gateway running on inhouse's server (Imported from MoinMoin))
 
((Imported from MoinMoin))
Line 1: Line 1:
=MusicBrainz to CDDB Gateway=
=MusicBrainz to CDDB 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 CDDB gateway ('''mb2cddb''') is a service that allows [[CDDB]]/[[FreeDB]] clients to access MB-data through the CDDB protocol.


==How to Access It==
==How to Access It==
Line 10: Line 10:
via http
via http
port 80
port 80
path ~cddb/cddb.cgi
path /~cddb/cddb.cgi
</pre>
</pre>


It should be just a matter of changing the host, as the other settings are standard for most applications.
It should be just a matter of changing the host and probably 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 mod has been applied, but occasionally it can take longer.
Line 22: Line 22:
* The genre will always be set to ''Unknown''.
* The genre will always be set to ''Unknown''.
* Currently the year is not being set.
* 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
* 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.

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 30: Line 28:
==Bug Reporting / Questions==
==Bug Reporting / Questions==


At the moment, please report any issues back to inhouseuk via email, including as much detail as possible.
Our [[Bug Tracker|BugTracker]] has a component for mb2cddb, 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 album 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 I can check against my 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. ;)

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


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

Revision as of 23:48, 14 August 2006

MusicBrainz to CDDB Gateway

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

How to Access It

The mb2cddb 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 probably 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.

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.
  • The genre will always be set to Unknown.
  • 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.
  • 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 mb2cddb, 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://svn.musicbrainz.org/mb2cddb/trunk/.

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