DAEX(1) 						  DAEX(1)


NAME
       daex - extract digital audio from a device


SYNOPSIS
       daex [-c hostname:port] [-d device] [-i filename] [-o out-
       file] [-s drive_speed] [-t track_no] [-y]


AVAILABILITY
       DAEX currently runs under FreeBSD.


DESCRIPTION
       DAEX (Digital Audio EXtractor) copies digital audio from a
       CD-ROM device and stores it in PCM WAV format.


OPTIONS
       -c hostname:port
	      Enable CDDB querying.  DAEX will attempt to contact
	      a  CDDB  server  on  "hostname"  at  the	specified
	      "port".

	      Example: -c cddb.cddb.com:8880

       -d device
	      DAEX will attempt to read from the specified device
	      instead  of  the	default.    Default   device   is
	      /dev/wcd0c.

	      Example: -d /dev/wcd1c

       -i filename
	      Record  CDDB  information  to  the  specified file.
	      This option may only be  specified  in  conjunction
	      with the -c (CDDB querying) option.

	      If  a  track is being extracted, CDDB-derived file-
	      names are not used -- instead, the tracks are saved
	      in  the track-NN.wav format, where "NN" is equal to
	      the current, or specified track number.

	      Example: -c cddb.cddb.com:8880 -i mydisc.info

       -o outfile
	      Store the audio in  the  specified  file.   Default
	      filenames  are  in  the  format track-NN.wav, where
	      "NN" is the current, or specified track number.

	      Example: -o mysong.wav

       -s drive_speed
	      Set the CD-ROM's read speed to the specified  rate.



DAEX v0.90a		 October 5, 1998			1





DAEX(1) 						  DAEX(1)


	      Values for the drive_speed argument are as follows:

	      0 == Maximum allowable
	      1 == 1x (176 kbytes/sec)
	      2 == 2x (353 kbytes/sec)
	      3 == 3x (528 kbytes/sec)
	      4 == 4x (706 kbytes/sec)
	      8 == 8x (1.4 Mbytes/sec)
	      16 == 16x (2.8 Mbytes/sec)

	      The default is to not set the drive speed.

	      Example: -s 4

       -t track_no
	      Extract the specified track number.  A value  of	0
	      will  extract  the  entire  disc.  This option must
	      must be specified, unless the -i option  is  speci-
	      fied as well.

	      Example: -t 5

       -y     Skip  tracks that report errors.	DAEX will exit by
	      default when it comes across an error.  By specify-
	      ing  this  option, DAEX will continue with the next
	      track in the extraction.	This option only  affects
	      multi-track extraction.


EXAMPLES
       daex -c cddb.cddb.com:8880 -t 5 -i Gene-
	      sis.We_Cant_Dance.info
	      Contact the primary CDDB server, save the  returned
	      information  to  "Genesis.We_Cant_Dance.info",  and
	      extract track 5 from the disc at the default speed.

       daex -c sunsite.unc.edu:8880 -t 0 -y
	      Extract  the  entire  disc, using filenames derived
	      from  the  returned  CDDB   information.	  If   we
	      encounter an error, skip the current track.

       daex -t 2 -o 02_lucky.wav
	      Extract  track  2  to "02_lucky.wav" at the default
	      rate.

       daex -t 11 -o 11_speechless.wav -d /dev/wcd1c -s 1
	      Extract track 11 to "11_speechless.wav"  using  the
	      second IDE CD-ROM device at 1x.

       daex  -t  1  -c	cddb.cddb.com:8880  -o
	      fire_in_the_hole.wav  -i o9mm.info -s 0
	      Contact  the primary CDDB server, save the returned
	      information to "o9mm.info", and extract track 1  to
	      "fire_in_the_hole.wav" at maximum speed.



DAEX v0.90a		 October 5, 1998			2





DAEX(1) 						  DAEX(1)


NOTES
       If  a track is being extracted and the -i option is speci-
       fied, CDDB-derived filenames are not used -- instead,  the
       tracks are saved in the track-NN.wav format, where "NN" is
       equal to the current, or specified track number.

       Audio is stored as a 2 channel, 16 bit, 44.1 Khz WAVE.


ACKNOWLEDGEMENTS
       Thanks go to the following for their contributions:

	Danny Dulai <nirva@ishiboo.com>  The original CDDB infofile and testing.
	Dave Meltzer <davem@iss.net>	 Reviewing the DAEX DNS lookup code.
	Vinnie Yesue <vyesue@nyu.com>	 Quite a bit of testing.


AUTHOR
       Robert Mooney <rjmooney\@impetus\.us>

       For more information on DAEX, visit:

       http://www.impetus.us/~rjmooney/projects/daex/

       DAEX is (c)  Copyright  1998  Robert  Mooney,  All  rights
       reserved.


CAVEATS
       DAEX does not yet support jitter correction.  If you expe-
       rience jitter (cracks and crackles in the  playback),  try
       reducing  the speed at which the track is extracted.  This
       can be accomplished through the -s option.
























DAEX v0.90a		 October 5, 1998			3