Contents of /nonameyet/trunk/cdda2wav/HOWTOUSE

Cdda2wav User guide
===================

NOTE: expressions in angle braces have to be substituted with
      the corresponding numerical values.
      For example: <delay in seconds> has to be substituted
        with the numerical value to be used.

Common tasks
============
NOTE: The examples used here depend on proper default settings for interface
method and devices as specified in the Makefile. They can be overriden with
command line parameters, but here I choose to focus on simple examples. 

Copy complete audio CDs

1. Copy an audio CD into wav files one per track.

        cdda2wav -B

   will produce the sample wav files (one per track)
        audio_01.wav
        audio_02.wav
        ...

   and the corresponding description files
        audio_01.inf
        audio_02.inf
        ...

2. Same as above but include MD-5 type signatures

        cdda2wav -B -M<length>


3. Same as above but use other file name ('party_cd.wav')

        cdda2wav -B -M<length> party_cd.wav


Copy single tracks

1. Copy one track (eg track 6) into a wav file.

        cdda2wav -t6

   will produce a wav file including track 6

        audio.wav

   and

        audio.inf


Copy parts of tracks

1. Copy from given start time to end of track

        cdda2wav -t6 -o<delay in 1/75 seconds>

   will record track 6 starting at track time <delay>/75 seconds
   from track beginning upto the end of track.

2. Copy from given start time and record for a given time

        cdda2wav -t6 -o<delay in 1/75 seconds> -d<time to record in seconds>

   will record track 6 starting at track time <delay>/75 seconds
   from track beginning for <time to record in seconds> seconds.


Copy tracks into a pipe

        cdda2wav -t6 -Oraw - | audio_compressor

   will feed the audio samples (in big endian format) of track 6
   into a secondary program audio_compressor.
(See also script cdda2mp3(.new) for a suggestion, how to process all tracks of
an audio cd with a MPEG-Layer3 encoder (not included here).)


Miscellaneous

1. Use cdda2wav as a cd player

        cdda2wav -eN -t6

   will copy the audio samples into a sound card (if sound card support
   is compiled in) and will not write any file.


2. Get complete information on the cd

        cdda2wav -v63 -Nd0.01

   will try to find out a media catalog number and track related
   information (ISRCs) in addition to indices. For CD-Extra discs
   limited support exists to retrieve additional information.
1	Cdda2wav 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	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
31	2. Same as above but include MD-5 type signatures
32
33	cdda2wav -B -M<length>
34
35
36	3. Same as above but use other file name ('party_cd.wav')
37
38	cdda2wav -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	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
56	Copy parts of tracks
57
58	1. 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
65	2. 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
74	Copy 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
81	an audio cd with a MPEG-Layer3 encoder (not included here).)
82
83
84	Miscellaneous
85
86	1. 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
95	2. 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.