April 23, 2007 CDPLAY 1

### NAME

cdplay - compact disc player

### SYNOPSIS

cdplay [-a audio device] [-f device] [command ...]

### DESCRIPTION

cdplay is a program to control the audio features of a CD-ROM drive.

If no command is given, then cdplay enters interactive mode, reading commands from the standard input.

The following options are available:

-a audio device
  Specify the audio device to use. Used only in digital transfer mode. If not specified, the environment variables ```AUDIODEV` and ```SPEAKER` will be tried (in this order) to find the device; as a last resort, ```/dev/sound` will be used.

-f device
  Specify the control device to use. Both absolute paths and paths relative to ```/dev` are accepted. The suffix `c' (or `d' on some architectures, see disklabel(8) for details) is added to the device name if needed. If the device not specified, the environment variables ```MUSIC_CD`, ```CD_DRIVE`, ```DISC` and ```CDPLAY` will be tried (in this order) to find the device.

The available commands are listed below. Only as many characters as are required to uniquely identify a command need be specified. The word play can be omitted in all cases.

play[ first_track[ last_track]]
  Play from track first_track to track last_track. The first track has number 1.

play[ start_m:start_s.start_f[ end_m:end_s.end_f]]
  Play from the absolute address (MSF) defined by start_m in minutes, start_s, in seconds and start_f (frame number) to the absolute address defined by end_m in minutes, end_s, in seconds and end_f (frame number). Minutes are in the range 0-99. Seconds are in the range 0-59. Frame numbers are in the range 0-74.

play[ #start_block[ length]]
  Play starting from the logical block start_block using length logical blocks.

next
  Skip to the next track.

prev
  Skip to the previous track.

pause
  Stop playing. Do not stop the disc.

resume
  Resume playing. Used after the pause command.

shuffle
  Select shuffle play. Only valid in interactive mode.

single[ track]
  Pick a single track and play it repeatedly. If a track argument is not given the single command will shut shuffle mode off and play the disc normally. Only valid in interactive mode.

skip
  Skip to another track. Only valid when shuffle play is selected.

stop
  Stop the disc.

eject
  Eject the disc.

close
  Inject the disc.

volume left_channel right_channel
  Set the volume of left channel to left_channel and the volume of right channel to right_channel. Allowed values are in the range 0-255.

volume value
  Set the volume of both left channel right channel to value. Allowed values are in the range 0-255.

volume mute
  Turn the sound off.

volume mono
  Set the mono mode.

volume stereo
  Set the stereo mode.

volume left
  Play the left subtrack on both left and right channels.

volume right
  Play the right subtrack on both left and right channels.

info
  Print the table of contents.

status
  Display the current audio, media and volume status.

digital n
  Turn on digital transfer mode. In this mode, cdplay reads digital data from disc and sends it to an audio device. A SCSI or ATAPI CD-ROM is required; and the audio device must support CD audio format (44100 Hz sampling rate, 16-bit stereo samples). Audio data are read and written in groups of n frames (5 by default, or 1/15 seconds).

help
  Print the list of available commands.

reset
  Perform the hardware reset of the device.

set msf
  Set minute-second-frame ioctl mode (default).

set lba
  Set LBA ioctl mode.

quit
  Quit the program.

### FILES

```/dev/cd??`
```/dev/mcd??`

### SEE ALSO

disklabel(8), mscdlabel(8)

### HISTORY

The cdplay command first appeared in NetBSD1.5. Support for digital transfer mode was added in NetBSD4.0.