Documentation tweaks
[abcde.git] / FAQ
1 0. INTRODUCTION
2    ============
3
4 Q. Who created abcde? Who develops it nowadays?
5 A. It was originally created by Robert Woodcook. He decided to give up
6    maintaining it at some point in 2002 and Jesus Climent took
7    over. In 2012, Colin Tuckley and Steve McIntyre joined in to
8    help. During 2015-2016 Andrew Strong helped out. Currently Steve
9    maintains abcde. You can contact Steve directly with comments or
10    suggestions at the following email address: Steve McIntyre
11    <93sam@@debian.org>. Or (and maybe better!) try the abcde-users
12    mailing list: abcde-users@lists.einval.com
13
14
15 1. INSTALLATION
16    ============
17
18 Q. How can I install abcde on my system?
19 A. To get abcde you can use a pre-packaged version, available for
20    Debian, Ubuntu, FreeBSD, OpenBSD, NetBSD and others.
21    In case you want to install your own release, you need to download
22    the source and install the complementary programs (abcde is just a
23    frontend and its functionality is provided by other programs).
24
25    abcde needs cd-discid. Grab it from:
26    http://www.hispalinux.es/~data/files/cd-discid/
27
28    Read the README files for a complete list of requirements.
29
30 Q. I have a problem, and I reported some time ago. Have you solved it already?
31 A. Maybe. Try downloading the master branch of the development from
32    https://git.einval.com/cgi-bin/gitweb.cgi?p=abcde.git
33
34 Q. When are you going to release a new version?
35 A. When it is ready. :-) We keep on adding new ideas to the trunk
36    (stored in the URL above) and release periodically when we think
37    it's due.
38
39
40 2. EXECUTION
41    =========
42
43 Q. I want to force abcde 2.x to behave more like 1.x. How do I do it?
44 A. Put these options in your abcde.conf:
45
46    INTERACTIVE=n
47    OUTPUTTYPE=mp3
48    ID3TAGV=1
49
50 Q. Low on disk space?
51 A. abcde has different algorithms to schedule ripping and encoding - to
52    optimize for disk conservation, use -l. You can also define
53    WAVOUTPUTDIR=/some/other/path to your /etc/abcde.conf or ~/.abcde.conf to
54    store the WAV files on another NFS shared fisk, for example.
55    Also, UNIX pipes have also been implemented, using "-P", so abcde reads and
56    encodes the tracks from the CD at once. However, it has the drawback that
57    only one format can be encoded at a time.
58
59 Q. How can i make abcde encode faster? My CD reader is way faster than the pace
60    it can encode my tracks.
61 A. abcde can take advantage of SMP systems, just like make. Try 'abcde -j 2' -
62    it'll run two encoder jobs while it rips the next track.
63    You can also make use of systems which are networked, with the help of
64    distmp3. For example, MachineA has a better CPU power and MachineB has a CD
65    drive. Run distmp3host (included in distmp3) on Machine A, and then run
66    abcde -r MachineA from MachineB (where "MachineA" is a dns name or IP
67    address). Use this in combination with '-j 0' to shift all encoding off the
68    local machine.
69
70 Q. I am having problems with *my CD reading program* reading the drive as a
71    user.
72 A. You might have to add yourself (or the users who want to use abcde) to the
73    cdrom group and change the permissions of the cdrom device to 660. If you
74    have a SCSI cdrom drive, check the permissions of /dev/sg* as well.
75
76 Q. I would like to give the trackname and the artist_name directly to the
77    encoder (in my case oggenc), but found no documentation.
78 A. That is not possible, since abcde gets the information from CDDB database.
79    You can create a template and fill it with the option "-n". Also, you can
80    get the CDDB entry and edit it yourself. abcde has also an option to drop
81    back to a template if you like none of the CDDB entries, selecting 0 from
82    the CDDB options.
83
84 Q. (Thanks to Amaya) Where are those options and settings defined? Why dont
85    you include a proper abcde.conf as an example?
86 A. We do. It should be installed under /etc/abcde.conf and contains more or
87    less all the defaults abcde uses. You can use $(HOME)/.abcde.conf to
88    override those defaults. More information can be obtained from the man page
89    which can be consulted using "man abcde".
90
91 Q. I keep on getting files with ".ogg.ogg" extension. What am I doing wrong?
92 A. The code for multiple-output adds automatically the extension of the
93    different outputs you select with the "-o" extension (or with OUTPUTTYPE
94    variable). Erase the ".${OUTPUTTYPE}" part from the OUTPUTFORMAT variable
95    in /etc/abcde.conf or ~/.abcde.conf
96
97 Q. I have modified some of the options, and now CDDB has stopped working.
98 A. Check that you have modified everything in the right way. For instance, if
99    you modify the HTTPGET program you might want to set some options of your
100    own. If you use the predefined ones (wget, curl and fetch) abcde will try
101    to use some defaults. Keep in mind that the output should go to the output
102    as standard output, to be saved in a file for later use.
103
104    If abcde seems to be ignoring your configuration options or not running
105    commands such as the encoder, you may have misquoted something. Config
106    options such as the following do not work:
107
108    LAMEOPTS=-h -k
109
110    Try this instead:
111
112    LAMEOPTS='-h -k'
113
114 Q. How can I separate the different output files I get using multiple-output
115    support?
116 A. Use the OUTPUT variable in PLAYLISTFORMAT and OUTPUTFORMAT. It holds the
117    different output file types you passed to abcde (i.e., ogg, mp3, flac)
118    during playlist creation and file/directory creation.
119
120 Q. I have a CD with a data track, and abcde complaints it cannot read/encode
121    it.
122 A. From version 2.2 onwards, abcde includes some checkings with cdparanoia, to
123    try to get this right.
124    (It is not easy to find a data track on a CD. If you find a "data"
125    track and you know the number, restart abcde specifying the tracks
126    to be encoded, leaving out the data one).
127
128 Q. I am requested to have "eject" when setting the speed although I do not use
129    it for anything.
130 A. If you do not use cdparanoia, eject is used for setting the speed of the
131    cdrom drive. You can substitute it for "setcd" with "-x" as the argument,
132    but you have to install it manually (setcd is, at least, available in
133    Debian).
134    Another way to get the same results is using the pre_read function, defined
135    in your /etc/abcde.conf file.
136
137 Q. I have a CD set with 1+ discs, and want to have them in the same directory,
138    sorted properly. What can abcde do for me?
139 A. Set abcde to rip the first CD and give it the option "-t 101". Use a generic
140    name for the CD, and reuse it with the rest of the CDs, editing the CDDB
141    entries. Use "-t 201" for the second CD and so on. Use "-w <comment>" to
142    add a comment about the CD you are ripping (-w "disc #"). Alternatively you
143    can use only the "-t ###" option and then move all the files to the same
144    directory, but the tag/comment information on the files will differ. If you
145    want the tagged track number to be set to the modified number you should use
146    "-T ###".
147    Even better! If you use "-W <cd_number>", abcde will put a comment to every
148    CD set ("CD <number>") and modify the number of the tracks both in the file
149    name and the tag/comment information.
150
151 Q. I have a live concert. I want to encode it in a single file. How do i do it?
152 A. Use "-1" and it will be encoded in a single file. Use "cue" as an action to
153    make a CUE sheet file where the information about the tracks is stored.
154
155 Q. Can I use abcde to take a backup of my CD collection?
156 A. Yes. Use "abcde -1 -o flac -a default,cue" and it will create a single-track
157    FLAC file with an embedded cuesheet. Later on, you can use the command
158    "abcde -o vorbis -d flac-file.flac" to extract the individual tracks in
159    Ogg/Vorbis format. Of course you can select whatever format you want.
160
161
162 3. CDDB and Musicbrainz
163    ====================
164
165 Q. I need to go through an HTTP proxy for CDDB access.
166 A. No problem, just export your http_proxy variable first so wget/fetch/curl
167    can see it.
168
169 Q. I already store CDDB entries in my hard disc. Can I make use of them?
170 A. Piece of cake. Just edit CDDBLOCALDIR to point to the repository and give
171    abcde the "-L" flag to make use of it.
172
173 Q. Fine, now it uses local CDDB, but I have no network connection. How can I
174    disable CDDB checks?
175 A. Use the "-L -n" combination. It will try to use local CDDB entries, and if
176    nothing can be found, it will use a template. You will be also given the
177    choice to edit such template.
178
179 Q. How can I use some other CDDB information provider?
180 A. abcde now uses FreeDB by default. To use a different FreeDB mirror or
181    another CDDB service, change the CDDBURL option in your abcde.conf.
182
183 Q. After requesting CDDB data, I received several answers which seem to be
184    quite alike. Can I find out the difference between some of them?
185 A. Yes. When asked which one you want to select, use "X,Y" where X and Y are
186    the numbers of the selections you want to find the difference between.
187
188 Q. I get stuck at the screen with multiple CDDB results. How do I exit this
189    screen so I can make my final selection?
190 A. abcde tries to use the system's default pager to display these results
191    and thus the actual application used and the method to exit from this
192    application may vary from system to system.
193    Many systems will be using the applications 'more' or 'less' as their
194    pager and the common key to exit this screen is the letter 'q'. If this
195    does not work on your system you should investigate what your system's
196    default pager application is and from there learn the correct method of
197    exiting this screen.
198
199 Q. I don't like CDDB/FreeDB. How can I use Musicbrainz instead?
200 A. Set CDDBMETHOD=musicbrainz and try it!
201
202 Q. Some of my CDs are on FreeDB, but others are only on
203    Musicbrainz. It's painful having to switch!
204
205 A. Since version 2.9, you can specify multiple lookup methods in
206    CDDBMETHOD, abcde will use all of them, and display all the results
207    for you to choose your favourite. This even includes CD-TEXT. To
208    enable all the options, use
209
210    CDDBMETHOD="musicbrainz,cddb,cdtext" in abcde.conf, or
211
212    "-Q musicbrainz,cddb,cdtext"
213
214    on the command line
215
216 4. abcde and Album Art
217    ===================
218
219 Q. Can abcde download album art?   
220 A. As of abcde 2.7 it is possible to download a suitable cover
221    image from within abcde that can be used by applications such
222    as Audacious and vlc to illustrate playback with an album cover.
223    Many hardware playback devices such as iPODs will also use this
224    image during playback and show it on the device's display.
225
226 Q. How does album art downloading work?
227 A. The details are contained in abcde within a new function called
228    'getalbumart' which can be called either from the commandline or 
229    from within an ~/.abcde.conf file. The technique works in 3 possible
230    ways:
231
232     1. If CDDBMETHOD includes musicbrainz the album art is downloaded from
233        coverartarchive by MBID (MusicBrainz Identifier)
234     2. If 1 fails, download is tried from amazon by ASIN (Amazon 
235        Standard Identification Number)
236     3. If if 1 and 2 fail or CDDBMETHOD is cddb the album art will 
237        be downloaded using glyrc by artist + album title
238
239    You  will need to install your distro's package of glyr, a music 
240    related metadata search engine, and it is strongly advised that
241    you use 'musicbrainz' in your cddb lookups. To access the more 
242    advanced features of getalbumart it is also strongly advised that
243    you install the ImageMagick package of your distro. getalbumart 
244    will work without ImageMagick but functionality will be reduced.
245
246 Q. What settings and options should I select?
247 A. If you want to operate abcde from the commandline only you will
248    get reasonable results with something like either of the following:
249
250      abcde -o mp3:-V2 -a default,getalbumart
251      abcde -o mp3:-V2 -G
252
253    But to experience all of the options of getalbumart you should also
254    consider setting the following in your ~/.abcde.conf file:
255
256     #----------------------------------------------------------------#
257     CDDBMETHOD=musicbrainz       # Use MusicBrainz for CDDB 
258     ACTIONS=default,getalbumart  # Select the album art action + default
259
260     # Give the path to the metadata search application glyrc. Add any
261     # glyrc options:
262     GLYRC=glyrc
263     GLYRCOPTS= 
264
265     # Give the path to ImageMagick's 'identify' which is used to give a 
266     # commandline summary of the album art and also assist in any conversions.
267     # Add any 'identify' options:
268     IDENTIFY=identify
269     IDENTIFYOPTS=
270
271     # Give the path to ImageMagick's 'display' which will show the album art. 
272     # The options below are the abcde default, feel free to add your own:  
273     DISPLAYCMD=display
274     DISPLAYCMDOPTS="-resize 512x512 -title abcde_album_art"
275
276     # Give the path to ImageMagick's 'convert' which is used to convert album 
277     # art to the format specified in ALBUMARTTYPE. Add any 'convert' options:   
278     CONVERT=convert
279     CONVERTOPTS=
280     # If you want to run CONVERTOPTS on all files (including those specified
281     # in ALBUMARTTYPE) set the following to "y":
282     ALBUMARTALWAYSCONVERT="n"
283
284     # By default the filename will be cover.jpg and the file format will
285     # be jpeg. 'convert' will automagically change other formats to jpeg:
286     ALBUMARTFILE="cover.jpg"
287     ALBUMARTTYPE="JPEG"
288     #----------------------------------------------------------------#
289
290    There are more hints concerning commandline options in the sample 
291    abcde.conf file included with your abcde package. Good news is that
292    the existing defaults will work well without any extra adjustments :).
293
294 Q. Can I manually select album art?
295 A. If you have set INTERACTIVE=y (this is the default) then you will have
296    the opportunity to manually select the album art of your choice either
297    from online by typing in a URL or by typing in the path to a local file.
298    
299 Q. What if I want my album art embedded?
300 A. As of abcde 2.8.2 it is possible to have the album art automatically 
301    embedded in the mp3 container using eyeD3, embedded in the flac container
302    using metaflac, embedded in the m4a container using AtomicParsley,
303    embedded in the wv container using wvtag and embedded into an ogg
304    container using vorbiscomment.
305    
306    There are 3 different ways to accomplish this:
307    
308      1. Use the command line '-B' option (this will also call getalbumart)
309      2. Use the command line '-a embedalbumart' option to add to list of actions
310      3. Use 'embedalbumart' in the 'ACTIONS' list in ~/.abcde.conf
311      
312    Adding newer containers for album art embedding should be fairly straightforward
313    and these will be added when the right combination of available abcde developer
314    time and abcde user interest occurs...
315   
316 4. FORMATS
317    =======
318
319 Q. What formats can I encode my music to?
320 A. As of version 2.8.2 abcde includes support for MP3, Ogg/Vorbis,
321    Ogg/Speex, Flac, MPP/MP+(Musepack), AAC, AIFF (Audio Interchange File Format),
322    Alac, WavPack, TTA (True Type Audio), APE (Monkey's Audio), Opus,
323    AC3 and MP2.
324
325 Q. I want the new *put the newest and coolest codec there* format to be
326    supported by abcde. Abcde is so cool but i want to encode also to this
327    new format...
328 A. Patches are welcome! ;)
329    No, seriously, if the format is usable, available for Linux and open
330    source/free software, it should be fairly easy to integrate. Support for
331    AAC (m4p) should be the next one to be introduced.
332
333 Q. I use Debian/RedHat/(put your Unix flavour here) and MP3 encoding is not
334    working. What am I doing wrong?
335 A. Since MP3 is considered non-free (you get it for free, but hardware players
336    and net broadcasters have to pay license fees), some release engineering
337    groups and release management teams have decided not to provide MP3 encoding
338    tools.
339    These distributions or operating systems have decided to use Ogg/Vorbis as
340    the default encoding format, since it contains no (known) patent claims
341    and they are (supposed to be) completely Free (released under a BSD-like
342    license).
343    However, there is no strong (at the moment) hardware support, although
344    some groups and companies are strongly working on getting it, real soon
345    now. For that reason some people prefer to encode to MP3.
346
347    UPDATE *** UPDATE
348    There are known brands already selling Ogg/Vorbis portable players: Rio,
349    iRiver, Neuros, iAudio,...
350    Go buy one and you have no more reasons to use MP3.
351
352    If you are among those individuals, you might need to add support for MP3
353    encoding to your system:
354    Debian : By default includes LAME support.
355    RedHat : search on rpmfind.net
356    FreeBSD: By default includes LAME support.
357    OpenBSD: Available by specifying you want to install the port with LAME
358             support, or by just installing it later from the ports tree.
359    NetBSD : Available in pkgsrc.
360
361    Others : Please, help us here.
362
363 Q. Huh! Why is MPPENCODER (with MPP) and .mpc the extension?
364 A. Dunno. You must ask the guys who created and defined the format. The
365    standard is MPEGplus (MPP/MP+) but the files use .mpc extension.
366    
367 Q. Why do I get .aac files instead of .m4a files when I encode with faac?
368 A. Faac uses mp4v2 to create aac files in an m4a or mp4 container. Some 
369    Linux distros have disabled this mp4v2 support due to a licensing issue 
370    and this leave faac only capable of generating mpeg-2/ADTS streams. 
371    These streams should correctly have the .aac file extension and some 
372    players (such as Audacious) will not even play mpeg-2/ADTS streams when
373    they are placed in an .m4a container.
374    As of version 2.7 abcde tests the version of faac being used for mp4v2 
375    support and then appropriately  places the audio either in .m4a or .aac. 
376    Note that tagging is not possible with mpeg-2/ADTS streams in .aac.
377    
378 Q. How do I encode to Apple Lossless Audio Codec (alac)?
379 A. As of abcde 2.7.1 there are 3 ways to encode to alac: using qaac, refalac
380    or FFmpeg. To use qaac or refalac follow the installation directions here:
381
382    http://www.andrews-corner.org/qaac.html#installation
383
384    and then set your ~/.abcde.conf file as follows:
385
386    AACENCODERSYNTAX=qaac
387    QAAC="$HOME/.wine/drive_c/qaac/qaac.exe"
388    # Or use the Open Source alac encoder with this small hack:
389    # QAAC="$HOME/.wine/drive_c/qaac/refalac.exe"
390    QAACENCOPTS="--alac --threading --verbose"
391    OUTPUTTYPE="m4a"
392
393    To use FFmpeg (or avconv) set your ~/.abcde.conf file as follows:
394
395    AACENCODERSYNTAX=ffmpeg
396    FFMPEG=ffmpeg
397    # Or give the path to avconv instead:
398    # FFMPEG=avconv
399    FFMPEGENCOPTS="-c:a alac"
400    OUTPUTTYPE="m4a"
401
402    And then sit back and enjoy the music :)
403
404 Q. Will FFmpeg be used with abcde for any other audio formats?
405 A. The plan is to use FFmpeg (or avconv) when FFmpeg has a good quality native
406    encoder available. For example FFmpeg has a low quality native native encoder
407    for Vorbis and AAC which will not be used but a great reverse engineered alac
408    encoder that has been used in abcde. FFmpeg also has a good WavPack encoder
409    that has been added in abcde 2.7.1 which can be added into your ~/.abcde.conf
410    file as follows:
411
412    # WVENCODERSYNTAX=wavpack
413    WVENCODERSYNTAX=ffmpeg
414    # Appropriate PATH:
415    WAVPACK=wavpack
416    FFMPEG=ffmpeg
417    # Appropriate options:
418    FFMPEGENCOPTS="-c:a wavpack -compression_level 6"
419    WAVPACKENCOPTS="-hx3"
420    # Correct output type:
421    OUTPUTTYPE="wv"
422
423    You can see in this example how easy it is to switch from one WavPack encoder to
424    another by changing the comment mark '#' on the WVENCODERSYNTAX line. For mp2
425    encoding with FFmpeg try the following:
426    
427    # MP2ENCODERSYNTAX=twolame
428    MP2ENCODERSYNTAX=ffmpeg
429    # Appropriate PATH:
430    TWOLAME=twolame
431    FFMPEG=ffmpeg
432    FFMPEGENCOPTS='-c:a mp2 -b:a 320k'
433    TWOLAMENCOPTS='--bitrate 320'
434    # Correct output type:
435    OUTPUTTYPE="mp2"
436    
437    Currently FFmpeg supports: alac, wavpack,mp2 and AIFF. FFmpeg native aac support will
438    be added when it comes out of 'experimental'. FFmpeg is also used as the default
439    encoder for the Matroska or mka container. A typical example, using the FFmpeg
440    native ac3 encoder, is:
441
442    MKAENCODERSYNTAX=ffmpeg
443    FFMPEG=ffmpeg
444    FFMPEGENCOPTS="-c:a ac3 -b:a 448k"
445    OUTPUTTYPE="mka"
446
447    Other suitable codecs for this usage are Vorbis, MP2, MP3, LC-AAC, HE-AAC, WMAv1,
448    WMAv2, eAC3 and Opus. There is much more to come in the future for abcde and FFmpeg!
449
450
451 5. USEPIPES
452    ========
453
454 Q. What is/are 'USEPIPES'??
455 A. This is a slightly different method of ripping and encoding with abcde
456    utilising Unix pipes. Using this method a program sends as output what
457    another programs expects as input without writing the information to the
458    hard disk. For it to work with abcde, a ripper must send the data of the
459    CD tracks which are ripped to the 'standard output', while sending other
460    information and error messages to 'standard error' so that the encoder
461    does not get confused. The encoder program needs to be able to encode the
462    information send to it by reading from the standard input (which is what
463    the ripper sends to the standard output).
464    Usually Unix/Linux programs deal with the standard input/output by using
465    the special file name '-', as in the following example:
466
467    cdripper -o - | audioencoder -i - -o file.ext
468
469    The 'cdripper' program uses the flag '-o' to identify the file it will
470    output the data to. For the 'audioencoder' program to be able to read
471    the output through a Unix pipe (the '|' symbol), the output needs to be
472    sent to the standard output using the '-' special filename. Once the
473    output has been piped to 'audioencoder' we use the same special filename
474    to read the information as input with the '-i' flag and output it to
475    'file.ext' with the '-o' flag.
476
477 Q. How do I use USEPIPES with abcde?
478 A. You can run USEPIPES in either of two ways:
479
480      1. Add 'USEPIPES=y' to your ~/.abcde.conf file
481      2. Use the commandline option 'abcde -P'
482
483 Q. Do all rippers and encoders work with USEPIPES?
484 A. No :). Keep in mind that every ripper and encoder differs from in each
485    other in the way they interact with pipes and not all rippers and encoders
486    will use or understand the '-o' and '-' options. Currently (August 2015) the
487    following rippers and encoders work:
488
489    Rippers:  cdparanoia, debug, libcdio, cdda2wav, flac, pird.
490    Encoders: mp3enc, lame, bladeenc, oggenc, opusenc, flac, speexenc,
491              mpcenc, wavpack, faac, neroAacEnc, fdkaac, qaac, fhgaacenc,
492              ffmpeg, tta, ttaenc.
493
494 Q. Can I add a ripper or encoder which is not supported?
495 A. Sure! If you plan to use a ripper or encoder which is not supported you
496    need to know how to use the ripper/encoder. For example, cdparanoia just
497    uses '-' as the output filename and works. The program used to decode
498    FLAC files (yes, abcde supports 'ripping' from a FLAC file :) uses '-c'.
499    To add support for a ripper called 'cdripper' which uses the '-' special
500    flag for outputting to the standard output, you need to open the config
501    file (either /etc/abcde.conf or ~/.abcde.conf) and add the line:
502
503      PIPERIPPER_cdripper="-"
504    
505    For an encoder called 'audioencoder' which uses '--stdin' to read the pipe
506   input, you need to add:
507
508      PIPE_audioencoder="--stdin"
509
510   Of course, you should try your configuration and report it to the abcde
511   developers so that it can be included in future versions of abcde. If
512   you are familiar with POSIX shell programing, please open "abcde" and
513   take a look at the lines below the one marked with "###USEPIPESSUPPORT###",
514   the required syntax is reasonably clear.
515
516 6. MISC
517    ====
518
519 Q. What happened with normalize?
520 A. Normalize has changed its name under Debian, which is the GNU/Linux
521    distribution for developing abcde (well, is the GNU/Linux Distribution
522    Steve uses, at the moment). Now it is called normalize-audio.
523    If you are using some other flavour of OS, you need to change the name
524    of the executable in your abcde.conf file.
525
526 Q. I am using MacOSX and I am having problems to use abcde.
527 A. Well, I have a Mac, but I use linux on it. I have not been able to find
528    a way to make it work there, since I do not have the development tools
529    installed. I have placed a basic support, but some user reports are just
530    complaining about abcde not encoding the ripped tracks, as if
531    icedax/cdda2wav/cdparanoia/cddafs would never end reading them. If you have
532    such a system and experience problems, please, report them, and I will
533    try to work them out with your help.
534
535 Q. My hardware player (put it here) does not recognize the playlists created
536    with abcde. What I am doing wrong?
537 A. Try using "-m" when creating the playlists, or setting DOSPLAYLIST as an
538    option in the config file.
539
540 Q. What is the odd-looking progress indicator when ripping?
541 A. cdparanoia is the default ripping program used by abcde on many
542    platforms, and it tries to give information about the ripping
543    quality as it runs. See the cdparanoia(1) man page for more
544    details, or look online at
545    https://www.xiph.org/paranoia/faq.html#progbar
546
547 OBSOLETE
548 --------
549 Q. I set KEEPWAVS to "y" but abcde insists on erasing my directory, along
550    with the wav tracks. What I am doing wrong?
551 A. The default action set includes clean, which cleans the temp directory,
552    if nothing goes wrong. Take the "clean" out from the action list and you
553    are done.
554    UPDATE: KEEPWAVS unselects now the clean action.
555
556 --
557 Steve McIntyre <93sam@@debian.org>