1Cdda2wav User guide
2===================
3
4NOTE: 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
9Common tasks
10============
11NOTE: The examples used here depend on proper default settings for interface
12method and devices as specified in the Makefile. They can be overriden with
13command line parameters, but here I choose to focus on simple examples.
14
15Copy complete audio CDs
16
171. Copy an audio CD into wav files one per track.
18
19	cdda2wav -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
312. Same as above but include MD-5 type signatures
32
33	cdda2wav -B -M<length>
34
35
363. Same as above but use other file name ('party_cd.wav')
37
38	cdda2wav -B -M<length> party_cd.wav
39
40
41Copy single tracks
42
431. Copy one track (eg track 6) into a wav file.
44
45	cdda2wav -t6
46
47   will produce a wav file including track 6
48
49	audio.wav
50
51   and
52
53	audio.inf
54
55
56Copy parts of tracks
57
581. Copy from given start time to end of track
59
60	cdda2wav -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
652. Copy from given start time and record for a given time
66
67	cdda2wav -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
74Copy tracks into a pipe
75
76	cdda2wav -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
81an audio cd with a MPEG-Layer3 encoder (not included here).)
82
83
84Miscellaneous
85
861. Use cdda2wav as a cd player
87
88	cdda2wav -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
952. Get complete information on the cd
96
97	cdda2wav -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.
102