Section 1: cdplay
This page was been converted automatically, from Debian GNU/Linux
man pages.
CDTOOL(1) Unix Programmer's Manual CDTOOL(1)
NAME
cdtool - play and catalog audio CDROMs on CDROM drive(s)
SYNOPSIS
cdadd [-[0..9]|-d device]
cdeject [-[0..9]|-d device] [-V|-?|-h]
cdir -n [-[0..9]|-d device] [-r|-s|-t|-V|-?|-h]
cdinfo [-[0..9]|-d device] [-a|-r|-s|-t|-v|-V|-?|-h]
cdpause [-[0..9]|-d device] [-V|-?|-h]
cdplay [-[0..9]|-d device] [start [stop]
cdplay [-[0..9]|-d device] [+|- number]
cdplay [-[0..9]|-d device] [start|stop|resume|eject|info|dir]
cdplay [-[0..9]|-d device] [-V|-?|-h]
cdstop [-[0..9]|-d device] [-V|-?|-h]
cdvolume [-[0..9]|-d device] [-V|-?|-h|level]
cdshuffle [-[0..9]|-d device] [-V|-?|-h]
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 tem-
plate 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, includ-
ing title, artist, and track name informa-
tion if available. If blank lines are filled
in, this can be appended to the ~/.cdtooldb
file.
The cdinfo command, with no option used, will print out
the audiostatus (playing, etc.).
-a Print out the absolute disc time.
LOCAL 24-June-1998 1
CDTOOL(1) Unix Programmer's Manual CDTOOL(1)
-r Print out the relative track time.
-s Print out the audiostatus.
-t Print out the current track.
-v All info: status track absolute relative.
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. If the first argument is a + or -
then skip the number of tracks given by the second argu-
ment forward or backward. If no second argument is give,
skip one. A 0 as first argument or no argument replays
current track.
The cdstop command stops the compact disc, if it is play-
ing.
The cdvolume command sets the output volume level of the
CD player. The level is an integer from 0 to 255.
The cdshuffle command plays the audio tracks on the disc
in random order.
The default device opened is /dev/cdrom. This default and
others may be changed in config.h. Options supported by
all programs are:
-[0..7]
Multiple cdrom support to open
/dev/scd0../dev/scd7 [by default].
-d Multiple cdrom support to open device by
name.
[-h|-?]
Print out help for the command.
-V Print out version information and build
information.
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.
LOCAL 24-June-1998 2
CDTOOL(1) Unix Programmer's Manual CDTOOL(1)
CDTOOLDEV - device file for cd-rom, overrides compile-time
defaults.
SEE ALSO
cdctrl(1)
AUTHORS
Main code:
Thomas Insel
Enhancements:
Byron Ellacott
Wade Hampton
Lin Zhe Min
Sven Oliver Moll
Daniel R. Risacher
LOCAL 24-June-1998 3