Imported Upstream version 1.1.11
[platform/upstream/cdrkit.git] / doc / icedax / HOWTOUSE
1 Icedax User guide
2 =================
3
4 NOTE: expressions in angle braces have to be substituted with
5       the corresponding numerical values.
6       For example: <delay in seconds> has to be substituted
7         with the numerical value to be used.
8
9 Common tasks
10 ============
11 NOTE: The examples used here depend on proper default settings for interface
12 method and devices as specified in the Makefile. They can be overriden with
13 command line parameters, but here I choose to focus on simple examples. 
14
15 Copy complete audio CDs
16
17 1. Copy an audio CD into wav files one per track.
18
19         icedax -B
20
21    will produce the sample wav files (one per track)
22         audio_01.wav
23         audio_02.wav
24         ...
25
26    and the corresponding description files
27         audio_01.inf
28         audio_02.inf
29         ...
30
31 2. Same as above but include MD-5 type signatures
32
33         icedax -B -M<length>
34
35
36 3. Same as above but use other file name ('party_cd.wav')
37
38         icedax -B -M<length> party_cd.wav
39
40
41 Copy single tracks
42
43 1. Copy one track (eg track 6) into a wav file.
44
45         icedax -t6
46
47    will produce a wav file including track 6
48
49         audio.wav
50
51    and
52
53         audio.inf
54
55
56 Copy parts of tracks
57
58 1. Copy from given start time to end of track
59
60         icedax -t6 -o<delay in 1/75 seconds>
61
62    will record track 6 starting at track time <delay>/75 seconds
63    from track beginning upto the end of track.
64
65 2. Copy from given start time and record for a given time
66
67         icedax -t6 -o<delay in 1/75 seconds> -d<time to record in seconds>
68
69    will record track 6 starting at track time <delay>/75 seconds
70    from track beginning for <time to record in seconds> seconds.
71
72
73
74 Copy tracks into a pipe
75
76         icedax -t6 -Oraw - | audio_compressor
77
78    will feed the audio samples (in big endian format) of track 6
79    into a secondary program audio_compressor.
80 (See also script cdda2mp3(.new) for a suggestion, how to process all tracks of
81 an audio cd with a MPEG-Layer3 encoder (not included here).)
82
83
84 Miscellaneous
85
86 1. Use icedax as a cd player
87
88         icedax -eN -t6
89
90    will copy the audio samples into a sound card (if sound card support
91    is compiled in) and will not write any file.
92
93
94
95 2. Get complete information on the cd
96
97         icedax -v63 -Nd0.01
98
99    will try to find out a media catalog number and track related
100    information (ISRCs) in addition to indices. For CD-Extra discs
101    limited support exists to retrieve additional information.