
freedbtool - a python program for interacting with the freedb.org database

Copyright (C) 2002  Robert Muth

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 2 of the License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

-------------------------------------------------------------------------

freedbtool consists of two components:

freedbtool.py - a script written in python 2.1
                The manpage is shown below                


discid - a program to dump the toc from a give cdrom device
         this program was written in C by  Jeremy D. Zawodny
         and needs to be compiled with the Makefile provided.
         The binary thus produced needs to be somewhere on your path.
         (type "make" to generate the discis binary)

-------------------------------------------------------------------------

Usage: freedbtool [mode] [option]*

Retrieve or submit information to and from the freedb.org database.
The mode parameter specifies the concrete command.
Options are used to change the default behavior of commands.
Currently available modes are: config,lscat,get,merge,submit
The model of operation of freedb tool is centered around 3 files characterizing a CD

id
         contains track length information for a CD,it is compatible with the cddb query command.
         A seperate tool discid is used to obtain this information.
index
         contains genre and checksum information for a CD, it is compatible with the freedb read command.
         This information is obtained by quering the freedb.org with the information in id.
toc
         contains the actual freedb.org database record for a CD.
         This information is obtained by quering the freedb.org with the information in index.

Options:

-t filename
        change default toc filename
-x filename
        change default index filename
-i filename
        change default id filename
-n number
        specify record number in case of multiple matches
-h domain
        specify domain part of user email
-u username
        specify username part of user email
-s server
        specify server
-d discid-command
        specify discid commandline
-m db submit-mode
        specify mode for submit command

Command description:

config
        print version and current defaults
motd
        print message of the day from freedb.org 
get
        get id, index, toc for current disc from freedb.org 
update
        update existing toc from freedb.org 
submit
        submit revised toc to freedb.org 
merge
        merge index info into toc file 
track
        merge/update track info from id file into toc file 



                    


