Docs‎ > ‎OpenSource‎ > ‎


This project consists in a Linux Gnome application which provides a "caching proxy" function to Musicbrainz Web Service.  The services of this application is exposed through DBus.

Musicbrainz catalogs and uniquely identifies "music tracks" (i.e. mbid). Their web service  provides a convenient method for performing "music track title" (amongst other things) lookup in their extensive database. 

How it works
Applications interface with musicbrainz-proxy-dbus through the DBus.  Two (2) types of requests are supported:  normal & info, the former having priority in the processing pipeline.  A fixed number of outstanding requests is supported: pending requests exceeding this mark (>8000) are dropped (see "Requests dropped" indicator).

The indicator "Hits" refers to successful looked i.e. the entry was found in the local database whilst "Misses" means it wasn't found in the local database.  The indicator "Not found" maintains a count of attempts in finding an entry through the Musicbrainz Web Services without success i.e. the entry doesn't exist on Musicbrainz.

The indicator "Filtered" lists the requests dropped because their title were most likely erroneous: ["", "various", "various artist", "various artists", "original soundtrack", "soundtrack"]

The indicator "Retries Dropped" accounts for the requests made for already attempted entries that weren't found previsouly: each unsuccessful searches on Musicbrainz will be retried later but in order to avoid having the application being "blacklisted" by Musicbrainz, rate limiting is performed.

The indicators "Total Records" and "Records with Mbid" are self explanatory.  The "Job Queue" corresponds to the "depth" of "normal jobs" currently waiting to be processed whilst the "Job Info Queue" tracks the "info jobs".

  • Musicbrainz's web service is able to resolve "artist : track title" pairs flexibly: common syntax variants and unicode are supported
  • Requests to Musicbrainz's web service is "rate limited": a caching-proxy function thus help mitigate this constraint
There is currently only one application using musicbrainz-proxy-dbus:  lastfm-proxy-dbus.

  • The source code as well as additional information for this project is available here
  • Supported installation is accessible through here
  • The associated Ohloh page can be found here
Once the application is installed, it will be available through the Application --> Other menu item.

For developers
For those interested in using the services of this proxy, please see the interfacing guide Dbus API.


Google Moderator

Subpages (1): dbus-api