cdio
[-sv]
.Oo Fl d Ar host :
portOc
[-f device]
[commandargs]...
DESCRIPTION
The
cdio
program is a compact disc control utility,
with support for playing audio CDs and TAO CD writing.
If no command is given,
cdio
enters interactive mode, reading commands from the standard input.
The options are as follows:
-dhost:
Specifies a CDDB host
[default: freedb.freedb.org:cddb].
-f device
Specifies the name of the CD device, such as
/dev/rcd0c
or
mcd0.
Both absolute and relative paths to
/dev
filenames are possible;
the raw partition name is added if needed.
-s
Silent mode.
Do not print table headers or human-readable comments.
-v
Verbose mode.
Print as much information as possible.
The available commands are listed below.
Only as many characters as are required to uniquely identify a command
need be specified.
If no command is given,
only a track number or range,
then
play
is assumed.
blank
Minimally blank the disc.
cddb[n]
Print the Table Of Contents (TOC) after matching the disc with the CDDB.
In case of multiple matches, reissue the command with
n.
cdid
Print the disc ID that will be used for matching with the CDDB.
cdplay[track1-trackN]...
Play specified tracks from disk.
Unlike
play,
the CD player need not be connected to an audio device;
instead it rips tracks from disk and outputs audio data to
/dev/audio.
Both individual tracks and track ranges may be specified.
If range is specified in descending order tracks will be played in descending order.
If the first value in the range is omitted, tracks from first track on disk to the specified one will be played.
If the last value in the range is omitted, tracks from the specified track to the last track on disk will be played.
cdrip[track1-trackN]...
Rip specified tracks from disk.
Audio tracks are saved as WAVE sound files.
All tracks will be saved in the current working directory.
If parameters are omitted, all tracks are ripped.
Both individual tracks and track ranges may be specified, in the same format as the
cdplay
command.
close
Inject the disc.
debugon| off
Enable/disable the debugging mode of the CD device driver.
devicedevname
Make
devname
the current CD device.
This is the equivalent of quitting
cdio
and restarting with a different device.
eject
Eject the disc.
exit
A synonym for
quit.
help
Print the list of available commands.
info
Print the Table Of Contents (TOC).
next
Play the next track.
If we're at the last track, stop.
pause
Stop playing.
Do not stop the disc.
playfirst_track[last_track]
Play from track
first_track
to track
last_track.
The first track has number 1 and may be omitted in all cases.
[tr1]
m1:
[tr2]
.Oo Ar m2 : Ns Ar s2 Ns
[.f2 Oc]
Play from the absolute address
(MSF) defined by
m1
in minutes,
s1
in seconds,
frame number
f1,
to the absolute address defined by
m2
in minutes,
s2
in seconds,
frame number
f2.
If a track number is specified
(tr ),
then the minutes, seconds, and frame numbers
are relative to the start of that track.
Minutes are in the range 0\(en99.
Seconds are in the range 0\(en59.
Frame numbers are in the range 0\(en74.
play[#start_block[length]]
Play starting from the logical block
start_block
using
length
logical blocks.
previous
Play the previous track.
If we're at the first track, restart.
quit
Quit the program.
replay
Replay the current track.
reset
Perform a hardware reset of the device.
resume
Resume playing.
Used after the
pause
command.
setlba| msf
Set LBA
(lba)
or minute-second-frame
(msf)
ioctl mode.
The default is minute-second-frame ioctl mode.
status
Print information about the disc:
the current playing status and position,
the current media catalog status,
and the current values of the volume for left and right channels.
stop
Stop the disc.
[-ad]
[-s speed]
trackfile...
[command line only]
\ \&Write a track-at-once CD containing the specified
trackfile.
The options are as follows:
-a
Write files as audio tracks.
File formats of audio tracks may be CDDA or WAVE
with 2 channels of PCM audio,
signed 16-bit (little endian) values sampled at 44100 Hz.
-d
Write files as data tracks (the default).
-s speed
Specify a write speed for tracks.
speed
may be a numerical value between 1 and
the maximum speed supported by the media and drive,
or one of the literal strings
“auto”
or
“max”,
meaning the optimal or maximum speed detected.
volumeleft_channelright_channel
Set the volume of the left channel to
left_channel
and the volume of the right channel to
right_channel.
Allowed values are in the range 0\-255.
left\*(Ba
right\*(Ba
mono\*(Ba
stereo\*(Ba
mute
Respectively:
play the left subtrack on both left and right channels;
play the right subtrack on both left and right channels;
set mono mode;
set stereo mode;
turn the sound off.
ENVIRONMENT
DISC, CDROM
Specifies the name of the CD device to use.
If both
DISC
and
CDROM
are set,
DISC
takes precedence.
If neither
DISC
nor
CDROM
are set,
the default is
cd0.
See also the
-f
option, above.