1ICEDAX(1)                   General Commands Manual                  ICEDAX(1)
2
3
4

NAME

6       icedax  -  a  sampling  utility that dumps CD audio data into wav sound
7       files
8

SYNOPSIS

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

DESCRIPTION

20       icedax  stands  for InCrEdible Digital Audio eXtractor. It can retrieve
21       audio tracks (CDDA) from CDROM drives that are capable of reading audio
22       data digitally to the host (see README for a list of drives).
23
24

OPTIONS

26       dev=device
27
28       -D device
29
30       -device device
31              uses  device  as  the  source  for  CDDA  reading.  For  example
32              /dev/cdrom or Bus,ID,Lun.  The  device  specification  can  also
33              have  influence on the selection of the driver interface (eg. on
34              Linux).  See the -I option for details.
35
36              The setting of the environment variable CDDA_DEVICE is  overrid‐
37              den by this option.
38
39       -A auxdevice
40
41       -auxdevice auxdevice
42              uses auxdevice as CDROM drive for ioctl usage.
43
44       -I interface
45
46       -interface interface
47              specifies  the  interface  for CDROM access: generic_scsi or (on
48              Linux, and FreeBSD systems) cooked_ioctl.
49
50              Using the cooked_ioctl is not recommended as this  makes  icedax
51              mainly  depend  on the audio extraction quality of the operating
52              system which is usually extremely bad.
53
54       -c channels  --channels
55              uses 1 for mono, or 2 for stereo  recording,  or  s  for  stereo
56              recording with both channels swapped.
57
58       -s  --stereo
59              sets to stereo recording.
60
61       -m  --mono
62              sets to mono recording.
63
64       -x  --max
65              sets maximum (CD) quality.
66
67       -b bits  --bits-per-sample
68              sets bits per sample per channel: 8, 12 or 16.
69
70       -r rate  --rate
71              sets  rate  in  samples  per second.  Possible values are listed
72              with the -R option.
73
74       -a divider  --divider
75              sets rate to 44100Hz / divider.  Possible values are listed with
76              the -R option.
77
78       -R  --dump-rates
79              shows a list of all sample rates and their dividers.
80
81       -P  sectors  --set-overlap
82              sets  the  initial  number of overlap sectors for jitter correc‐
83              tion.
84
85       -n sectors  --sectors-per-request
86              reads sectors per request.
87
88       -l buffers  --buffers-in-ring
89              uses a ring buffer with buffers total.
90
91       -t track+endtrack  --track
92              selects the start track and optionally the end track.
93
94       -i index  --index
95              selects the start index.
96
97       -o offset  --offset
98              starts offset sectors behind start track (one sector equivalents
99              1/75 seconds).
100
101       -O  audiotype  --output-format
102              can be wav (for wav files) or aiff (for apple/sgi aiff files) or
103              aifc (for apple/sgi aifc files) or au or sun (for  sun  .au  PCM
104              files)  or  cdr  or  raw (for headerless files to be used for cd
105              writers).
106
107       -C endianess  --cdrom-endianess
108              sets endianess of  the  input  samples  to  'little',  'big'  or
109              'guess' to override defaults.
110
111       -E endianess  --output-endianess
112              sets  endianess  of  the  output samples to 'little' or 'big' to
113              override defaults.
114
115       -d duration  --duration
116              sets recording time in seconds or frames.  Frames (sectors)  are
117              indicated by a 'f' suffix (like 75f for 75 sectors).  0 sets the
118              time for whole track.
119
120       -B  --bulk --alltracks
121              copies each track into a separate file.
122
123       -w  --wait
124              waits for signal, then start recording.
125
126       -F  --find-extremes
127              finds extreme amplitudes in samples.
128
129       -G  --find-mono
130              finds if input samples are in mono.
131
132       -T  --deemphasize
133              undo the effect of pre-emphasis in the input samples.
134
135       -e  --echo
136              copies audio data to sound device e.g.  /dev/dsp.
137
138       -p  percentage --set-pitch
139              changes pitch of audio data copied to sound device.
140
141       -v  itemlist  --verbose-level
142              prints verbose information about the CD.  Level  is  a  list  of
143              comma  separated suboptions. Each suboption controls the type of
144              information to be reported.
145
146              ┌──────────┬───────────────────────────────────────────────────┐
147              │Suboption │                    Description                    │
148              ├──────────┼───────────────────────────────────────────────────┤
149              │  disable │ no information is given, warnings appear however  │
150              ├──────────┼───────────────────────────────────────────────────┤
151              │      all │ all information is given                          │
152              ├──────────┼───────────────────────────────────────────────────┤
153              │      toc │ show table of contents                            │
154              ├──────────┼───────────────────────────────────────────────────┤
155              │  summary │ show a summary of the recording parameters        │
156              ├──────────┼───────────────────────────────────────────────────┤
157              │  indices │ determine and display index offsets               │
158              ├──────────┼───────────────────────────────────────────────────┤
159              │  catalog │ retrieve and display the media catalog number MCN │
160              ├──────────┼───────────────────────────────────────────────────┤
161              │  trackid │ retrieve and display all International Standard   │
162              │          │ Recording Codes ISRC                              │
163              ├──────────┼───────────────────────────────────────────────────┤
164              │  sectors │ show the table of contents in start sector nota‐  │
165              │          │ tion                                              │
166              ├──────────┼───────────────────────────────────────────────────┤
167              │   titles │ show the table of contents with track titles      │
168              │          │ (when available)                                  │
169              └──────────┴───────────────────────────────────────────────────┘
170       -N  --no-write
171              does  not  write  to  a  file, it just reads (for debugging pur‐
172              poses).
173
174       -J  --info-only
175              does not write to a file, it just gives  information  about  the
176              disc.
177
178       -L  cddb mode --cddb
179              does a cddbp album- and track title lookup based on the cddb id.
180              The parameter cddb mode defines how multiple  entries  shall  be
181              handled.
182
183              ┌──────────┬──────────────────────────────────────────┐
184              │Parameter │               Description                │
185              ├──────────┼──────────────────────────────────────────┤
186              │        0 │ interactive mode. The user selects the   │
187              │          │ entry to use.                            │
188              ├──────────┼──────────────────────────────────────────┤
189              │        1 │ first fit mode. The first entry is taken │
190              │          │ unconditionally.                         │
191              └──────────┴──────────────────────────────────────────┘
192        cddbp-server=servername
193              sets the server to be contacted for title lookups.
194
195        cddbp-port=portnumber
196              sets the port number to be used for title lookups.
197
198       -H  --no-infofile
199              does not write an info file and a cddb file.
200
201       -g  --gui
202              formats the output to be better parsable by gui frontends.
203
204       -M  count --md5
205              enables  calculation  of  MD-5 checksum for 'count' bytes from a
206              beginning of a track.
207
208       -S  speed --speed
209              sets the cdrom device to one of the selectable speeds for  read‐
210              ing.
211
212       -q  --quiet
213              quiet operation, no screen output.
214
215       -V  --verbose-SCSI
216              enable  SCSI command logging to the console. This is mainly used
217              for debugging.
218
219       -Q  --silent-SCSI
220              suppress SCSI command error reports  to  the  console.  This  is
221              mainly used for guis.
222
223       -scanbus
224              Scan  all  SCSI devices on all SCSI busses and print the inquiry
225              strings. This option may be used to find  SCSI  address  of  the
226              CD/DVD-Recorder  on a system.  The numbers printed out as labels
227              are computed by: bus * 100 + target
228
229       --devices
230              Like -scanbus but works in a more  native  way,  respecting  the
231              device  name  specification on the current operating system. See
232              wodim(1) for details.
233
234       -paranoia
235              use the paranoia library instead of icedax's routines for  read‐
236              ing.
237
238       -h  --help
239              display version of icedax on standard output.
240
241       Defaults depend on the
242              Makefile    and   environment   variable   settings   (currently
243              CDDA_DEVICE ).
244

ENVIRONMENT VARIABLES

246       CDDA_DEVICE is used to set the device name. The device naming  is  com‐
247       patible with the one used by the wodim tool.
248
249       CDDBP_SERVER
250              is used for cddbp title lookups when supplied.
251
252       CDDBP_PORT
253              is used for cddbp title lookups when supplied.
254
255       RSH    If  the  RSH environment variable is present, the remote connec‐
256              tion will not be created via rcmd(3) but by calling the  program
257              pointed  to  by  RSH.   Use  e.g.   RSH=/usr/bin/ssh to create a
258              secure shell connection.
259
260              Note that this forces icedax to create a pipe to the rsh(1) pro‐
261              gram  and disallows icedax to directly access the network socket
262              to the remote server.  This makes it impossible to set  up  per‐
263              formance  parameters and slows down the connection compared to a
264              root initiated rcmd(3) connection.
265
266       RSCSI  If the RSCSI environment variable is present,  the  remote  SCSI
267              server  will  not  be the program /opt/schily/sbin/rscsi but the
268              program pointed to by RSCSI.  Note that the remote  SCSI  server
269              program name will be ignored if you log in using an account that
270              has been created with a remote  SCSI  server  program  as  login
271              shell.
272

RETURN VALUES

274       icedax  uses  the  following  exit codes to indicate various degrees of
275       success:
276
277       ┌─────────┬───────────────────────────────────────────────────────────┐
278       │Exitcode │                        Description                        │
279       ├─────────┼───────────────────────────────────────────────────────────┤
280       │       0 │ no errors encountered, successful operation.              │
281       ├─────────┼───────────────────────────────────────────────────────────┤
282       │       1 │ usage or syntax error. icedax got inconsistent arguments. │
283       ├─────────┼───────────────────────────────────────────────────────────┤
284       │       2 │ permission (un)set errors. permission changes failed.     │
285       ├─────────┼───────────────────────────────────────────────────────────┤
286       │       3 │ read errors on the cdrom/burner device encountered.       │
287       ├─────────┼───────────────────────────────────────────────────────────┤
288       │       4 │ write errors while writing one of the output files        │
289       │         │ encountered.                                              │
290       ├─────────┼───────────────────────────────────────────────────────────┤
291       │       5 │ errors with soundcard handling (initialization/write).    │
292       ├─────────┼───────────────────────────────────────────────────────────┤
293       │       6 │ errors with stat() system call on the read device (cooked │
294       │         │ ioctl).                                                   │
295       ├─────────┼───────────────────────────────────────────────────────────┤
296       │       7 │ pipe communication errors encountered (in forked mode).   │
297       ├─────────┼───────────────────────────────────────────────────────────┤
298       │       8 │ signal handler installation errors encountered.           │
299       ├─────────┼───────────────────────────────────────────────────────────┤
300       │       9 │ allocation of shared memory failed (in forked mode).      │
301       ├─────────┼───────────────────────────────────────────────────────────┤
302       │      10 │ dynamic heap memory allocation failed.                    │
303       ├─────────┼───────────────────────────────────────────────────────────┤
304       │      11 │ errors on the audio cd medium encountered.                │
305       ├─────────┼───────────────────────────────────────────────────────────┤
306       │      12 │ device open error in ioctl handling detected.             │
307       ├─────────┼───────────────────────────────────────────────────────────┤
308       │      13 │ race condition in ioctl interface handling detected.      │
309       ├─────────┼───────────────────────────────────────────────────────────┤
310       │      14 │ error in ioctl() operation encountered.                   │
311       ├─────────┼───────────────────────────────────────────────────────────┤
312       │      15 │ internal error encountered. Please report back!!!         │
313       ├─────────┼───────────────────────────────────────────────────────────┤
314       │      16 │ error in semaphore operation encountered (install /       │
315       │         │ request).                                                 │
316       ├─────────┼───────────────────────────────────────────────────────────┤
317       │      17 │ could not get the scsi transfer buffer.                   │
318       ├─────────┼───────────────────────────────────────────────────────────┤
319       │      18 │ could not create pipes for process communication (in      │
320       │         │ forked mode).                                             │
321       └─────────┴───────────────────────────────────────────────────────────┘

DISCUSSION

323       icedax is able to read parts of an audio CD or multimedia  CDROM  (con‐
324       taining  audio parts) directly digitally. These parts can be written to
325       a file, a pipe, or to a sound device.
326
327       icedax stands for CDDA to WAV (where CDDA stands for compact disc digi‐
328       tal  audio  and WAV is a sound sample format introduced by MS Windows).
329       It allows copying CDDA audio data from the CDROM drive into a  file  in
330       WAV or other formats.
331
332       The  latest  versions try to get higher real-time scheduling priorities
333       to ensure smooth (uninterrupted) operation. These priorities are avail‐
334       able  for  super users and are higher than those of 'normal' processes.
335       Thus delays are minimized.
336
337       If your CDROM is on device DEV and it is loaded with an audio  CD,  you
338       may  simply  invoke  icedax  dev=DEV  and it will create the sound file
339       audio.wav recording the whole track beginning with track 1 in stereo at
340       16  bit  at  44100 Hz sample rate, if your file system has enough space
341       free.  Otherwise recording time will be limited. For details see  files
342       README and README.INSTALL
343

HINTS ON OPTIONS

345       Options
346              Most  of  the  options are used to control the format of the WAV
347              file. In the following text all of them are described.
348
349       Select Device
350              -D device selects the CDROM drive device to be used.  The speci‐
351              fier  given  should  correspond  to  the selected interface (see
352              below).  CHANGE!  For the cooked_ioctl  interface  this  is  the
353              cdrom  device  descriptor as before.  The SCSI devices used with
354              the generic SCSI interface however are now addressed with  their
355              SCSI-Bus,  SCSI-Id,  and  SCSI-Lun  instead  of the generic SCSI
356              device descriptor!!!  One example for a SCSI CDROM drive on  bus
357              0 with SCSI ID 3 and lun 0 is -D0,3,0.
358
359       Select Auxiliary device
360              -A  auxdevice  is necessary for CD-Extra handling. For Non-SCSI-
361              CDROM drives this is the same device as given by -D (see above).
362              For  SCSI-CDROM drives it is the CDROM drive (SCSI) device (i.e.
363              /dev/sr0 ) corresponding to the SCSI device (i.e.  0,3,0  ).  It
364              has to match the device used for sampling.
365
366       Select Interface
367              -I  interface selects the CDROM drive interface. For SCSI drives
368              use generic_scsi (cooked_ioctl may not yet be available for  all
369              devices):  generic_scsi  and  cooked_ioctl.   The first uses the
370              generic SCSI interface, the latter uses the ioctl of  the  CDROM
371              driver.  The  latter  variant  works only when the kernel driver
372              supports CDDA reading. This entry  has  to  match  the  selected
373              CDROM device (see above).
374
375       Enable echo to soundcard
376              -e  copies  audio data to the sound card while recording, so you
377              hear it nearly simultaneously. The soundcard gets the same  data
378              that  is  recorded. This is time critical, so it works best with
379              the -q option.  To use icedax as  a  pseudo  CD  player  without
380              recording  in  a  file  you could use icedax -q -e -t2 -d0 -N to
381              play the whole second track. This feature reduces the  recording
382              speed  to  at most onefold speed. You cannot make better record‐
383              ings than your sound card can  play  (since  the  same  data  is
384              used).
385
386       Change pitch of echoed audio
387              -p  percentage  changes the pitch of all audio echoed to a sound
388              card. Only the copy to the soundcard is affected,  the  recorded
389              audio samples in a file remain the same.  Normal pitch, which is
390              the default, is given by 100%.  Lower percentages correspond  to
391              lower  pitches,  i.e.   -p  50  transposes  the audio output one
392              octave lower.  See also the script pitchplay as an example. This
393              option was contributed by Raul Sobon.
394
395       Select mono or stereo recording
396              -m  or  -c  1  selects  mono recording (both stereo channels are
397              mixed), -s or -c 2 or -c s selects stereo recording. Parameter s
398              will swap both sound channels.
399
400       Select maximum quality
401              -x  will  set  stereo,  16  bits per sample at 44.1 KHz (full CD
402              quality).  Note that other format options given later can change
403              this setting.
404
405       Select sample quality
406              -b  8  specifies 8 bit (1 Byte) for each sample in each channel;
407              -b 12 specifies 12 bit (2 Byte) for each sample in each channel;
408              -b  16 specifies 16 bit (2 Byte) for each sample in each channel
409              (Ensure that your sample player or  sound  card  is  capable  of
410              playing  12-bit or 16-bit samples). Selecting 12 or 16 bits dou‐
411              bles file size.  12-bit samples are aligned to  16-bit  samples,
412              so they waste some disk space.
413
414       Select sample rate
415              -r  samplerate  selects  a  sample rate.  samplerate can be in a
416              range between 44100 and  900.  Option  -R  lists  all  available
417              rates.
418
419       Select sample rate divider
420              -a  divider selects a sample rate divider.  divider can be mini‐
421              mally 1 and maximally 50.5 and everything between  in  steps  of
422              0.5.  Option -R lists all available rates.
423
424              To  make the sound smoother at lower sampling rates, icedax sums
425              over n samples (where n is the specific dividend). So for  22050
426              Hertz  output  we  have  to sum over 2 samples, for 900 Hertz we
427              have to sum over 49 samples.  This cancels  higher  frequencies.
428              Standard  sector size of an audio CD (ignoring additional infor‐
429              mation) is 2352 Bytes. In order to finish summing for an  output
430              sample  at  sector boundaries the rates above have to be chosen.
431              Arbitrary sampling rates in  high  quality  would  require  some
432              interpolation  scheme,  which needs much more sophisticated pro‐
433              gramming.
434
435       List a table of all sampling rates
436              -R shows a list of all sample rates and their dividers. Dividers
437              can range from 1 to 50.5 in steps of 0.5.
438
439       Select start track and optionally end track
440              -t n+m selects n as the start track and optionally m as the last
441              track of a range to be recorded.  These tracks must be from  the
442              table  of contents.  This sets the track where recording begins.
443              Recording can advance through the following tracks as well (lim‐
444              ited by the optional end track or otherwise depending on record‐
445              ing time). Whether one file or different files are then  created
446              depends on the -B option (see below).
447
448       Select start index
449              -i  n  selects the index to start recording with.  Indices other
450              than 1 will invoke the index scanner, which will take some  time
451              to find the correct start position. An offset may be given addi‐
452              tionally (see below).
453
454       Set recording time
455              -d  n sets recording time to n seconds or set recording time for
456              whole  track  if  n is zero. In order to specify the duration in
457              frames (sectors) also, the argument can have  an  appended  'f'.
458              Then  the  numerical argument is to be taken as frames (sectors)
459              rather than seconds.  Please note that if track ranges are being
460              used  they define the recording time as well thus overriding any
461              -d option specified times.
462
463              Recording time is defined as the time the generated sample  will
464              play  (at  the  defined  sample rate). Since it's related to the
465              amount of generated samples, it's not the time of  the  sampling
466              process  itself  (which  can  be  less  or  more).  It's neither
467              strictly coupled with the  time  information  on  the  audio  CD
468              (shown  by  your  hifi CD player).  Differences can occur by the
469              usage of the -o option (see below). Notice that  recording  time
470              will  be  shortened,  unless enough disk space exists. Recording
471              can be aborted at anytime by pressing the break character  (sig‐
472              nal SIGQUIT).
473                 .IP  "Record  all  tracks  of a complete audio CD in separate
474              files" -B copies each track into a separate file.  A  base  name
475              can  be  given.  File names have an appended track number and an
476              extension corresponding to the audio format. To record all audio
477              tracks of a CD, use a sufficient high duration (i.e. -d99999).
478
479       Set start sector offset
480              -o  sectors increments start sector of the track by sectors.  By
481              this option you are able to skip a certain amount at the  begin‐
482              ning  of a track so you can pick exactly the part you want. Each
483              sector runs for 1/75 seconds, so you have very fine control.  If
484              your  offset  is  so high that it would not fit into the current
485              track, a warning message is issued and the  offset  is  ignored.
486              Recording time is not reduced.  (To skip introductory quiet pas‐
487              sages automagically, use the -w option see below.)
488
489       Wait for signal option
490              -w Turning on this option will suppress  all  silent  output  at
491              startup, reducing possibly file size.  icedax will watch for any
492              signal in the output signal and switches on writing to file.
493
494       Find extreme samples
495              -F Turning on this option will display the most negative and the
496              most positive sample value found during recording for both chan‐
497              nels. This can be useful for readjusting the volume. The  values
498              shown are not reset at track boundaries, they cover the complete
499              sampling process. They are taken from the original  samples  and
500              have  the same format (i.e. they are independent of the selected
501              output format).
502
503       Find if input samples are in mono
504              -G If this option is given, input samples for both channels will
505              be  compared.  At  the end of the program the result is printed.
506              Differences in the channels indicate stereo, otherwise when both
507              channels are equal it will indicate mono.
508
509       Undo the pre-emphasis in the input samples
510              -T  Some  older audio CDs are recorded with a modified frequency
511              response called pre-emphasis. This is found mostly in  classical
512              recordings. The correction can be seen in the flags of the Table
513              Of Contents often. But there are recordings, that show this set‐
514              ting only in the subchannels. If this option is given, the index
515              scanner will be started, which reads the  q-subchannel  of  each
516              track.  If  pre-emphasis  is  indicated in the q-subchannel of a
517              track, but not in the TOC, pre-emphasis will be  assumed  to  be
518              present,  and  subsequently a reverse filtering is done for this
519              track before the samples are written into the audio file.
520
521       Set audio format
522              -O  audiotype can be wav (for wav files) or au or sun  (for  sun
523              PCM files) or cdr or raw (for headerless files to be used for cd
524              writers).  All file samples are coded in linear pulse code modu‐
525              lation  (as  done  in the audio compact disc format). This holds
526              for all audio formats.  Wav  files  are  compatible  to  Wind*ws
527              sound  files,  they have lsb,msb byte order as being used on the
528              audio cd. The default filename extension is  '.wav'.   Sun  type
529              files  are  not  like the older common logarithmically coded .au
530              files, but instead as mentioned above linear PCM  is  used.  The
531              byte  order  is  msb,lsb  to be compatible. The default filename
532              extension is '.au'.  The AIFF and the newer  variant  AIFC  from
533              the  Apple/SGI  world  store  their  samples in bigendian format
534              (msb,lsb). In AIFC no compression is used.  Finally the  easiest
535              'format',  the  cdr  aka  raw  format. It is done per default in
536              msb,lsb byte order to satisfy the order wanted by most cd  writ‐
537              ers.  Since  there  is no header information in this format, the
538              sample parameters can only be identified by playing the  samples
539              on  a  soundcard  or  similar. The default filename extension is
540              '.cdr' or '.raw'.
541
542       Select cdrom drive reading speed
543              -S  speed allows to switch the cdrom drive to a certain level of
544              speed in order to reduce read errors. The argument is transfered
545              verbatim to the drive.  Details depend very much  on  the  cdrom
546              drives.  An argument of 0 for example is often the default speed
547              of the drive, a value of 1 often selects single speed.
548
549       Enable MD5 checksums
550              -M  count enables calculation of MD-5 checksum for 'count' bytes
551              from  the  beginning  of  a track. This was introduced for quick
552              comparisons of tracks.
553
554       Use Monty's libparanoia for reading of sectors
555              -paranoia selects an alternate way of extracting audio  sectors.
556              Monty's library is used with the following default options:
557
558              PARANOIA_MODE_FULL, but without PARANOIA_MODE_NEVERSKIP
559
560              for details see Monty's libparanoia documentation.  In this case
561              the option -P has no effect.
562
563       Do linear or overlapping reading of sectors
564              (This applies unless option -paranoia  is  used.)   -P   sectors
565              sets  the  given  number of sectors for initial overlap sampling
566              for jitter correction. Two cases are to  be  distinguished.  For
567              nonzero  values,  some sectors are read twice to enable icedax's
568              jitter correction.  If an argument of zero is given, no  overlap
569              sampling  will  be  used.   For  nonzero  overlap sectors icedax
570              dynamically adjusts the setting during sampling (like cdparanoia
571              does).   If  no match can be found, icedax retries the read with
572              an increased overlap.  If the amount of jitter is lower than the
573              current  overlapped samples, icedax reduces the overlap setting,
574              resulting in a higher reading speed.  The argument given has  to
575              be  lower  than  the  total  number  of sectors per request (see
576              option -n below).  Icedax will check this setting and  issues  a
577              error  message  otherwise.   The case of zero sectors is nice on
578              low load situations or errorfree (perfect) cdrom drives and per‐
579              fect (not scratched) audio cds.
580
581       Set the transfer size
582              -n   sectors will set the transfer size to the specified sectors
583              per request.
584
585       Set number of ring buffer elements
586              -l  buffers will allocate the specified number  of  ring  buffer
587              elements.
588
589       Set endianess of input samples
590              -C   endianess  will  override the default settings of the input
591              format.  Endianess can be set explicitly to "little" or "big" or
592              to  the  automatic  endianess  detection  based  on  voting with
593              "guess".
594
595       Set endianess of output samples
596              -E  endianess (endianess can be "little" or "big") will override
597              the default settings of the output format.
598
599       Verbose option
600              -v  itemlist prints more information. A list allows selection of
601              different information items.
602
603              disable keeps quiet
604
605              toc displays the table of contents
606
607              summary displays a summary of recording parameters
608
609              indices invokes the index scanner and displays  start  positions
610              of indices
611
612              catalog retrieves and displays a media catalog number
613
614              trackid  retrieves and displays international standard recording
615              codes
616
617              sectors displays track start positions in absolute sector  nota‐
618              tion
619
620              To  combine  several requests just list the suboptions separated
621              with commas.
622
623       The table of contents
624              The display will show the  table  of  contents  with  number  of
625              tracks and total time (displayed in mm:ss.hh format, mm=minutes,
626              ss=seconds, hh=rounded 1/100 seconds).  The following list  dis‐
627              plays  track  number and track time for each entry.  The summary
628              gives a line per track describing the type of the track.
629
630                      track preemphasis copypermitted tracktype chans
631
632              The track column holds the track number.  preemphasis  shows  if
633              that  track  has  been  given  a  non linear frequency response.
634              NOTE: You can undo this effect with the -T option.  copy-permit‐
635              ted  indicates  if this track is allowed to copy.  tracktype can
636              be data or audio. On multimedia CDs (except  hidden  track  CDs)
637              both  of  them should be present.  channels is defined for audio
638              tracks only. There can be two or four channels.
639
640       No file output
641              -N this debugging option switches off writing to a file.
642
643       No infofile generation
644              -H this option switches off creation of an info file and a  cddb
645              file.
646
647       Generation of simple output for gui frontends
648              -g  this  option  switches  on  simple line formatting, which is
649              needed to support gui frontends (like xcd-roast).
650
651       Verbose SCSI logging
652              -V this option switches on logging of SCSI commands.  This  will
653              produce  a  lot  of  output  (when SCSI devices are being used).
654              This is needed for debugging purposes. The format is the same as
655              being used with the cdrecord program from Joerg Schilling or the
656              wodim tool. See there for details.
657
658       Quiet option
659              -q suppresses all screen output  except  error  messages.   That
660              reduces cpu time resources.
661
662       Just show information option
663              -J  does  not write a file, it only prints information about the
664              disc (depending on the -v option). This is just for  information
665              purposes.
666

CDDBP support

668       Lookup album and track titles option
669              -L   cddbp  mode Icedax tries to retrieve performer, album-, and
670              track titles from a cddbp server. The default server  right  now
671              is 'freedb.freedb.org'.  It is planned to have more control over
672              the server handling later.  The parameter defines  how  multiple
673              entries are handled:
674
675       0        interactive mode, the user chooses one of the entries.
676
677       1        take the first entry without asking.
678
679       Set server for title lookups
680              cddbp-server   servername  When  using  -L or --cddb, the server
681              being contacted can be set with this option.
682
683       Set portnumber for title lookups
684              cddbp-port  portnumber When using -L or --cddb, the server  port
685              being contacted can be set with this option.
686

HINTS ON USAGE

688       Don't  create  samples  you cannot read. First check your sample player
689       software and sound card hardware. I experienced problems with very  low
690       sample  rates  (stereo <= 1575 Hz, mono <= 3675 Hz) when trying to play
691       them with standard WAV players for sound blaster (maybe  they  are  not
692       legal  in  WAV  format).  Most  CD-Writers insist on audio samples in a
693       bigendian format.  Now icedax supports the -E  endianess option to con‐
694       trol the endianess of the written samples.
695
696       If your hardware is fast enough to run icedax uninterrupted and your CD
697       drive is one of the 'perfect' ones, you will gain speed when  switching
698       all overlap sampling off with the -P  0 option. Further fine tuning can
699       be done with the -n  sectors option. You can specify how  much  sectors
700       should be requested in one go.
701
702       Icedax supports pipes now. Use a filename of - to let icedax output its
703       samples to standard output.
704
705       Conversion to other sound formats can be done  using  the  sox  program
706       package (although the use of sox -x to change the byte order of samples
707       should be no more necessary; see option -E to change the  output  byte‐
708       order).
709
710       If  you  want to sample more than one track into different files in one
711       run, this is currently possible with the -B option. When recording time
712       exceeds the track limit a new file will be opened for the next track.
713

FILES

715       Icedax can generate a lot of files for various purposes.
716
717       Audio files:
718
719       There  are audio files containing samples with default extensions These
720       files are not generated when option (-N) is given. Multiple  files  may
721       be  written  when  the  bulk  copy option (-B) is used. Individual file
722       names can be given as arguments. If the number of file names  given  is
723       sufficient  to  cover all included audio tracks, the file names will be
724       used verbatim.  Otherwise, if there are  less  file  names  than  files
725       needed  to  write the included tracks, the part of the file name before
726       the extension is extended with '_dd' where dd  represents  the  current
727       track number.
728
729       Cddb and Cdindex files:
730
731       If  icedax detects cd-extra or cd-text (album/track) title information,
732       then .cddb and .cdindex files are generated unless  suppressed  by  the
733       option  -H.  They  contain suitable formatted entries for submission to
734       audio cd track  title  databases  in  the  internet.  The  CDINDEX  and
735       CDDB(tm)  systems  are currently supported. For more information please
736       visit www.musicbrainz.org and www.freedb.com.
737
738       Inf files:
739
740       The inf files are describing the sample files and  the  part  from  the
741       audio  cd,  it was taken from. They are a means to transfer information
742       to a cd burning program like wodim. For example, if the original  audio
743       cd had pre-emphasis enabled, and icedax -T did remove the pre-emphasis,
744       then the inf file has pre-emphasis not set (since the audio  file  does
745       not  have it anymore), while the .cddb and the .cdindex have pre-empha‐
746       sis set as the original does.
747

WARNING

749       IMPORTANT: it is prohibited to sell copies of copyrighted  material  by
750       noncopyright  holders. This program may not be used to circumvent copy‐
751       rights.  The user acknowledges this constraint when using the software.
752

BUGS

754       Generation of md5 checksums is currently broken.
755
756       Performance may not be optimal on slower systems.
757
758       The index scanner may give timeouts.
759
760       The resampling (rate conversion code)  uses  polynomial  interpolation,
761       which is not optimal.
762
763       Icedax should use threads.
764
765       Icedax currently cannot sample hidden audio tracks (track 1 index 0).
766

ACKNOWLEDGEMENTS

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

AUTHOR

778       Heiko Eissfeldt heiko@colossus.escape.de
779
780       This manpage describes the program implementation of icedax as  shipped
781       by  the cdrkit distribution. See http://alioth.debian.org/projects/deb
782       burn/ for details. It is a spinoff from the original  program  cdda2wav
783       as  distributed  in  the  cdrtools  package  [1]. However, the cdrtools
784       developers are not involved in the  development  of  this  spinoff  and
785       therefore  shall  not be made responsible for any problem caused by it.
786       Do not try to get support for this program by contacting  the  original
787       authors.
788
789       If you have support questions, send them to
790
791       debburn-devel@lists.alioth.debian.org
792
793       If you have definitely found a bug, send a mail to this list or to
794
795       submit@bugs.debian.org
796
797       writing  at  least  a  short description into the Subject and "Package:
798       cdrkit" into the first line of the mail body.
799
800

DATE

802       26 Sep 2006
803
804

SOURCES

806       [1] Cdrtools 2.01.01a08 from May 2006, http://cdrecord.berlios.de
807
808
809
810
811                                                                     ICEDAX(1)
Impressum