How to for application developer

How to use gnudb.org


Configure your CDDB1- or freedb-aware software to point to gnudb.gnudb.org as your CDDB/freedb-server.

Make sure you are using a valid email address which can identify you. This enables the blocking of a users which are using gnudb in a way which is not appropriate. If you use a email address which other users also use, you risk being denied access to gnudb when on of the other users are misusing the gnudb service. It is not allowed to use the gnudb service anonymously. This has become necessary protect the server, do to purely programmed applications which sends tens of thousands request in a very short time frame.

All official gnudb servers are running cddbp at port 8880, http at port 80 and https at port 443. The path for http-access is /~cddb/cddb.cgi.

Access the main content of a xmcd file direct when you know the genre and discid,
https://gnudb.gnudb.org/~cddb/cddb.cgi?cmd=cddb+read+classical+270b8617&hello=emailname+emailhost.com+applicationname+0.1&proto=6

The gnudb.gnudb.org require a valid email and a application name and application version, it is free and will remain free for fair use.

If your favorite program does not support http 1.1 you can use the gnudb proxy, http://proxy.gnudb.org at port 3128
The proxy server will be removed, it is not necessary as the new server can handle requests without host header. If you are aware of a program which can not connect without the proxy, please write to info@gnudb.org



CDex setup: Make sure that you use a valid email.

CDex setup




Exact Audio Copy setup: Make sure that you use a valid email.

Exact Audio Copy




fre:ac setup: Make sure that you use a valid email.

fre:ac




MAGIX Audio Cleaning Lab 2016 setup: Make sure that you use a valid email.

MAGIX Audio Cleaning Lab 2016




Slink-e Nirvis Sony CD Jukebox changer (CDJ) setup: Make sure that you use a valid email.

Slink-e Nirvis Sony CD Jukebox changer (CDJ)




cddbget Linux Ubuntu

Open /usr/bin/cddbget and change as follows:
# $config{CDDB_HOST}="freedb.freedb.org"; # set cddb host ->
$config{CDDB_HOST}="gnudb.gnudb.org"; # set cddb host
# $config{CDDB_MODE}="cddb"; # set cddb mode: cddb or http, this is switched with -f ->
$config{CDDB_MODE}="http"; # set cddb mode: cddb or http, this is switched with -f
# $config{HELLO_ID} ="root nowhere.com fastrip 0.77"; # hello string: username hostname clientname version ->
$config{HELLO_ID} ="myemailname myemailhost cddbget 0.1"; # hello string: name gmail.com clientname version
Make sure that you use a valid email.
# $config{PROTO_VERSION} = 5; # cddb protokol version ->
$config{PROTO_VERSION} = 6; # cddb protokol version
Protocol level 6 is the same as level 5 except that the character set is now UTF-8 instead of ISO-8859-1. Level 6 is preferred.








GnuDB is non-commercial and depends on donations.


Do NOT follow this link or you will be banned from the site!