Imported Upstream version 1.1.11
[platform/upstream/cdrkit.git] / doc / READMEs / README.cdtext
1 CD-Text Usage (to copy CD-Text from master CD):
2
3         icedax -D 6,0 -vall -B  # To extract audio information
4         wodim dev=6,0 -vv -toc  # To extract CD-Text information
5
6         and then
7
8         wodim dev=6,0 -v -dao textfile=cdtext.dat -useinfo *.wav
9         or
10         wodim dev=6,0 -v -raw96r textfile=cdtext.dat -useinfo *.wav
11
12         If the CD-Text information contains more CRC errors than
13         wodim can correct, you need to reload the CD and to
14         re-read the CD-Text information from the master disk.
15
16         Writing of CD-Text is supported for all drives that support
17         CD-Text in SAO write mode and for all drives that support
18         to write in RAW/RAW96R mode (use -raw96r in this case).
19
20         NOTE: not all writers that support MMC SAO mode support
21                 to write CD-Text in this write mode.
22                 If you have a drive that does not support CD-Text
23                 but supports RAW/RAW96R mode use this mode as
24                 in RAW/RAW96R mode the drive does not need to know
25                 about CD-Text. This way even old drives like the
26                 Plextor PX-R 412C will write CD-Text.
27
28         NOTE that icedax will read CD-Text and fill in the 
29         CD-Text fields in the *.inf files if vou use -vall.
30
31         The new icedax option cddb= allows you to tell icedax to
32         retrieve CDDB information from freedb.freedb.org.
33         cddb=0 means ask if ambiguous, cddb=1 means take first entry.
34         The information in this case is filled into the fields
35         in the *.inf files.
36
37 Creating a CD with CD-Text based on CDDB information from freedb.freedb.org:
38
39         Tell icedax to fetch data from freedb.freedb.org, call
40
41         icedax -D 6,0 -vall -B cddb=1   # To extract audio information/fetch CDDB data
42
43         and then call
44
45         wodim dev=6,0 -v -dao -text -useinfo *.wav
46         or
47         wodim dev=6,0 -v -raw96r -text -useinfo *.wav
48
49
50 If you like to create your own CD-text data for a CD use the
51 following method:
52
53         First extract all tracks with icedax -vall (see above),
54
55         then edit the *.inf Files and add album and song titles.
56
57         Now call wodim as if the *.nf files contain CD-Text 
58         information.
59
60         Note that it is recommended to use less that 160 characters
61         for a single string.
62
63 Source: README.cdtext from cdrtools package
64 Edited for cdrkit by Christian Fromme <kaner@strace.org> and Eduard Bloch
65