CDPLAY(1) | General Commands Manual | 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. If the “`-a`” command line option is used, or the `CDPLAY_DIGITAL` environment variable is present, digital transfer mode is switched on automatically.
`-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).
`analog`
  Switch from digital back to analog mode.
`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 NetBSD 1.5. Support for digital transfer mode was added in NetBSD 4.0.

January 3, 2012 | NetBSD 9.0