| 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, ⪚ |
| 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, ⪚ |
| 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, ⪚ |
| 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, ⪚ |
| 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&paranoia_level=0&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> |