From 58e69a33b5bf5902d3a224d9210113b3f3d60d4a Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Thu, 6 Feb 2014 17:52:20 -0600 Subject: Reorganize tdeioslave help handbooks, fix related protocol files and issues, update and add handbooks. --- doc/tdeioslave/audiocd.docbook | 208 ----------------------------------------- 1 file changed, 208 deletions(-) delete mode 100644 doc/tdeioslave/audiocd.docbook (limited to 'doc/tdeioslave/audiocd.docbook') diff --git a/doc/tdeioslave/audiocd.docbook b/doc/tdeioslave/audiocd.docbook deleted file mode 100644 index 371d0aa4..00000000 --- a/doc/tdeioslave/audiocd.docbook +++ /dev/null @@ -1,208 +0,0 @@ -
-audiocd - - -&Rik.Hemsley; &Rik.Hemsley.mail; -BenjaminMeyer - - - -2004-09-16 -2.30.00 - - - -Allows treating audio CDs like a -real filesystem, where tracks are represented as files -and, when copied from the folder, are digitally extracted from the -CD. This ensures a perfect copy of the audio -data. - -To see how this slave works, insert an audio CD -in your &CD-ROM; drive and type audiocd:/ into -&konqueror;. Within a few seconds you should see a list of tracks and -some folders. - -Audio CDs don't really have folders, but -the audiocd slave provides them as a convenience. If you look inside -these folders you will see that they all contain the same number of -tracks. If you are connected to the Internet, some folders will have -the actual track titles shown as the filenames. - -The reason that these separate folders exist are so that you -can choose in which format you would like to listen to (or copy) the -tracks on the CD. - -If you drag a track from the Ogg -Vorbis folder and drop it on another &konqueror; window -open at your home folder, you should see a progress window showing -you that the track is being extracted from the CD and -saved to a file. Note that Ogg Vorbis is a compressed format, so the -file in your home folder will appear a great deal smaller than it -would have been if you had copied the raw data. - -The mechanism behind this is quite simple. When the audiocd slave -is asked to retrieve a track from the Ogg -Vorbis folder, it starts extracting the digital audio data -from the CD. As it sends the data over to the file in -your home folder, it simultaneously encodes it in Ogg Vorbis format -(CD audio is in an uncompressed format to start -with). - -You could also try dragging a file ending in .wav and dropping it on the &kde; Media -Player, &noatun;. In this case, the procedure that happens behind the -scenes is similar, except that instead of encoding the audio data in Ogg -Vorbis format, it is put through a very simple conversion, from raw -binary data (which the .cda files in -the toplevel folder represent) to RIFF WAV format, a -non-compressed format that most media players understand. - -&noatun; should quite happily play the .wav file, but if it has trouble, you may -consider using the option, explained -below. - - -Options - - - - -Set the path to the audio CD device, ⪚ -audiocd:/=/dev/sdc. -Normally, the slave will try to find a CD drive with -an audio CD inserted, but if it fails or you have -more than one CD drive, you may want to try this -option. Note that the configuration dialog allows you to set a default -value for this option. - - - - - - -Set the file name template, ⪚ -audiocd:/=Track %{number}. 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. - - - - - - -Set the album name template, ⪚ -audiocd:/=%{albumartist} %{albumtitle}. Note that the configuration dialog allows you to set a default value for this option. - - - - - - -Sets the process nice level for encoders, ⪚ -audiocd:/=niceLevel=10. Note that the configuration dialog allows you to set a default value for this option. - - - - - - -Set the amount of error detection and correction used when -extracting data. - - - -Level 0 - -No detection or correction. Only useful if you have a perfect -CD drive (unlikely). - - - - -Level 1 - -Enable basic error checking and correction. - - - - -Level 2 - -Default. Specifies that only a perfect extraction will be -accepted. - - - - -Note that there is a disadvantage to level 2. Extraction can be -very slow, so real-time digital playback may not work properly. If you -have a good quality CD drive (note that more -expensive does not necessarily mean better quality) then you probably -won't experience very slow extraction, but a poor drive may take days -(!) to extract the audio from one CD. - - - - - - - -Specify which Internet CD Database entry to use. Audio -CDs don't have track names, but the Internet -CD Database is a clever system which uses a special -unique identifier generated from the number and length of tracks on each -CD to cross-reference a track listing. Track listings -are contributed by the Internet community and made available to -all. Occasionally there will be multiple entries. You can specify which one to use. - -You can submit your own track listings using &kscd;, the &kde; -CD player. - -By default audiocd tries to pick the best one. - - - - - -Examples - -audiocd:/?device=/dev/scd0&paranoia_level=0&cddbChoice=0 - -Gives a listing of the tracks on the audio CD -inserted in /dev/scd0, which on -&Linux; specifies the first SCSI &CD-ROM; device. If -you copy tracks from the CD, digital extraction will -be performed without error correction or detection. The -CDDB Database entry 0 will be used. - - - - - -Frequently Asked Question - - -I get The file or folder / does not -exist. How do I fix that? I have an audio -CD in my drive! - - - -Try running cdparanoia - as yourself (not root). Do you see a track list? If not, -make sure you have permission to access the CD -device. If you're using SCSI emulation (possible if -you have an IDE CD writer) then -make sure you check that you have read and write permissions on the -generic SCSI device, which is probably /dev/sg0, /dev/sg1, &etc;. If it still doesn't work, -try typing audiocd:/?device=/dev/sg0 (or similar) -to tell tdeio_audiocd which device your &CD-ROM; is. - - - - - -
-- cgit v1.2.1