CDTOOL(1)

NAME
cdtool - play and catalog audio cds on a cdrom drive

SYNOPSIS
cdadd
cdeject
cdir -n [-s|-t]
cdpause
cdplay [start] [stop]
cdstop

DESCRIPTION
The cdadd command is a shell script which uses cdir -t and assists users in adding a new entry to the ~/.cdtooldb database file. It allows the user to edit a blank template database entry for the current compact disc, and then appends it to the file.

The cdeject command ejects the current compact disc.

The cdir command lists information about the currently loaded audio compact disc. In particular, it lists the lengths of all tracks. It also references the database files specified in the CDTOOLPATHDB environment variable and the ~/.cdtooldb file, which use a simplified version of the format used by workman(1). If one of these files contains an entry for the current compact disc, cdir will print title, artist, and track name information.

    -n  Do not lookup any information in the database files.

    -s  Print information in a short format: only author, title, and current track, all on one line.

    -t  Print a template for the current cd, including title, artist, and track name information if available. If blank lines are filled in, this can be appended to the ~/.cdtooldb file.

The cdpause command pauses the currently playing compact disc. Resume by using cdplay with no arguments.

The cdplay command plays the compact disc. If called with one argument, this is the starting track number. If called with two arguments, these are the starting and stopping track numbers.

The cdstop command stops the compact disc, if it is playing.

FILES
~/.cdtooldb - default database file.

ENVIRONMENT
CDTOOLDBPATH - colon delimited path of database files to search. It is not necessary to specify ~/.cdtooldb, as this is automatically added to the end of the search path.

CDTOOLDEV - device file for cd-rom, overrides compile-time defaults.

AUTHOR
Thomas Insel <tinsel@uiuc.edu>