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

FreeBSD Manual Pages

  
 
  

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

NAME
     icedax - a sampling utility that dumps CD audio data into wav sound files

SYNOPSIS
     icedax  [-c  chans]  [-s]	[-m]  [-b  bits]  [-r  rate]  [-a  divider]  [-t
     track[+endtrack]] [-i index] [-o offset] [-d duration] [-x] [-q]  [-w]  [-v
     optlist] [-V] [-Q] [-J] [-L cddbmode] [-R] [-P sectors] [-F] [-G] [-T] [-e]
     [-p  percentage] [-n sectors] [-l buffers] [-N] [-J] [-H] [-g] [-B] [-D de-
     vice] [-A auxdevice] [-I interface] [-O audiotype] [-C input-endianess] [-E
     output-endianess] [-M count] [-S speed]  [-paranoia]  [cddbp-server=server-
     name] [cddbp-port=portnumber] [filename(s) or directories]

DESCRIPTION
     icedax stands for InCrEdible Digital Audio eXtractor. It can retrieve audio
     tracks (CDDA) from CDROM drives that are capable of reading audio data dig-
     itally to the host (see README for a list of drives).

OPTIONS
     dev=device

     -D device

     -device device
	    uses  device  as the source for CDDA reading. For example /dev/cdrom
	    or Bus,ID,Lun.  The device specification can also have influence  on
	    the  selection  of	the driver interface (eg. on Linux).  See the -I
	    option for details.

	    The setting of the environment variable CDDA_DEVICE is overridden by
	    this option.

     -A auxdevice

     -auxdevice auxdevice
	    uses auxdevice as CDROM drive for ioctl usage.

     -I interface

     -interface interface
	    specifies the interface for CDROM access: generic_scsi or (on Linux,
	    and FreeBSD systems) cooked_ioctl.

	    Using the cooked_ioctl is  not  recommended  as  this  makes  icedax
	    mainly  depend on the audio extraction quality of the operating sys-
	    tem which is usually extremely bad.

     -c channels  --channels
	    uses 1 for mono, or 2 for stereo recording, or s for stereo  record-
	    ing with both channels swapped.

     -s  --stereo
	    sets to stereo recording.

     -m  --mono
	    sets to mono recording.

     -x  --max
	    sets maximum (CD) quality.

     -b bits  --bits-per-sample
	    sets bits per sample per channel: 8, 12 or 16.

     -r rate  --rate
	    sets  rate	in  samples per second.  Possible values are listed with
	    the -R option.

     -a divider  --divider
	    sets rate to 44100Hz / divider.  Possible values are listed with the
	    -R option.

     -R  --dump-rates
	    shows a list of all sample rates and their dividers.

     -P  sectors  --set-overlap
	    sets the initial number of overlap sectors for jitter correction.

     -n sectors  --sectors-per-request
	    reads sectors per request.

     -l buffers  --buffers-in-ring
	    uses a ring buffer with buffers total.

     -t track+endtrack	--track
	    selects the start track and optionally the end track.

     -i index  --index
	    selects the start index.

     -o offset	--offset
	    starts offset sectors behind start	track  (one  sector  equivalents
	    1/75 seconds).

     -O  audiotype  --output-format
	    can  be  wav  (for	wav files) or aiff (for apple/sgi aiff files) or
	    aifc (for apple/sgi aifc files) or au or sun (for sun .au PCM files)
	    or cdr or raw (for headerless files to be used for cd writers).

     -C endianess  --cdrom-endianess
	    sets endianess of the input samples to 'little', 'big' or 'guess' to
	    override defaults.

     -E endianess  --output-endianess
	    sets endianess of the output samples to 'little' or 'big'  to  over-
	    ride defaults.

     -d duration  --duration
	    sets  recording time in seconds or frames.	Frames (sectors) are in-
	    dicated by a 'f' suffix (like 75f for 75 sectors).	0 sets the  time
	    for whole track.

     -B  --bulk --alltracks
	    copies each track into a separate file.

     -w  --wait
	    waits for signal, then start recording.

     -F  --find-extremes
	    finds extreme amplitudes in samples.

     -G  --find-mono
	    finds if input samples are in mono.

     -T  --deemphasize
	    undo the effect of pre-emphasis in the input samples.

     -e  --echo
	    copies audio data to sound device e.g.  /dev/dsp.

     -p  percentage --set-pitch
	    changes pitch of audio data copied to sound device.

     -v  itemlist  --verbose-level
	    prints  verbose  information about the CD.	Level is a list of comma
	    separated suboptions. Each suboption controls the type  of	informa-
	    tion to be reported.
	    +-----------+---------------------------------------------------+
	    | Suboption |		     Description		    |
	    +-----------+---------------------------------------------------+
	    |	disable | no information is given, warnings appear however  |
	    +-----------+---------------------------------------------------+
	    |	    all | all information is given			    |
	    +-----------+---------------------------------------------------+
	    |	    toc | show table of contents			    |
	    +-----------+---------------------------------------------------+
	    |	summary | show a summary of the recording parameters	    |
	    +-----------+---------------------------------------------------+
	    |	indices | determine and display index offsets		    |
	    +-----------+---------------------------------------------------+
	    |	catalog | retrieve and display the media catalog number MCN |
	    +-----------+---------------------------------------------------+
	    |	trackid | retrieve and display all International Standard   |
	    |		| Recording Codes ISRC				    |
	    +-----------+---------------------------------------------------+
	    |	sectors | show the table of contents in start sector nota-  |
	    |		| tion						    |
	    +-----------+---------------------------------------------------+
	    |	 titles | show the table of contents with track titles	    |
	    |		| (when available)				    |
	    +-----------+---------------------------------------------------+

     -N  --no-write
	    does not write to a file, it just reads (for debugging purposes).

     -J  --info-only
	    does not write to a file, it just gives information about the disc.

     -L  cddb mode --cddb
	    does  a  cddbp  album-  and track title lookup based on the cddb id.
	    The parameter cddb mode defines how multiple entries shall	be  han-
	    dled.
	    +-----------+------------------------------------------+
	    | Parameter |		Description		   |
	    +-----------+------------------------------------------+
	    |	      0 | interactive mode. The user selects the   |
	    |		| entry to use. 			   |
	    +-----------+------------------------------------------+
	    |	      1 | first fit mode. The first entry is taken |
	    |		| unconditionally.			   |
	    +-----------+------------------------------------------+

      cddbp-server=servername
	    sets the server to be contacted for title lookups.

      cddbp-port=portnumber
	    sets the port number to be used for title lookups.

     -H  --no-infofile
	    does not write an info file and a cddb file.

     -g  --gui
	    formats the output to be better parsable by gui frontends.

     -M  count --md5
	    enables calculation of MD-5 checksum for 'count' bytes from a begin-
	    ning of a track.

     -S  speed --speed
	    sets the cdrom device to one of the selectable speeds for reading.

     -q  --quiet
	    quiet operation, no screen output.

     -V  --verbose-SCSI
	    enable  SCSI command logging to the console. This is mainly used for
	    debugging.

     -Q  --silent-SCSI
	    suppress SCSI command error reports to the console. This  is  mainly
	    used for guis.

     -scanbus
	    Scan  all  SCSI  devices  on  all  SCSI busses and print the inquiry
	    strings. This option may be used to find SCSI address of the CD/DVD-
	    Recorder on a system.  The numbers printed out as  labels  are  com-
	    puted by: bus * 100 + target

     --devices
	    Like  -scanbus but works in a more native way, respecting the device
	    name specification on the current operating system. See wodim(1) for
	    details.

     -paranoia
	    use the paranoia library instead of icedax's routines for reading.

     -h  --help
	    display version of icedax on standard output.

     Defaults depend on the
	    Makefile and environment variable settings (currently CDDA_DEVICE ).

ENVIRONMENT VARIABLES
     CDDA_DEVICE is used to set the device name. The device naming is compatible
     with the one used by the wodim tool.

     CDDBP_SERVER
	    is used for cddbp title lookups when supplied.

     CDDBP_PORT
	    is used for cddbp title lookups when supplied.

     RSH    If the RSH environment variable is present,  the  remote  connection
	    will  not  be created via rcmd(3) but by calling the program pointed
	    to by RSH.	Use e.g.  RSH=/usr/bin/ssh to create a secure shell con-
	    nection.

	    Note that this forces icedax to create a pipe to the rsh(1)  program
	    and  disallows  icedax  to directly access the network socket to the
	    remote server.  This makes it impossible to set up performance para-
	    meters and slows down the connection compared to  a  root  initiated
	    rcmd(3) connection.

     RSCSI  If the RSCSI environment variable is present, the remote SCSI server
	    will  not  be  the	program  /opt/schily/sbin/rscsi  but the program
	    pointed to by RSCSI.  Note that the remote SCSI server program  name
	    will be ignored if you log in using an account that has been created
	    with a remote SCSI server program as login shell.

RETURN VALUES
     icedax  uses  the	following exit codes to indicate various degrees of suc-
     cess:
     +----------+-----------------------------------------------------------+
     | Exitcode |			 Description			    |
     +----------+-----------------------------------------------------------+
     |	      0 | no errors encountered, successful operation.		    |
     +----------+-----------------------------------------------------------+
     |	      1 | usage or syntax error. icedax got inconsistent arguments. |
     +----------+-----------------------------------------------------------+
     |	      2 | permission (un)set errors. permission changes failed.     |
     +----------+-----------------------------------------------------------+
     |	      3 | read errors on the cdrom/burner device encountered.	    |
     +----------+-----------------------------------------------------------+
     |	      4 | write errors while writing one of the output files en-    |
     |		| countered.						    |
     +----------+-----------------------------------------------------------+
     |	      5 | errors with soundcard handling (initialization/write).    |
     +----------+-----------------------------------------------------------+
     |	      6 | errors with stat() system call on the read device (cooked |
     |		| ioctl).						    |
     +----------+-----------------------------------------------------------+
     |	      7 | pipe communication errors encountered (in forked mode).   |
     +----------+-----------------------------------------------------------+
     |	      8 | signal handler installation errors encountered.	    |
     +----------+-----------------------------------------------------------+
     |	      9 | allocation of shared memory failed (in forked mode).	    |
     +----------+-----------------------------------------------------------+
     |	     10 | dynamic heap memory allocation failed.		    |
     +----------+-----------------------------------------------------------+
     |	     11 | errors on the audio cd medium encountered.		    |
     +----------+-----------------------------------------------------------+
     |	     12 | device open error in ioctl handling detected. 	    |
     +----------+-----------------------------------------------------------+
     |	     13 | race condition in ioctl interface handling detected.	    |
     +----------+-----------------------------------------------------------+
     |	     14 | error in ioctl() operation encountered.		    |
     +----------+-----------------------------------------------------------+
     |	     15 | internal error encountered. Please report back!!!	    |
     +----------+-----------------------------------------------------------+
     |	     16 | error in semaphore operation encountered (install / re-   |
     |		| quest).						    |
     +----------+-----------------------------------------------------------+
     |	     17 | could not get the scsi transfer buffer.		    |
     +----------+-----------------------------------------------------------+
     |	     18 | could not create pipes for process communication (in	    |
     |		| forked mode). 					    |
     +----------+-----------------------------------------------------------+

DISCUSSION
     icedax is able to read parts of an audio CD or multimedia CDROM (containing
     audio parts) directly digitally. These parts can be written to  a	file,  a
     pipe, or to a sound device.

     icedax  stands  for CDDA to WAV (where CDDA stands for compact disc digital
     audio and WAV is a sound sample format introduced by MS Windows).	 It  al-
     lows  copying  CDDA  audio  data from the CDROM drive into a file in WAV or
     other formats.

     The latest versions try to get higher real-time  scheduling  priorities  to
     ensure smooth (uninterrupted) operation. These priorities are available for
     super  users  and	are higher than those of 'normal' processes. Thus delays
     are minimized.

     If your CDROM is on device DEV and it is loaded with an audio CD,	you  may
     simply  invoke  icedax  dev=DEV and it will create the sound file audio.wav
     recording the whole track beginning with track 1 in stereo  at  16  bit  at
     44100 Hz sample rate, if your file system has enough space free.  Otherwise
     recording time will be limited. For details see files README and README.IN-
     STALL

HINTS ON OPTIONS
     OptionsMost  of the options are used to control the format of the WAV file.
	    In the following text all of them are described.

     Select Device
	    -D device selects the CDROM drive device to be used.  The  specifier
	    given  should  correspond  to  the	selected  interface (see below).
	    CHANGE!  For the cooked_ioctl interface this is the cdrom device de-
	    scriptor as before.  The SCSI devices used with the generic SCSI in-
	    terface however are now addressed with their SCSI-Bus, SCSI-Id,  and
	    SCSI-Lun instead of the generic SCSI device descriptor!!!  One exam-
	    ple  for  a  SCSI  CDROM  drive on bus 0 with SCSI ID 3 and lun 0 is
	    -D0,3,0.

     Select Auxiliary device
	    -A auxdevice is necessary for CD-Extra handling. For  Non-SCSI-CDROM
	    drives this is the same device as given by -D (see above). For SCSI-
	    CDROM  drives  it is the CDROM drive (SCSI) device (i.e.  /dev/sr0 )
	    corresponding to the SCSI device (i.e.  0,3,0 ). It has to match the
	    device used for sampling.

     Select Interface
	    -I interface selects the CDROM drive interface. For SCSI drives  use
	    generic_scsi  (cooked_ioctl  may  not  yet	be available for all de-
	    vices): generic_scsi and cooked_ioctl.  The first uses  the  generic
	    SCSI  interface,  the latter uses the ioctl of the CDROM driver. The
	    latter variant works only when the kernel driver supports CDDA read-
	    ing. This entry has to match the selected CDROM device (see above).

     Enable echo to soundcard
	    -e copies audio data to the sound card while recording, so you  hear
	    it	nearly	simultaneously. The soundcard gets the same data that is
	    recorded. This is time critical, so it works best with  the  -q  op-
	    tion.   To	use  icedax as a pseudo CD player without recording in a
	    file you could use icedax -q -e -t2 -d0 -N to play the whole  second
	    track.  This  feature reduces the recording speed to at most onefold
	    speed. You cannot make better recordings than your	sound  card  can
	    play (since the same data is used).

     Change pitch of echoed audio
	    -p percentage changes the pitch of all audio echoed to a sound card.
	    Only  the copy to the soundcard is affected, the recorded audio sam-
	    ples in a file remain the same.  Normal pitch, which is the default,
	    is given by 100%.  Lower percentages correspond  to  lower	pitches,
	    i.e.   -p 50 transposes the audio output one octave lower.	See also
	    the script pitchplay as an example. This option was  contributed  by
	    Raul Sobon.

     Select mono or stereo recording
	    -m	or -c 1 selects mono recording (both stereo channels are mixed),
	    -s or -c 2 or -c s selects stereo recording. Parameter s  will  swap
	    both sound channels.

     Select maximum quality
	    -x	will  set  stereo, 16 bits per sample at 44.1 KHz (full CD qual-
	    ity).  Note that other format options given later  can  change  this
	    setting.

     Select sample quality
	    -b 8 specifies 8 bit (1 Byte) for each sample in each channel; -b 12
	    specifies  12  bit	(2  Byte) for each sample in each channel; -b 16
	    specifies 16 bit (2 Byte) for each sample in  each	channel  (Ensure
	    that  your	sample player or sound card is capable of playing 12-bit
	    or 16-bit samples). Selecting 12  or  16  bits  doubles  file  size.
	    12-bit  samples  are  aligned  to 16-bit samples, so they waste some
	    disk space.

     Select sample rate
	    -r samplerate selects a sample rate.  samplerate can be in	a  range
	    between 44100 and 900. Option -R lists all available rates.

     Select sample rate divider
	    -a	divider selects a sample rate divider.	divider can be minimally
	    1 and maximally 50.5 and everything between in steps of 0.5.  Option
	    -R lists all available rates.

	    To make the sound smoother at lower sampling rates, icedax sums over
	    n samples (where n is the specific dividend).  So  for  22050  Hertz
	    output  we	have to sum over 2 samples, for 900 Hertz we have to sum
	    over 49 samples.  This cancels higher frequencies.	Standard  sector
	    size of an audio CD (ignoring additional information) is 2352 Bytes.
	    In order to finish summing for an output sample at sector boundaries
	    the rates above have to be chosen.	Arbitrary sampling rates in high
	    quality  would  require  some interpolation scheme, which needs much
	    more sophisticated programming.

     List a table of all sampling rates
	    -R shows a list of all sample rates and their dividers. Dividers can
	    range from 1 to 50.5 in steps of 0.5.

     Select start track and optionally end track
	    -t n+m selects n as the start track and optionally	m  as  the  last
	    track  of a range to be recorded.  These tracks must be from the ta-
	    ble of contents.   This  sets  the	track  where  recording  begins.
	    Recording  can advance through the following tracks as well (limited
	    by the optional end track or otherwise depending on recording time).
	    Whether one file or different files are then created depends on  the
	    -B option (see below).

     Select start index
	    -i	n selects the index to start recording with.  Indices other than
	    1 will invoke the index scanner, which will take some time	to  find
	    the correct start position. An offset may be given additionally (see
	    below).

     Set recording time
	    -d	 n  sets  recording  time to n seconds or set recording time for
	    whole track if n is zero. In order to specify the duration in frames
	    (sectors) also, the argument can have an appended 'f'. Then the  nu-
	    merical argument is to be taken as frames (sectors) rather than sec-
	    onds.   Please  note that if track ranges are being used they define
	    the recording time as well thus overriding any -d  option  specified
	    times.

	    Recording time is defined as the time the generated sample will play
	    (at  the  defined  sample rate). Since it's related to the amount of
	    generated samples, it's not the time of the sampling process  itself
	    (which can be less or more).  It's neither strictly coupled with the
	    time  information  on  the	audio CD (shown by your hifi CD player).
	    Differences can occur by the usage of the -o option (see below). No-
	    tice that recording time will be shortened, unless enough disk space
	    exists. Recording can be aborted at anytime by  pressing  the  break
	    character (signal SIGQUIT).
	       .IP  "Record all tracks of a complete audio CD in separate files"
	    -B copies each track into a separate file. A base name can be given.
	    File names have an appended track number  and  an  extension  corre-
	    sponding  to  the  audio format. To record all audio tracks of a CD,
	    use a sufficient high duration (i.e. -d99999).

     Set start sector offset
	    -o sectors increments start sector of the track by sectors.  By this
	    option you are able to skip a certain amount at the beginning  of  a
	    track  so  you  can pick exactly the part you want. Each sector runs
	    for 1/75 seconds, so you have very fine control. If your  offset  is
	    so high that it would not fit into the current track, a warning mes-
	    sage is issued and the offset is ignored.  Recording time is not re-
	    duced.   (To skip introductory quiet passages automagically, use the
	    -w option see below.)

     Wait for signal option
	    -w Turning on  this  option  will  suppress  all  silent  output  at
	    startup,  reducing	possibly  file	size.  icedax will watch for any
	    signal in the output signal and switches on writing to file.

     Find extreme samples
	    -F Turning on this option will display the	most  negative	and  the
	    most positive sample value found during recording for both channels.
	    This  can be useful for readjusting the volume. The values shown are
	    not reset at track boundaries,  they  cover  the  complete	sampling
	    process.  They are taken from the original samples and have the same
	    format (i.e. they are independent of the selected output format).

     Find if input samples are in mono
	    -G If this option is given, input samples for both channels will  be
	    compared.  At  the end of the program the result is printed. Differ-
	    ences in the channels indicate stereo, otherwise when both	channels
	    are equal it will indicate mono.

     Undo the pre-emphasis in the input samples
	    -T	Some  older audio CDs are recorded with a modified frequency re-
	    sponse called  pre-emphasis.  This	is  found  mostly  in  classical
	    recordings.  The correction can be seen in the flags of the Table Of
	    Contents often. But there are recordings,  that  show  this  setting
	    only  in the subchannels. If this option is given, the index scanner
	    will be started, which reads the q-subchannel of each track. If pre-
	    emphasis is indicated in the q-subchannel of a track, but not in the
	    TOC, pre-emphasis will be assumed to be present, and subsequently  a
	    reverse  filtering	is  done  for  this track before the samples are
	    written into the audio file.

     Set audio format
	    -O	audiotype can be wav (for wav files) or au or sun (for	sun  PCM
	    files)  or	cdr or raw (for headerless files to be used for cd writ-
	    ers).  All file samples are coded in linear  pulse	code  modulation
	    (as done in the audio compact disc format). This holds for all audio
	    formats.  Wav files are compatible to Wind*ws sound files, they have
	    lsb,msb  byte order as being used on the audio cd. The default file-
	    name extension is '.wav'.  Sun type files are  not	like  the  older
	    common  logarithmically  coded  .au  files, but instead as mentioned
	    above linear PCM is used. The byte order is msb,lsb to  be	compati-
	    ble.  The  default	filename  extension  is '.au'.	The AIFF and the
	    newer variant AIFC from the Apple/SGI world store their  samples  in
	    bigendian format (msb,lsb). In AIFC no compression is used.  Finally
	    the easiest 'format', the cdr aka raw format. It is done per default
	    in	msb,lsb  byte order to satisfy the order wanted by most cd writ-
	    ers. Since there is no header information in this format, the sample
	    parameters can only be identified by playing the samples on a sound-
	    card or similar. The default filename extension is '.cdr' or '.raw'.

     Select cdrom drive reading speed
	    -S	speed allows to switch the cdrom drive to  a  certain  level  of
	    speed  in  order  to  reduce read errors. The argument is transfered
	    verbatim to the drive.  Details depend very much on the  cdrom  dri-
	    ves.  An argument of 0 for example is often the default speed of the
	    drive, a value of 1 often selects single speed.

     Enable MD5 checksums
	    -M	 count	enables  calculation  of MD-5 checksum for 'count' bytes
	    from the beginning of a track. This was introduced for quick compar-
	    isons of tracks.

     Use Monty's libparanoia for reading of sectors
	    -paranoia selects an alternate  way  of  extracting  audio	sectors.
	    Monty's library is used with the following default options:

	    PARANOIA_MODE_FULL, but without PARANOIA_MODE_NEVERSKIP

	    for details see Monty's libparanoia documentation.	In this case the
	    option -P has no effect.

     Do linear or overlapping reading of sectors
	    (This  applies  unless  option -paranoia is used.)	-P  sectors sets
	    the given number of sectors for initial overlap sampling for  jitter
	    correction.  Two  cases are to be distinguished. For nonzero values,
	    some sectors are read twice to enable  icedax's  jitter  correction.
	    If	an  argument of zero is given, no overlap sampling will be used.
	    For nonzero overlap sectors icedax dynamically adjusts  the  setting
	    during  sampling  (like cdparanoia does).  If no match can be found,
	    icedax retries the read with an increased overlap.	If the amount of
	    jitter is lower than the current overlapped samples, icedax  reduces
	    the overlap setting, resulting in a higher reading speed.  The argu-
	    ment  given has to be lower than the total number of sectors per re-
	    quest (see option -n below).  Icedax will check this setting and is-
	    sues a error message otherwise.  The case of zero sectors is nice on
	    low load situations or errorfree (perfect) cdrom drives and  perfect
	    (not scratched) audio cds.

     Set the transfer size
	    -n	 sectors will set the transfer size to the specified sectors per
	    request.

     Set number of ring buffer elements
	    -l	buffers will allocate the specified number of ring  buffer  ele-
	    ments.

     Set endianess of input samples
	    -C	 endianess  will override the default settings of the input for-
	    mat.  Endianess can be set explicitly to "little" or "big" or to the
	    automatic endianess detection based on voting with "guess".

     Set endianess of output samples
	    -E	endianess (endianess can be "little" or "big") will override the
	    default settings of the output format.

     Verbose option
	    -v	itemlist prints more information. A  list  allows  selection  of
	    different information items.

	    disable keeps quiet

	    toc displays the table of contents

	    summary displays a summary of recording parameters

	    indices  invokes  the  index scanner and displays start positions of
	    indices

	    catalog retrieves and displays a media catalog number

	    trackid retrieves  and  displays  international  standard  recording
	    codes

	    sectors displays track start positions in absolute sector notation

	    To	combine several requests just list the suboptions separated with
	    commas.

     The table of contents
	    The display will show the table of contents with  number  of  tracks
	    and  total	time  (displayed in mm:ss.hh format, mm=minutes, ss=sec-
	    onds, hh=rounded 1/100 seconds).  The following list displays  track
	    number  and track time for each entry.  The summary gives a line per
	    track describing the type of the track.

		      track preemphasis copypermitted tracktype chans

	    The track column holds the track number.  preemphasis shows if  that
	    track has been given a non linear frequency response.  NOTE: You can
	    undo  this	effect	with the -T option.  copy-permitted indicates if
	    this track is allowed to copy.  tracktype can be data or  audio.  On
	    multimedia	CDs  (except  hidden  track  CDs) both of them should be
	    present.  channels is defined for audio tracks only.  There  can  be
	    two or four channels.

     No file output
	    -N this debugging option switches off writing to a file.

     No infofile generation
	    -H	this  option  switches	off  creation of an info file and a cddb
	    file.

     Generation of simple output for gui frontends
	    -g this option switches on simple line formatting, which  is  needed
	    to support gui frontends (like xcd-roast).

     Verbose SCSI logging
	    -V	this option switches on logging of SCSI commands. This will pro-
	    duce a lot of output (when SCSI devices are being  used).	This  is
	    needed  for debugging purposes. The format is the same as being used
	    with the cdrecord program from Joerg Schilling or  the  wodim  tool.
	    See there for details.

     Quiet option
	    -q suppresses all screen output except error messages.  That reduces
	    cpu time resources.

     Just show information option
	    -J	does not write a file, it only prints information about the disc
	    (depending on the -v option). This is just for information purposes.

CDDBP support
     Lookup album and track titles option
	    -L	cddbp mode Icedax tries to retrieve performer, album-, and track
	    titles from  a  cddbp  server.  The  default  server  right  now  is
	    'freedb.freedb.org'.   It  is  planned to have more control over the
	    server handling later.  The parameter defines how  multiple  entries
	    are handled:

     0	  interactive mode, the user chooses one of the entries.

     1	  take the first entry without asking.

     Set server for title lookups
	    cddbp-server   servername  When using -L or --cddb, the server being
	    contacted can be set with this option.

     Set portnumber for title lookups
	    cddbp-port	portnumber When using -L or --cddb, the server port  be-
	    ing contacted can be set with this option.

HINTS ON USAGE
     Don't  create samples you cannot read. First check your sample player soft-
     ware and sound card hardware. I experienced problems with very  low  sample
     rates  (stereo  <=  1575 Hz, mono <= 3675 Hz) when trying to play them with
     standard WAV players for sound blaster (maybe they are  not  legal  in  WAV
     format).  Most  CD-Writers  insist  on audio samples in a bigendian format.
     Now icedax supports the -E  endianess option to control  the  endianess  of
     the written samples.

     If  your  hardware  is  fast enough to run icedax uninterrupted and your CD
     drive is one of the 'perfect' ones, you will gain speed when switching  all
     overlap sampling off with the -P  0 option. Further fine tuning can be done
     with the -n  sectors option. You can specify how much sectors should be re-
     quested in one go.

     Icedax  supports  pipes  now.  Use a filename of - to let icedax output its
     samples to standard output.

     Conversion to other sound formats can be done using the sox program package
     (although the use of sox -x to change the byte order of samples  should  be
     no more necessary; see option -E to change the output byteorder).

     If  you want to sample more than one track into different files in one run,
     this is currently possible with the -B option. When recording time  exceeds
     the track limit a new file will be opened for the next track.

FILES
     Icedax can generate a lot of files for various purposes.

     Audio files:

     There  are  audio	files  containing  samples with default extensions These
     files are not generated when option (-N) is given. Multiple  files  may  be
     written  when  the bulk copy option (-B) is used. Individual file names can
     be given as arguments. If the number of file names given is  sufficient  to
     cover  all  included  audio  tracks,  the file names will be used verbatim.
     Otherwise, if there are less file names than files needed to write the  in-
     cluded  tracks,  the part of the file name before the extension is extended
     with '_dd' where dd represents the current track number.

     Cddb and Cdindex files:

     If icedax detects cd-extra or cd-text (album/track) title information, then
     .cddb and .cdindex files are generated unless suppressed by the option  -H.
     They  contain  suitable  formatted entries for submission to audio cd track
     title databases in the internet. The CDINDEX and CDDB(tm) systems are  cur-
     rently supported. For more information please visit www.musicbrainz.org and
     www.freedb.com.

     Inf files:

     The  inf  files are describing the sample files and the part from the audio
     cd, it was taken from. They are a means to transfer  information  to  a  cd
     burning  program like wodim. For example, if the original audio cd had pre-
     emphasis enabled, and icedax -T did remove the pre-emphasis, then	the  inf
     file  has	pre-emphasis not set (since the audio file does not have it any-
     more), while the .cddb and the .cdindex have pre-emphasis set as the origi-
     nal does.

WARNING
     IMPORTANT: it is prohibited to sell copies of copyrighted material by  non-
     copyright	holders.  This program may not be used to circumvent copyrights.
     The user acknowledges this constraint when using the software.

BUGS
     Generation of md5 checksums is currently broken.

     Performance may not be optimal on slower systems.

     The index scanner may give timeouts.

     The resampling (rate conversion code) uses polynomial interpolation,  which
     is not optimal.

     Icedax should use threads.

     Icedax currently cannot sample hidden audio tracks (track 1 index 0).

ACKNOWLEDGEMENTS
     Thanks  goto  Project  MODE  (http://www.mode.net/) and Fraunhofer Institut
     fuer integrierte Schaltungen (FhG-IIS) (http://www.iis.fhg.de/) for  finan-
     cial  support.   Plextor  Europe and Ricoh Japan provided cdrom disk drives
     and cd burners which helped a lot to  develop  this  software.   Rammi  has
     helped  a	lot  with the debugging and showed a lot of stamina when hearing
     100 times the first 16 seconds of the first track of the Krupps  CD.   Lib-
     paranoia contributed by Monty (Christopher Montgomery) xiphmont@mit.edu.

AUTHOR
     Heiko Eissfeldt heiko@colossus.escape.de

     This  manpage  describes the program implementation of icedax as shipped by
     the cdrkit distribution. See http://alioth.debian.org/projects/debburn/ for
     details. It is a spinoff from the original program cdda2wav as  distributed
     in  the  cdrtools package [1]. However, the cdrtools developers are not in-
     volved in the development of this spinoff and therefore shall not	be  made
     responsible  for  any  problem  caused by it. Do not try to get support for
     this program by contacting the original authors.

     If you have support questions, send them to

     debburn-devel@lists.alioth.debian.org

     If you have definitely found a bug, send a mail to this list or to

     submit@bugs.debian.org

     writing at least a short description into the Subject and "Package: cdrkit"
     into the first line of the mail body.

DATE
     26 Sep 2006

SOURCES
     [1] Cdrtools 2.01.01a08 from May 2006, http://cdrecord.berlios.de

								       ICEDAX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=icedax&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help