Debian Codegraph @

doc/index.docbook

raw
1 <?xml version="1.0" ?>
2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
3 "dtd/kdedbx45.dtd" [
4 <!ENTITY % addindex "IGNORE">
5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
6 ]>
7
8 <article lang="&language;" id="audiocd">
9 <title>audiocd</title>
10 <articleinfo>
11 <authorgroup>
12 <author>&Rik.Hemsley; &Rik.Hemsley.mail;</author>
13 <author><personname><firstname>Benjamin</firstname><surname>Meyer</surname></personname></author>
14 <!-- TRANS:ROLES_OF_TRANSLATORS -->
15 </authorgroup>
16
17 <date>2004-09-16</date>
18 <releaseinfo>2.30.00</releaseinfo>
19
20 </articleinfo>
21
22 <para>Allows treating audio <acronym>CD</acronym>s like a
23 <quote>real</quote> filesystem, where tracks are represented as files
24 and, when copied from the folder, are digitally extracted from the
25 <acronym>CD</acronym>. This ensures a perfect copy of the audio
26 data.</para>
27
28 <para>To see how this KIO worker works, insert an audio <acronym>CD</acronym>
29 in your &CD-ROM; drive and type <userinput>audiocd:/</userinput> into
30 &konqueror;. Within a few seconds you should see a list of tracks and
31 some folders.</para>
32
33 <para>Audio <acronym>CD</acronym>s don't really have folders, but
34 the audiocd KIO worker provides them as a convenience. If you look inside
35 these folders you will see that they all contain the same number of
36 tracks. If you are connected to the Internet, some folders will have
37 the actual track titles shown as the filenames.</para>
38
39 <para>The reason that these separate folders exist are so that you
40 can choose in which format you would like to listen to (or copy) the
41 tracks on the <acronym>CD</acronym>.</para>
42
43 <para>If you drag a track from the <filename class="directory">Ogg
44 Vorbis</filename> folder and drop it on another &konqueror; window
45 open at your home folder, you should see a progress window showing
46 you that the track is being extracted from the <acronym>CD</acronym> and
47 saved to a file. Note that Ogg Vorbis is a compressed format, so the
48 file in your home folder will appear a great deal smaller than it
49 would have been if you had copied the raw data.</para>
50
51 <para>The mechanism behind this is quite simple. When the audiocd KIO worker
52 is asked to retrieve a track from the <filename class="directory">Ogg
53 Vorbis</filename> folder, it starts extracting the digital audio data
54 from the <acronym>CD</acronym>. As it sends the data over to the file in
55 your home folder, it simultaneously encodes it in Ogg Vorbis format
56 (<acronym>CD</acronym> audio is in an uncompressed format to start
57 with).</para>
58
59 <para>You could also try dragging a file ending in <literal
60 role="extension">.wav</literal> and dropping it on the &kde; Media
61 Player, &juk;. In this case, the procedure that happens behind the
62 scenes is similar, except that instead of encoding the audio data in Ogg
63 Vorbis format, it is put through a very simple conversion, from raw
64 binary data (which the <literal role="extension">.cda</literal> files in
65 the toplevel folder represent) to <quote>RIFF WAV</quote> format, a
66 non-compressed format that most media players understand.</para>
67
68 <para>&juk; should quite happily play the <literal
69 role="extension">.wav</literal> file, but if it has trouble, you may
70 consider using the <option>paranoia_level</option> option, explained
71 below.</para>
72
73 <variablelist>
74 <title>Options</title>
75
76 <varlistentry>
77 <term><option>device</option></term>
78 <listitem>
79 <para>Set the path to the audio <acronym>CD</acronym> device, &eg;
80 <userinput>audiocd:/<option>?device</option>=<parameter>/dev/sdc</parameter></userinput>.
81 Normally, the KIO worker will try to find a <acronym>CD</acronym> drive with
82 an audio <acronym>CD</acronym> inserted, but if it fails or you have
83 more than one <acronym>CD</acronym> drive, you may want to try this
84 option. Note that the configuration dialog allows you to set a default
85 value for this option.</para>
86 </listitem>
87 </varlistentry>
88
89 <varlistentry>
90 <term><option>fileNameTemplate</option></term>
91 <listitem>
92 <para>Set the file name template, &eg;
93 <userinput>audiocd:/<option>?fileNameTemplate</option>=<parameter>Track %{number}</parameter></userinput>. Note that the configuration dialog allows you to set a default value for this option. A warning that if you set it to an empty string no files will show up.</para>
94 </listitem>
95 </varlistentry>
96
97 <varlistentry>
98 <term><option>albumNameTemplate</option></term>
99 <listitem>
100 <para>Set the album name template, &eg;
101 <userinput>audiocd:/<option>?albumNameTemplate</option>=<parameter>%{albumartist} %{albumtitle}</parameter></userinput>. Note that the configuration dialog allows you to set a default value for this option.</para>
102 </listitem>
103 </varlistentry>
104
105 <varlistentry>
106 <term><option>niceLevel</option></term>
107 <listitem>
108 <para>Sets the process nice level for encoders, &eg;
109 <userinput>audiocd:/<option>?albumNameTemplate</option>=<parameter>niceLevel=10</parameter></userinput>. Note that the configuration dialog allows you to set a default value for this option.</para>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry>
114 <term><option>paranoia_level</option></term>
115 <listitem>
116 <para>Set the amount of error detection and correction used when
117 extracting data.</para>
118
119 <variablelist>
120 <varlistentry>
121 <term>Level 0</term>
122 <listitem>
123 <para>No detection or correction. Only useful if you have a perfect
124 <acronym>CD</acronym> drive (unlikely).</para>
125 </listitem>
126 </varlistentry>
127
128 <varlistentry>
129 <term>Level 1</term>
130 <listitem>
131 <para>Enable basic error checking and correction.</para>
132 </listitem>
133 </varlistentry>
134
135 <varlistentry>
136 <term>Level 2</term>
137 <listitem>
138 <para>Default. Specifies that only a perfect extraction will be
139 accepted.</para>
140 </listitem>
141 </varlistentry>
142 </variablelist>
143
144 <para>Note that there is a disadvantage to level 2. Extraction can be
145 very slow, so real-time digital playback may not work properly. If you
146 have a good quality <acronym>CD</acronym> drive (note that more
147 expensive does not necessarily mean better quality) then you probably
148 won't experience very slow extraction, but a poor drive may take days
149 (!) to extract the audio from one <acronym>CD</acronym>.</para>
150 </listitem>
151 </varlistentry>
152
153 <varlistentry>
154 <term><option>cddbChoice</option></term>
155 <listitem>
156
157 <para>Specify which Internet <acronym>CD</acronym> Database entry to use. Audio
158 <acronym>CD</acronym>s don't have track names, but the Internet
159 <acronym>CD</acronym> Database is a clever system which uses a special
160 unique identifier generated from the number and length of tracks on each
161 <acronym>CD</acronym> to cross-reference a track listing. Track listings
162 are contributed by the Internet community and made available to
163 all. Occasionally there will be multiple entries. You can specify which one to use.</para>
164
165 <para>You can submit your own track listings using &kscd;, the &kde;
166 <acronym>CD</acronym> player.</para>
167
168 <para>By default audiocd tries to pick the best one.</para>
169 </listitem>
170 </varlistentry>
171 </variablelist>
172
173 <variablelist>
174 <title>Examples</title>
175 <varlistentry>
176 <term><userinput>audiocd:/?device=/dev/scd0&amp;paranoia_level=0&amp;cddbChoice=0</userinput></term>
177 <listitem>
178 <para>Gives a listing of the tracks on the audio <acronym>CD</acronym>
179 inserted in <filename class="devicefile">/dev/scd0</filename>, which on
180 &Linux; specifies the first <acronym>SCSI</acronym> &CD-ROM; device. If
181 you copy tracks from the <acronym>CD</acronym>, digital extraction will
182 be performed without error correction or detection. The
183 <acronym>CDDB</acronym> Database entry 0 will be used.</para>
184 </listitem>
185 </varlistentry>
186 </variablelist>
187
188 <qandaset>
189 <title>Frequently Asked Question</title>
190 <qandaentry>
191 <question>
192 <para>I get <errorname>The file or folder / does not
193 exist</errorname>. How do I fix that? I have an audio
194 <acronym>CD</acronym> in my drive!</para>
195 </question>
196
197 <answer>
198 <para>Try running <userinput><command>cdparanoia</command>
199 <option>-vsQ</option></userinput> as yourself (not <systemitem
200 class="username">root</systemitem>). Do you see a track list? If not,
201 make sure you have permission to access the <acronym>CD</acronym>
202 device. If you're using <acronym>SCSI</acronym> emulation (possible if
203 you have an <acronym>IDE</acronym> <acronym>CD</acronym> writer) then
204 make sure you check that you have read and write permissions on the
205 generic <acronym>SCSI</acronym> device, which is probably <filename
206 class="devicefile">/dev/sg0</filename>, <filename
207 class="devicefile">/dev/sg1</filename>, &etc; If it still doesn't work,
208 try typing <userinput>audiocd:/?device=/dev/sg0</userinput> (or similar)
209 to tell kio_audiocd which device your &CD-ROM; is.</para>
210 </answer>
211 </qandaentry>
212 </qandaset>
213
214
215 </article>