~4Dgifts/toolbox/utilities/cd-catalog README
this file hails from ftp://sgi.sgi.com/sgi/cd-catalog/README. it
refers to cd-catalog.changes.tar.Z which we are longer including
on the toolbox since this file only relects the changes over that
past 31 daze, *not* the past 90-120 daze when a new toolbox is
generated. FYI and all that glurb.....
cd-catalog.tar.Z last updated as of 10/13/95
______________________________________________________________________________
CDman MUSIC CATALOG
-------------------
This directory contains music catalog files for CDman(1) and
cdplayer(1) [See note 1]. The music catalog stores titles, artists and
program information for Compact Discs. When a CD is inserted in the
CD-ROM drive, CDman searches the music catalog for an entry containing
catalog information for that recording. If it finds one, it displays
the information in its large display panel. Data from the recording's
table of contents is used as the key for searching the music catalog.
See CDman(1) for details.
We recommend you install this catalog in the directory /usr/lib/cddb
and have your users put the following line in their .Xresources file:
[See Note 1]
DATman*databasePath: /usr/lib/cddb
DATman*databaseCDir: /usr/lib/cddb
If you want to keep the catalog write protected your users should put
the following lines in their .Xresources file so your users can add new
entries:
DATman*databasePath: ${HOME}/.cddb:/usr/lib/cddb
DATman*databaseCDir: ${HOME}/.cddb
[**IMPORTANT NOTICE: All versions of CDman prior to that in IRIX 5.0,
have a bug that makes the databasePath resource (and the CDDB_PATH
environment variable) useless. Nothing in the path will be searched.
Only databaseCDir is searched.]
With a write protected catalog, you will have to periodically gather
the new entries from your users' private catalogs and add them to the
public database.
A user who simply wants his own private database would also use these
latter X resource settings.
The catalog consists of a set of ASCII files, with one file per catalog
entry. The catalog is distributed as a compressed tar file
cd-catalog.tar.Z. The distribution is updated on the 1st of each
month. The file cd-catalog.changes.tar.Z contains entries added during
the past month. The paths of the files in the tar archives are
relative to the parent directory "cddb".
New entries, in the same format as the distribution, (a uuencoded,
optionally compressed, tar file), can be emailed to
cd-catalog@sgi.sgi.com for inclusion in the master database.
Suggested Format for Entries
----------------------------
Most music genres are relative easy to catalog. Our only
recommendation here is to follow the artist's lead in capitalization
and spelling of titles. Classical music presents some unique problems
and is the focus of this section. Our recommended format is:
Title: <Title> '<Popular name>' [<key>, <opus or K number>]
Artist: <composer>/<conductor>,<orchestra>,<recording year>/<soloist>,...
Track Title: <movement>. <Title>
Examples:
Title:
Symphony No. 9 'Choral' [D-minor, op 125]
Artist:
Beethoven/Schmidt,Wiener Phil,1986/Sutherland,Horne,King
Track Titles:
I. Allegro ma non troppo, un poco maestoso
II. Molto Vivace
[Note 1] A version of cdplayer that works correctly with this database
is available for ftp from sgi in the file
~ftp/sgi/cd-catalog/cdplayer.tar. The only previous version
of cdplayer that would work with this database was released in
IRIX 4.0.5MM (Media Mosaic). Unfortunately, when Media Mosaic
was folded into 4.0.5F, the wrong version of cdplayer was put
in. The correct version will be released in IRIX 5.0.
The Media Mosaic version of cdplayer(1) does not understand
the X resource to locate the CD catalog and it has a couple of
other bugs related to handling the database. Please install
the new version available for ftp as described above.
Earlier cdplayer(1) catalogs can be converted to the new
format. using cddbcvt(1). See CDman(1) for details.
Unfortunately,
[Note 2] The catalog format allows for a different artist for each
track but the user interfaces do not yet let you enter more
than one artist per CD.
[Note To SGI Employees]
If you have access to the SGI network, don't make your own copy
of this catalog. Instead NFS mount the master catalog from
bambi.esd:/usr/local/lib/cddb so that we will automatically
collect your additions.
Documentation
Already Built tar Files
OR, ...