Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CDA(1)			    General Commands Manual			CDA(1)

NAME
       cda - Compact disc digital audio	player utility

SYNOPSIS
       cda [-dev device] [-batch] [-debug level#] [-online | -offline] command

DESCRIPTION
       Cda  is a program that allows the use of	the CD-ROM, CD-R, CD-RW	or DVD
       drive as	a full-featured	stereo compact-disc player and	"ripper"  from
       the  shell  command line.  It can be used interactively in line mode or
       visual (screen) mode,  or  as  a	 script-driven	utility.   This	 is  a
       companion utility to xmcd(1), a Motif-based CD audio player application
       for the X window	system.	 Cda uses the same configuration  and  support
       files as	xmcd.

       Most  of	 the features found on "real" CD players are available in cda,
       such as shuffle and repeat, and track programming functions.

       CDDA (CD	digital	audio) data extraction,	 playback,  save-to-file,  and
       pipe-to-program	are  supported on many platforms.  For data extraction
       to file or pipe,	cda can	generate the data in  MP3  (MPEG-1  layer  3),
       MPEG-2/MPEG-4  AAC, MP4 Ogg Vorbis, FLAC, WAV, AU, AIFF,	AIFF-C and raw
       headerless formats.  Simultaneous extraction to file/pipe and real-time
       playback	is possible on high performance	computers.

       Multi-disc  changers are	also supported.	 You can switch	to a soecified
       disc, select to play only a single  disc	 or  auto-play	all  discs  in
       normal or reverse order.

       The   Gracenote	 CDDB(R)  Music	 Recognition  Service(sm)  feature  is
       supported by cda, which allows the CD artist/title  and	track  titles,
       and  other  information	associated with	the loaded CD to be displayed.
       For CDDA	extraction to MP3, MP4,	Ogg Vorbis and FLAC formats,  cda  can
       auto-fill the CD	information tags embedded in these files.

       This release of cda supports the	enhanced Gracenote CDDB2(R) service on
       a number	of platforms, and offers much richer features and content than
       the  "classic"  CDDB.   Moreover,  CDDB2-supplied information is	now in
       UTF-8 data  format,  providing  international  language	support.   See
       "LOCALIZATION" below.

       In  addition to CDDB, this release of cda supports reading CD-TEXT data
       from the	disc for the disc/track	artist and title information.

       No capability is	provided to add, modify	or submit CDDB entries in cda.
       You  must  use  the  X-based  xmcd(1)  utility (or another CDDB-enabled
       application with	the appropriate	features) for that purpose.

       On systems with more than one CD	drive, multiple	invocations of cda can
       be used to operate each drive independently.

       Cda  is	designed to be easy to use, with particular care taken to make
       all output easily parsable by other programs.

       The internal architecture of cda	is designed to be easily  portable  to
       many  UNIX operating system variants, and adaptable to the myriad of CD
       drives available.

OPTIONS
       Cda supports the	following options:

       -dev device
	      Specifies	the path name to the raw CD device.  If	this option is
	      not  used,  the default device to	be used	is the first drive set
	      up with the xmcd configuration program (See below).

       -batch Signifies	that cda should	run in batch  mode.   This  suppresses
	      all interaction with the user (i.e., will	not prompt the user to
	      type anything).  Batch mode is not meaningful in visual mode.

       -online,	-offline
	      Forces cda to enable or disable Internet access.	If this	option
	      is  not  specified,  then	 the  default  is  configured  via the
	      internetOffline parameter	in the common.cfg  file.   In  offline
	      mode,  CDDB  lookup  will	 only  be  done	 from the local	cache.
	      Please note that the daemon as well  as  the  client  will  both
	      perform CDDB lookups.  If	you want to disable Internet access in
	      both, then the -offline option should be used when you start the
	      daemon via the cda on command, as	well as	when you issue any cda
	      client command.

       -debug level#
	      Causes verbose debugging diagnostics to be displayed on  stderr.
	      Note  that  if you are running in	visual mode, the stderr	output
	      should be	redirected to a	file, or the  debug  information  will
	      corrupt  the  screen.  The level specifies the type of debugging
	      messages desired:

	      1	   General debugging
	      2	   Device I/O debugging
	      4	   CD information debugging
	      32   Sound DSP and output	file/pipe debugging
	      64   Message of the day debugging

	      You may add the values together  to  enable  multiple  debugging
	      types  (i.e.,  A value of	3 turns	on both	General	and Device I/O
	      debugging).

COMMANDS
       Cda supports the	following commands:

       on     Start the	cda daemon.

       off    Terminate	the cda	daemon.

       disc _load | eject | prev | next	| disc#_
	      Load or eject the	CD, or change discs on a multi-disc changer.

       lock _on	| off_
	      Enable/disable the CD disc lock.	When locked, the CD cannot  be
	      ejected  using  the  CD drive front-panel	eject button.  You can
	      only change the lock state when  a  CD  is  loaded  and  is  not
	      playing.

       play [track# [mm:ss]]
	      Start playback.  If the track# is	used, the playback starts from
	      the specified track.  The	optional mm:ss argument	specifies  the
	      minutes  and  seconds  offset into the track from	where to start
	      playback.

       pause  Pauses the playback.  Use	cda play to resume playback.

       stop   Stop the plaback.

       track _prev | next_
	      Proceed to the previous or the next track.  This command is only
	      valid when playback is already in	progress.

       index _prev | next_
	      Proceed to the previous or the next index.  This command is only
	      valid when playback is already in	progress.

       program [clear |	save | track# ...]
	      If no argument is	specified, this	command	displays  the  current
	      program  play  sequence,	if any.	 The clear argument will cause
	      the current program to be	cleared.  The save argument will  save
	      the  current  program, so	that a future load of the same CD will
	      automatically  get  the  program	sequence.   To	define	a  new
	      program,	specify	 a  list of track numbers separated by spaces.
	      To start program play, use the play command.  You	cannot	define
	      a	new program while shuffle mode is enabled.  Entering a program
	      will disengage shuffle mode.

       shuffle _on | off_
	      Enable/disable shuffle play mode.	 When shuffle is enabled,  cda
	      will  play  the  CD  tracks in a random order.  You can use this
	      command only when	audio playback is not in progress.  Also,  you
	      must clear any program sequence before enabling shuffle.

       repeat _on | off_
	      Enable/disable the repeat	mode.

       volume [value# |	linear | square	| invsqr ]
	      If  no  argument is specified, this command displays the current
	      audio volume and taper setting.  If a value is  used,  then  the
	      audio  volume  level  is	set to the specified value.  The valid
	      range is 0 to 100.  If  one  of  linear,	square	or  invsqr  is
	      specified, then the volume control taper is set to the specified
	      curve.  This control operates the	hardware volume	control	on the
	      CD  drive	 in  standard  playback	 mode, or the computer's audio
	      hardware in cdda-play mode.  It has no effect on the data	of the
	      cdda-save	or cdda-pipe outputs.

       balance [value#]
	      If  no  argument is specified, this command displays the current
	      balance control setting.	If a value is used, then  the  balance
	      is  set  to  the	specified value.  The valid range is 0 to 100,
	      where 0 is full left, 50 is center and 100 is full right.	  This
	      control  operates	the hardware volume control on the CD drive in
	      standard playback	mode, or  the  computer's  audio  hardware  in
	      cdda-play	 mode.	 It has	no effect on the data of the cdda-save
	      or cdda-pipe outputs.

       route [stereo | reverse | mono-l	| mono-r | mono	| value#]
	      If no argument is	specified, this	command	displays  the  current
	      channel routing setting.	Otherwise, to set the routing, use one
	      of the appropriate keywords or a value as	follows:

	      0	   Normal stereo
	      1	   Reverse stereo
	      2	   Mono-L
	      3	   Mono-R
	      4	   Mono-L+R

       outport [speaker	| headphone | line-out | value#]
	      CDDA playback output port	selection.  The	speaker, headphone and
	      line-out keywords	are toggles.  Alternatively, you may specify a
	      numeric value, as	follows:

	      1	   Speaker
	      2	   Headphone
	      4	   Line-out

	      You may add the values together to enable	multiple output	 ports
	      (i.e., A value of	3 turns	on both	Speaker	and Headphones).  When
	      the value	is set to 0, the port setting is  unmodified.	If  no
	      argument	is specified, this command displays the	current	output
	      port setting.  Note that this command may	be meaningful only  on
	      some  platforms,	and  only  certain ports may be	available on a
	      particular architecture.	See the	PLATFORM file for details.

       cdda-att	[value#]
	      If no argument is	specified, this	command	displays  the  current
	      CDDA  attenuator	setting.   If  a  value	is used, then the CDDA
	      attenuator level is set to the specified value.  The valid range
	      is  0 to 100.  Note that in contrast to the volume command, this
	      setting does not operate any hardware.  It works by scaling  the
	      CDDA  audio samples, and thus has	no effect in standard playback
	      mode, but	affects	all CDDA modes (cdda-play, cdda-save and cdda-
	      pipe).

       status [cont [secs#]]
	      Display  the  current  disc  status,  disc number, track number,
	      index number, time,  modes,  and	repeat	count.	 If  the  cont
	      argument	is  specified,	then the display will run continuously
	      until the	user types the interrupt character  (typically	Delete
	      or  Ctrl-C).   The  optional  secs  sub-argument	is the display
	      update time interval.  The default is 1 second.

       toc [offsets]
	      Display the CD Table of Contents.	  The  disc  artist/title  and
	      track  titles  associated	 with  the  current disc, queried from
	      CDDB, is also shown.   If	 the  disc  has	 associated  notes  or
	      credits,	 an   asterisk	 (*)  is  displayed  after  the	 genre
	      description.  Similarly, if a  track  has	 associated  notes  or
	      credits, an asterisk is displayed	after the track	title.

	      If  the CDDB server cannot determine an exact match for your CD,
	      but found	a list of possible matches,  then  the	user  will  be
	      prompted	to  select  from  that	list.  If batch	mode is	active
	      (i.e., the -batch	option is used),  then	no  such  prompt  will
	      occur.

	      If  the  offsets	argument is used, then the track times are the
	      absolute offsets from the	start of the CD.  Otherwise, the times
	      shown are	the track lengths.

       extinfo [track#]
	      Display  extended	information associated with the	current	CD, if
	      available	from CDDB.  If	the  CD	 is  currently	playing,  then
	      extended	information  associated	with the playing track is also
	      displayed.  If a track number is used in the argument, then  the
	      extended information of the specified track is shown instead.

       notes [track#]
	      Display  disc notes information text associated with the current
	      CD, if available from CDDB.  If the  CD  is  currently  playing,
	      then  the	 track	notes  information associated with the playing
	      track is also displayed.	If a  track  number  is	 used  in  the
	      argument,	then the track notes information text of the specified
	      track is shown instead.

       on-load [none | spindown	| autoplay | autolock |	noautolock]
	      Display, enable or disable options when a	 CD  is	 loaded.   The
	      spindown	option	will  cause  the  CD  to stop after loading to
	      conserve the laser and motor.  The autoplay  option  will	 cause
	      the  CD  to  automatically  start	 playing  after	 loading.  The
	      autolock	option	causes	the  caddy  or	 disc	tray   to   be
	      automatically  locked.   The none, spindown and autoplay options
	      are mutually-exclusive.	If  no	argument  is  used,  then  the
	      current settings are displayed.

       on-exit [none | autostop	| autoeject]
	      Display,	enable	or  disable options when the cda daemon	exits.
	      The autostop option will cause cda to  stop  playback,  and  the
	      autoeject	 option	 will  cause cda to eject the CD.  Use none to
	      cancel these options.  If	no argument is used, then  te  current
	      settings are displayed.

       on-done [autoeject | noautoeject	| autoexit | noautoexit]
	      Display,	enable	or  disable  options  when  cda	 is  done with
	      playback.	 The autoeject option causes the cda daemon  to	 eject
	      the  CD.	The autoexit option will cause the cda daemon to exit.
	      If no argument is	used, then the current settings	are displayed.

       on-eject	[autoexit | noautoexit]
	      Display, enable or disable options when cda ejects  a  CD.   The
	      autoexit option will cause the cda daemon	to exit	after ejecting
	      the CD.  If no argument is used, then the	current	 settings  are
	      displayed.

       changer [multiplay | nomultiplay	| reverse | noreverse]
	      Display,	enable	or  disable  multi-disc	 changer options.  The
	      multiplay	option specifies that cda plays	all discs in sequence.
	      The  nomultiplay option will cause cda to	stop after the current
	      disc is done.  The reverse option	implies	multiplay, except that
	      the  disc	 order	is reversed.  If no argument is	used, then the
	      current settings are displayed.

       mode [standard |	cdda-play | cdda-save |	cdda-pipe]
	      Selects the playback mode.  If no	argument  is  used,  then  the
	      current  setting	is  displayed.	See "PLAYBACK MODES" below for
	      details about the	modes.	Please note that the  cdda  modes  are
	      toggles.	If the current mode is cdda-play, specifying cdda-save
	      will enable both cdda-play and cdda-save	modes.	 Specifying  a
	      cdda  mode  twice	 will  disable	that mode.  If no cdda mode is
	      active, then the	mode  will  revert  to	standard.   Specifying
	      standard mode will disable all cdda modes.

       jittercorr [on |	off]
	      Enables  or  disables CDDA jitter	correction.  If	no argument is
	      used, then the current setting is	displayed.

       trackfile [on | off]
	      For CDDA-save mode, specifies whether a separate file should  be
	      created  for  each  CD  track.  If no argument is	used, then the
	      current setting is displayed.

       subst [on | off]
	      For CDDA-save mode, specifies whether space and  tab  characters
	      in  the  output  file  path  name	 should	 be  substituted  with
	      underscores ('_').  This makes the files	easier	to  manipulate
	      while  using  the	 UNIX  command shell.  If no argument is used,
	      then the current setting is displayed.

       filefmt format
	      Specifies	the output audio file format if	running	 in  cdda-save
	      or  cdda-pipe  modes.   The format is one	of the following: raw,
	      au, wav, aiff, aiff-c, mp3, ogg, flac, aac or mp4.

       outfile ["template"]
	      Specifies	the output audio file path name	if  running  in	 cdda-
	      save  mode.   If no argument is used, then the currently defined
	      template is displayed.  See the xmcd help	 file  on  the	output
	      file path	template for information about the special tokens that
	      could be used in the template.

       pipeprog	["path [arg ...]"]
	      Specifies	the external program to	which the audio	stream will be
	      piped  to	 when  running	in  cdda-pipe mode.  If	no argument is
	      used, then the currently defined program is displayed.

       compress	[_0 | 3_ [bitrate#] | _1 | 2_ [qual#]]
	      Selects the compression mode for	compressed  file  formats,  as
	      follows:

	      For MP3, the modes are as	follows:
	      0	   Constant bitrate (CBR)
	      1	   Variable bitrate (VBR, old algorithm)
	      2	   Variable bitrate (VBR, new algorithm, faster)
	      3	   Average bit rate (ABR)

	      For Ogg Vorbis and MP4, all modes	are VBR, as follows:
	      0, 3 Use an average bit rate
	      1, 2 Use a quality factor

	      For FLAC,	the modes are as follows:
	      0	   None
	      1	   Enable exhaustive LP	coefficient quant. search
	      2	   Enable encoding correctness verification
	      3	   Enable both

	      For AAC, all modes are VBR, as follows:
	      0	   Use an average bit rate, MPEG-2
	      1	   Use a quality factor, MPEG-2
	      2	   Use a quality factor, MPEG-4
	      3	   Use an average bit rate, MPEG-4

	      For  modes  0  and 3, an optional	bitrate	(in kb/s) sub-argument
	      can be specified.	 The supported bitrates	are a discrete set  of
	      numbers  from  32	 to  320.   A  value  of 0 can also be used to
	      indicate the use of an internal default.	For modes 1 and	2,  an
	      optional quality factor (from 1 to 10) sub-argument can be used.
	      Lower bitrates and quality factor	 values	 yield	smaller	 files
	      whereas  higher  numbers	produce	higher audio quality.  For AAC
	      and MP4 formats, the bitrate you	specify	 will  be  double  the
	      actual bitrate (e.g., if you specify 128kbps, the	actual bitrate
	      used will	 be  64kbps).	The  bitrate  or  quality  values,  if
	      specified,  are  ignored for the FLAC format.  If	no argument is
	      used, then the current settings are displayed.

       min-brate [bitrate#]
	      In average bitrate and variable  bitrate	modes,	this  commands
	      lets you specify a low bitrate limit.  The encoder will not drop
	      below this limit while  dynamically  changing  the  bitrate.   A
	      value  of	 0 can be specified to indicate	the use	of an internal
	      default.	If no argument is used,	then the  current  setting  is
	      displayed.  This parameter has no	effect on the FLAC, AAC	or MP4
	      format.

       max-brate [bitrate#]
	      In average bitrate and variable  bitrate	modes,	this  commands
	      lets  you	specify	a high bitrate limit.  The encoder will	not go
	      above this limit while  dynamically  changing  the  bitrate.   A
	      value  of	 0 can be specified to indicate	the use	of an internal
	      default.	If no argument is used,	then the  current  setting  is
	      displayed.  This parameter has no	effect on the FLAC, AAC	or MP4
	      format.

       coding [stereo |	j-stereo | force-ms | mono | algo#_]fR
	      This  command  selects  the  stereo  mode	 and  encoding	noise-
	      shaping/psychoacoustics algorithm.  If no	argument is used, then
	      the current settings are displayed.

	      For MP3, the algorithm is	a number from 1	to 10.	Lower  numbers
	      gives  faster  encoding  whereas	higher	numbers	produce	higher
	      audio quality.

	      For AAC and MP4, stereo disables the mid/side  coding,  j-stereo
	      and  force-ms  are  synonymous,  and  mono is not	supported.  An
	      algorithm	value of 10 enables temporal noise shaping (TNS).

	      For FLAC,	the stereo modes have no  effect,  but	the  algorithm
	      value  selects  between  faster  encoding	versus slightly	better
	      compression.

	      For Ogg Vorbis, this parameter has no effect.

       lowpass [off | auto | freq# [width#]]
	      This allows a lowpass filter to be added.	 The off setting means
	      no  filter,  the	auto  setting  causes the encoder to determine
	      whether a	filter should be added and its parameters.  Specifying
	      a	 frequency (and	optionally, a width) will enable the filter in
	      manual mode.  The	frequency and width are	both in	Hz.  The valid
	      frequency	 range	is  from  16 to	50000 Hz.  For MP3, the	filter
	      functions	fully as described.  For AAC and MP4, the freq can  be
	      used  to limit the bandwidth, but	the width is ignored.  For Ogg
	      Vorbis and  FLAC,	 these	parameters  have  no  effect.	If  no
	      argument is used,	then the current settings are displayed.

       highpass	[off | auto | freq# [width#]]
	      For  encoding  to	MP3 files, this	allows a highpass filter to be
	      added.  The off setting means no filter, the auto	setting	causes
	      the  encoder  to	determine whether a filter should be added and
	      its parameters.	Specifying  a  frequency  (and	optionally,  a
	      width) will enable the filter in manual mode.  The frequency and
	      width are	both in	Hz.  The valid frequency range is from 500  to
	      50000  Hz.   The	lower limit is imposed by the polyphase	filter
	      implementation in	the MP3	encoder.  For non-MP3  formats,	 these
	      parameters  have	no  effect.   If no argument is	used, then the
	      current settings are displayed.

       flags [C|c][O|o][N|n][E|e][I|i]
	      This allows you to specify some MP3 header and frame flags.  The
	      letter  c	denotes	the "copyright"	flag, the letter o denotes the
	      "original" flag, the letter n  denotes  the  "no	res"  (no  bit
	      reservoir)  flag,	 the letter e denotes the addition of a	2-byte
	      checksum to each frame for error correction, and	the  letter  i
	      indicates	 strict	 ISO  compatibility.   The use of a upper-case
	      letter turns on the flag,	and lower-case	turns  off  the	 flag.
	      Multiple	flags  may  be	specified together.  If	no argument is
	      used, then the current settings are displayed.

       lameopts	[_disable | insert | append | replace_ ["options"]]
	      This command allows you to query or set command line options  to
	      be  passed  directly  to	the  LAME MP3 encoder, and control how
	      those options will be  passed.   This  facilitates  the  use  of
	      advanced	or experimental	LAME features that cannot otherwise be
	      invoked via the cda command line interface for setting  encoding
	      parameters.  The following keywords control how the command line
	      options are to be	passed:

	      disable: No additional command line options are to be passed.
	      insert: The specified options are	 to  be	 inserted  before  the
	      standard options.
	      append:  The  specified  options	are  to	 be appended after the
	      standard options.
	      replace: The specified options are to be	used  instead  of  the
	      standard options.

	      Standard	options	 refers	 to the	LAME command line options that
	      cda generates, based on the current settings (and	can be altered
	      by  other	 encoding related cda commands above).	If no argument
	      is used, then the	current	settings are displayed.

       tag [off	| v1 | v2 | both]
	      This command specifies whether CD	information (such as album and
	      track  artists  and titles, genre	type, etc.) should be added to
	      the CDDA output file.  For MP3,  the  information	 is  added  to
	      either  the version 1, version 2 or both versions	of the ID3 tag
	      areas.  For Ogg Vorbis, FLAC and MP4, the	information  is	 added
	      to the metadata area.
	      Note: An ID3v2 tag will not be added to the cdda-pipe MP3	stream
	      regardless of the	setting	of this	command.

       device Displays the CD drive and	device information.

       version
	      Displays the cda version and copyright information.

       cddbreg
	      Invoke dialog to register	with Gracenote in order	to access  the
	      CDDB2  service.	This  command  can  be	used to	do the initial
	      registration, as well as to change or update  user  registration
	      information.   This function is not available with the "classic"
	      CDDB service.

       cddbhint
	      Ask Gracenote to send the	password hint  via  e-mail.   This  is
	      used  in	case  you forget the CDDB user password.  The password
	      and password  hint  are  both  initially	set  via  the  cddbreg
	      command.	This function is not available with the	"classic" CDDB
	      service.

       motd   Retrieve and display messages from the xmcd MOTD server, if any.
	      Note  that  messages are displayed by the	cda daemon rather than
	      the client process.  Thus, it will be displayed on the  terminal
	      where the	daemon was started.

       debug [level#]
	      Show,  or	 set  the  debug  level.   If  set,  verbose debugging
	      diagnostics will be printed on stderr of the terminal  that  the
	      cda  daemon  is started from.  If	this is	the same terminal that
	      is running cda  in  visual  mode,	 the  debug  information  will
	      corrupt  the  screen.   See the description of the -debug	option
	      above for	supported debug	levels.

       visual Enter an interactive, screen-oriented visual mode.   Most	 other
	      cda commands can also be invoked within this mode.

DEVICE CONFIGURATION
       See xmcd(1) for a description of	the device configuration requirements.

       WARNING:	 If  cda  is  not  correctly  configured, you may cause	cda to
       deliver commands	that are not supported by your CD drive.   Under  some
       environments this may lead to system hang or crash.

USING CDA
       Start the cda daemon with the cda on command (or	the F1 (o) function in
       visual mode).  This reserves the	CD device and initializes the  program
       for further commands.  All other	cda functions will not work unless the
       cda  daemon  is	running.   The	other  cda  commands  should  be  self
       explanatory.

       The  off	command	(or the	F1 (o) function	in visual mode)	can be used to
       terminate the cda daemon	and release the	CD  drive  for	use  by	 other
       software.

VISUAL MODE
       If  the	cda visual command is used, it enters a	screen-oriented	visual
       mode.  In this mode, the	status	and  other  information	 available  is
       continuously  displayed	and  updated on	the screen, and	most functions
       are available via a single key stroke.

       The minimum terminal screen size	for the	visual mode is 80 columns by 9
       rows.   If  your	terminal is made to be smaller than that (for example,
       an xterm(1) window that has been	sized too small), the output  will  be
       garbled.	  For  best results, an	80x24 or larger	terminal screen	should
       be used.

       Visual mode uses	the curses screen library to control the  screen.   It
       is  essential  that  the	 TERM environment variable reflect the current
       terminal	type, which ideally should have	8  (or	more)  function	 keys.
       Since  function	key  definitions  in  terminfo	descriptions are often
       unreliable, alphabetic key alternatives are also	available.

       The screen is divided into two windows: an  information	window	and  a
       status window.  According to context, the information window displays a
       help screen, device and version information, disc information and table
       of  contents,  or extended information about the	track.	This window is
       scrollable if it	overflows its allotted screen area.  The status	window
       consists	 of  the last few lines	of the screen, enclosed	in a box.  The
       first line contains the	program	 list,	or  track  number  and	offset
       together	  with	volume,	 balance  and  stereo/mono  information.   The
       remaining lines	contain	 the  function	keys  (with  their  alphabetic
       synonymns)   and	 the  functions	 they  invoke.	 These	functions  are
       highlighted when	they are on, making it easy to see the current state.

       Screen annotation and online help make operation	self explanatory,  but
       for  reference, a list of commands follows. Alphabetic key alternatives
       to function keys	are given in parenthesis.

       ?      Display help screen. Dismiss this	screen by pressing  the	 space
	      bar.

       F1 (o) On/Off. Start or stop the	cda daemon.

       F2 (j) Load or eject the	CD.

       F3 (p) Play, pause or unpause.

       F4 (s) Stop.

       F5 (k) Enable/disable  the CD caddy lock. When locked, the CD cannot be
	      ejected using the	CD drive front-panel eject button.

       F6 (u) Shuffle/Program.	Pressing this key cycles through three states:
	      normal,  shuffle and program. In shuffle mode, the tracks	of the
	      CD will be played	in random order.  On  entering	program	 mode,
	      cda  will	 prompt	 for  a	space or comma separated list of track
	      numbers, representing a desired playing order. The  list	should
	      be  terminated by	carriage return.  An empty list	returns	cda to
	      normal mode.  Shuffle and	program	mode cannot be engaged	unless
	      a	CD is loaded but not playing or	paused.

       F7 (e) Enable/disable repeat mode.

       F8 (q) Terminate	 the  visual  mode.   If  the cda daemon is running, a
	      reminder of the fact is given and	it  is	allowed	 to  continue.
	      The CD drive will	continue operating in the same state.  Cda may
	      be invoked again in either visual	or line	mode when required.

       D/d    Change to	the previous/next disc on multi-disc changes.

       Cursor left/right (C/c)
	      Previous/next track. This	is only	valid if playback  is  already
	      in progress.

       _/_    Proceed  to  the previous/next index mark. This is only valid if
	      playback is already in progress.

       Cursor up/down (^/v)
	      Scroll the information portion of	the screen up or down. It  may
	      be  scrolled  up	only until the last line is on the top line of
	      the screen, and may not be  scrolled  down  beyond  the  initial
	      position.	The initial scroll position is restored	when different
	      information is displayed,	(e.g., when switching to or  from  the
	      help information).

       +/-    Increase or decrease volume by 5%.

       l/r    Move balance 5% to left or right.

       Tab    Successive  depressions  of this key change the mode from	stereo
	      to mono, mono right, mono	left,  reverse	stereo,	 and  back  to
	      normal stereo.

       _n_ [mins secs]
	      Proceed  to  track  n  at	mins minutes and secs seconds from the
	      start. If	mins secs is not given,	 start	at  the	 beginning  of
	      track n.

       ^l/^r  Control-l	 or  control-r repaints	the screen.  This is useful if
	      the  screen  content  has	 been  corrupted  (e.g.,  by  operator
	      messages sent by the wall(1M) command).

CD DATABASE
       The   Gracenote	 CDDB(R)  Music	 Recognition  Service(sm)  feature  is
       supported by cda, which allows you to display the  disc	artists/title,
       track titles, and other information about the CD	or tracks via the toc,
       extinfo and notes commands of cda.  In visual mode, this	information is
       displayed automatically if available.  You cannot add, modify or	submit
       CDDB information	via cda.  For more details about CDDB, see xmcd(1) and
       the CDDB	file that comes	with this release.

       This  release  of  cda  also supports reading the CD-TEXT data from the
       disc for	CD information.	 Only some recent CDs are  produced  with  CD-
       TEXT  data  and	this  data  can	only be	read on	CD drives with CD-TEXT
       capability.

       The priority of the CD information schemes (CDDB, CD-TEXT or  local  CD
       database	 files)	 is  controlled	 via  the  cdinfoPath parameter	in the
       common.cfg file.

PLAYBACK MODES
       This release supports the following user-selectable playback modes (via
       the cda mode command):

       standard
	      When  playing  an	audio CD, the audio output is the analog "line
	      out" connection on the back of your CD drive.  There  should  be
	      an  audio	 cable	connecting  this output	to your	computer audio
	      hardware CD input	(or  to	 an  externally	 amplfied  speaker  or
	      stereo  system).	 The  audio output is also available at	the CD
	      drive's front panel headphone connection,	if so  equipped.   The
	      cda  volume  command  affect  the	 CD  drive's  built-in	volume
	      control, if the drive has	such controls.	This is	the mode  that
	      previous releases	(cda version 1.x through 3.0) supported.

       cdda-play
	      When  playing  a	CD  in	this mode, cda extracts	the CD digital
	      audio data off the CD drive over the data	cable (e.g.,  SCSI  or
	      ATAPI/IDE).   Then, it sends the data to the DSP (digital	signal
	      processor) device	in your	computer's audio  hardware  for	 real-
	      time  playback.	The  audio  is	typically  heard  through  the
	      computer's built-in speakers.  No	 signal	 is  produced  at  the
	      line-out	or  headphone  connections  of	the CD drive.  The cda
	      volume command affects the computer's DSP	device.

       cdda-save
	      When playing a CD	in this	mode,  cda  extracts  the  CD  digital
	      audio  data  off the CD drive over the data cable	(e.g., SCSI or
	      ATAPI/IDE).  Then, it writes  the	 data  into  a	file  of  your
	      choosing.	  The  cda  volume  command  does  not affect the data
	      written to the output file.   The	 output	 file  format  can  be
	      selected to be one of the	following:

	      Format Ext   Description
	      ------ ----- ---------------------------------------
	      RAW    .raw  Little-endian, 16 bit, 44.1 kHz, stereo
	      AU     .au   Big-endian, 16 bit, 44.1 kHz, stereo
	      WAV    .wav  Little-endian, 16 bit, 44.1 kHz, stereo
	      AIFF   .aiff Big-endian, 16 bit, 44.1 kHz, stereo
	      AIFF-C .aifc Big-endian, 16 bit, 44.1 kHz, stereo
	      MP3    .mp3  MPEG	1.0 Layer III compressed
	      OGG    .ogg  Ogg Vorbis compressed
	      FLAC   .flac Free	Lossless Audio CODEC compressed
	      AAC    .aac  AAC (MPEG-2 or MPEG-4) compressed
	      MP4    .mp4  MP4 (MPEG-4)	compressed

	      The  file	 can  be  played  later	 using an appropriate playback
	      utility,	or  converted  to  another  format.   This  mode  will
	      typically	 run  faster  than  real-time  with the	non-compressed
	      formats.	With the compressed formats, it	 depends  on  the  CPU
	      performance of your system.

       cdda-pipe
	      When  playing  a	CD  in	this mode, cda extracts	the CD digital
	      audio data off the CD drive over the data	cable (e.g.,  SCSI  or
	      ATAPI/IDE).   Then,  it  pipes  the  data	 stream	to an external
	      program that you specify.	 The output format is selected	as  in
	      the  CDDA	 save  to  file	 mode.	 This mode can be used with an
	      external	audio  player,	encoder,  or   other   digital	 audio
	      manipulation  program.   The external program must be capable of
	      accepting	audio data on  its  standard  input,  in  one  of  the
	      formats listed above.

       More than one of	the three CDDA modes can be selected at	the same time.
       For example, if both the	cdda-play and the cdda-save modes are enabled,
       the  two	functions will be performed simultaneously.  Note that on most
       systems,	only one program can  access  the  system's  DSP  at  a	 time,
       therefore you will likely not be	able to	select cdda-play and cdda-pipe
       at the same time, where the external program is itself an audio player.

       NOTE: The CDDA (CD digital audio) modes will function only on CD	drives
       that  provides  this  capability,  and  only  on	 some  OS and hardware
       platforms.  See the RELNOTES file for details  about  platform  support
       and other CDDA related notes.

LOCALIZATION
       The  "classic"  CDDB  service  supplies	data in	the ISO	Latin-1	format
       only, multi-byte	characters are not supported.

       The CDDB2  service  supplies  data  in  UTF-8  data  format,  which  is
       identical  to  US-ASCII	for  single-byte characters.  Multi-byte UTF-8
       characters are also supported.  By  default,  cda  will	translate  the
       characters  to  ISO  Latin-1 (ISO 8859-1, for English and many European
       character sets).	  By  changing	the  setting  of  the  charsetConvMode
       parameter  in  the  common.cfg file, you	can have cda display the UTF-8
       data without conversion (good for US-ASCII or if	you  are  using	 UTF-8
       fonts),	or  attempt  to	convert	UTF-8 strings to the default character
       set as specified	by the LANG  environment  variable.   This  conversion
       will occur only if the system's list of locales also support UTF-8.

       If  you desire to view CDDB data	in languages other than	English	or the
       ISO Latin-1 European character set, you	may  need  to  configure  your
       display	terminal to display the	appropriate fonts (if the terminal has
       such capabilities).  Terminal font configuration	 is  device-dependent,
       OS-dependent  and  beyond  the scope of this document.  Please see your
       display terminal's documentation	(or in the case	of a computer graphics
       console,	 the operating system's	console	font related documentation for
       information.

       Non-CDDB	text (such as headings,	labels and  error  messages)  are  not
       localized in cda.

NOTES
       Not  all	 platforms and CD drives support all the features of cda.  For
       example,	some drives do not support a software-driven  volume  control.
       On these	drives the cda volume and balance commands may have no effect,
       or may  simply  change  the  volume  between  full  mute	 and  maximum.
       Similarly,  the	lock,  disc,  index, and route commands	of cda may not
       have  any  effect  on  drives  that  do	not  support  the  appropriate
       functionality.

       The  lame(1)  MP3  encoder  program must	be installed on	your system in
       order for cda to	perform	CD ripping to MP3  format  files.   Similarly,
       the  faac(1)  encoder  program must be installed	on your	system for the
       AAC and MP4 formats.

       Your copy of the	cda executable must be compiled	and  linked  with  the
       Ogg Vorbis and FLAC encoder libraries in	order to perform CD ripping to
       these formats.  See the INSTALL file for	details.

ENVIRONMENT VARIABLES
       The LANG	environment variable sets  the	default	 character  set.   See
       "LOCALIZATION" above.

       The  LAME_PATH  environment variable may	be used	to specify the path to
       the lame(1) MP3 encoder program.

       The FAAC_PATH environment variable may be used to specify the  path  to
       the faac(1) AAC/MP4 encoder program.

       The  AUDIODEV  environment variable may be used to specify an alternate
       audio device when running cda in	the cdda-play mode.  The default audio
       device is write method dependent	as follows:

	   AIX write method:   /dev/paud0/1   (PCI audio)
	   AIX write method:   /dev/baud0/1   (MCA audio)
	   ALSA	write method:  plughw:0,0
	   HP-UX write method: /dev/audio
	   Linux/OSS write method:  /dev/dsp
	   OSF1	write method:  0
	   Solaris write method:    /dev/audio

       In  addition,  with  the	 OSS  and  ALSA	 write	methods,  the MIXERDEV
       environment variable may	be used	 to  specify  the  PCM	mixer  channel
       device.	The default is /dev/mixer for OSS, and default for ALSA.

       On  FreeBSD with	ATAPI CD drives, cda will automatically	use either the
       CDIOCREADAUDIO ioctl or the pread(2) system call	for CDDA reads,	 based
       on the running kernel version.  You may override	the default by setting
       the environment	variable  CDDA_USE_PREAD  to  0	 or  1,	 respectively.
       Normally	this is	not necessary.

FILES
       $HOME/.cddb2/*
       $HOME/.xmcdcfg/*
       XMCDLIB/cdinfo/*
       XMCDLIB/config/config.sh
       XMCDLIB/config/common.cfg
       XMCDLIB/config/device.cfg
       XMCDLIB/config/.tbl/*
       XMCDLIB/config/*
       XMCDLIB/help/*
       BINDIR/cda
       MANDIR/cda.1
       /tmp/.cdaudio/*

RELATED	WEB SITES
       Xmcd/cda	web site: http://www.amb.org/xmcd/
       Gracenote web site: http://www.cddb.com/
       Xmmix web site: http://www.amb.org/xmmix/
       LAME MP3	encoder: http://www.mp3dev.org/
       Ogg Vorbis: http://www.xiph.org/ogg/vorbis/
       FLAC (Free Lossless Audio CODEC): http://flac.sourceforge.net/
       FAAC (AAC/MP4 encoder): http://www.audiocoding.com/
       Hydrogen	Audio (discussion forums): http://www.hydrogenaudio.org/
       Sox audio format	conversion utility: http://www.spies.com/Sox/

SEE ALSO
       xmcd(1),	xmmix(1), X(1),	lame(1), faac(1), sox(1)
       Xmcd's README, PLATFORM,	DRIVES,	INSTALL	and RELNOTES files

AUTHOR
       Ti Kan (xmcd@amb.org)
       AMB Laboratories, Sunnyvale, CA,	U.S.A.
       Cda  also  contains  code contributed by	several	dedicated individuals.
       See the ACKS file in the	cda distribution for information.
       Comments, suggestions, and bug reports are always welcome.

v3.3.2				   04/04/21				CDA(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | DEVICE CONFIGURATION | USING CDA | VISUAL MODE | CD DATABASE | PLAYBACK MODES | LOCALIZATION | NOTES | ENVIRONMENT VARIABLES | FILES | RELATED WEB SITES | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=cda&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help