0624322420337f3fa45f2b8e33d2beeb20672a8c
[abcde.git] / FAQ
1
2 1. INSTALLATION
3    ============
4    
5 Q. How can I install abcde on my system?
6 A. To get abcde you can use a pre-packaged version, available for Debian, 
7    FreeBSD, OpenBSD, NetBSD and others.
8    In case you want to install your own release, you need to download the
9    sources and install the complementary programs (abcde is just a frontend
10    and its functionality is provided by other programs).
11    Read 
12
13    abcde needs cd-discid. Grab it from:
14    http://www.hispalinux.es/~data/files/cd-discid/
15    
16
17 2. EXECUTION
18    =========
19
20 3. FORMATS
21    =======
22
23 4. MISC PROBLEMS
24    ==== ========
25
26 Q. What happened with normalize?
27 A. Normalize has changed its name under Debian, which is the GNU/Linux 
28    distribution for developing abcde (well, is The GNU/Linux Distribution
29    i only use, at the moment). Now it is called normalize-audio.
30    If you are using some other flavour of OS, you need to change the name
31    of the executable in your abcde.conf file.
32
33 Q. I am using MacOSX and I am having problems to use abcde.
34 A. Well, I have a Mac, but I use linux on it. I have not been able to find
35    a way to make it work there, since I do not have the development tools
36    installed. I have placed a basic support, but some user reports are just
37    complaining about abcde not encoding the ripped tracks, as if 
38    cdda2wav/cdparanoia/cddafs would never end reading them. If you have such
39    a system and experience problems, please, report them, and I will try to
40    work them out with your help.
41
42 Q. I would like to give the trackname and the artist_name directly to the
43    encoder (in my case oggenc), but found no documentation.
44 A. That is not possible, since abcde gets the information from CDDB database.
45    You can create a template and fill it with the option "-n".
46
47 Q. What formats can I encode my music to?
48 A. As for version 2.2, abcde includes support for MP3, Ogg/Vorbis, 
49    Ogg/Speex, Flac and MPP/MP+(Musepack). Support for AAC will be added once
50    an FLOSS encoder/decoder is working.
51
52 Q. I have a CD with a data track, and abcde complaints it cannot read/encode
53    it.
54 A. It is not easy to find a data track on a CD. Right now, I can only think
55    of getting the track info from CDDB and ask the user for continuing should
56    a "data" track name is found. But the solution is far from been optimal.
57    For now, if you find a "data" track and you know the number, restart abcde
58    specifying the tracks to be encoded, leaving out the data one.
59    Version 2.2 includes some checkings with cdparanoia, to try to get this
60    right.
61
62 Q. How can I separate the different output files I get using multiple-output
63    support?
64 A. Use the OUTPUT variable in PLAYLISTFORMAT and OUTPUTFORMAT. It holds the 
65    different output file types you passed to abcde (i.e., ogg, mp3, flac) 
66    during playlist creation and file/directory creation.
67    
68 Q. I keep on getting files with ".ogg.ogg" extension. What am I doing wrong?
69 A. The code for multiple-output adds automatically the extension of the
70    different outputs you select with the "-o" extension (or with OUTPUTTYPE
71    variable). Erase the ".${OUTPUTTYPE}" part from the OUTPUTFORMAT variable
72    in /etc/abcde.conf or ~/.abcde.conf
73
74 Q. I use Debian/RedHat/(put your Unix flavour here) and MP3 encoding is not 
75    working. What am I doing wrong?
76 A. Since MP3 is considered non-free (you get it for free, but hardware players
77    and net broadcasters have to pay license fees), some release engineering 
78    groups and release management teams have decided not to provide MP3 encoding
79    tools.
80    These distributions or operative systems have decided to use Ogg/Vorbis as
81    the default encoding format, since it contains no (known) patent claims
82    and they are (supposed to be) completely Free (released under a BSD-like
83    license).
84    However, there is no strong (at the moment) hardware support, although 
85    some groups and companies are strongly working on getting it, real soon 
86    now. For that reason some people prefer to encode to MP3.
87
88    UPDATE *** UPDATE
89    There are at least 3 known brands already selling Ogg/Vorbis portable
90    players: Rio, iRiver and Neuros.
91    Go buy one and you have no more reasons to use MP3.
92    
93    If you are among those individuals, you might need to add support for MP3
94    encoding to your system:
95    Debian : check http://marillat.free.fr to install lame in your system.
96             others prefer bladeenc. Check www.apt-get.org or google.
97    RedHat : search on rpmfind.net
98    FreeBSD: By default includes LAME support.
99    OpenBSD: Available by specifying you want to install the port with LAME
100             support, or by just installing it later from the ports tree.
101    NetBSD : Available in pkgsrc.
102
103    Others : Please, help me here.
104
105 Q. I have modified some of the options, and now CDDB has stopped working.
106 A. Check that you have modified everything in the right way. For instance, if
107    you modify the HTTPGET program you might want to set some options of your
108    own. If you use the predefined ones (wget, curl and fetch) abcde will try
109    to use some defaults. Keep in mind that the output should go to the output
110    as standard output, to be saved in a file for later use.
111    
112    If abcde seems to be ignoring your configuration options or not running commands
113    such as the encoder, you may have misquoted something. Config options such as
114    the following do not work:
115
116    LAMEOPTS=-h -k
117
118    Try this instead:
119
120    LAMEOPTS='-h -k'
121
122 Q. My hardware player (put it here) does not recognize the playlists created
123    with abcde. What I am doing wrong?
124 A. Try using "-m" when creating the playlists, or setting DOSPLAYLIST as an
125    option in the config file.
126
127 Q. I am requested to have eject when setting the speed although I do not use
128    for anything.
129 A. If you do not use cdparanoia, eject is used for setting the speed of the 
130    cdrom drive. You can substitute it for "setcd" with "-x" as the argument,
131    but you have to install it manually (setcd is, at least, available in 
132    Debian).
133    Another way to get the same results is using the pre_read function, defined
134    in your /etc/abcde.conf file.
135
136 Q. Huh! Why is MPPENCODER (with MPP) and .mpc the extension?
137 A. Dunno. You must ask the guys who created and defined the format. The 
138    standard is MPEGplus (MPP/MP+) but the files use .mpc extension.
139
140 Q. I want the new *put the newest and coolest codec there* format to be 
141    supported by abcde. Abcde is so cool but i want to encode also to this
142    new format...
143 A. Patches are welcome! ;)
144    No, seriously, if the format is usable, available for Linux and open
145    source/free software, it should be fairly easy to integrate. Support for
146    AAC (m4p) should be the next one to be introduced.
147
148 Q. (Thanks to Amaya) Where are those options and settings defined? Why dont
149    you include a proper abcde.conf as an example?
150 A. I do. It should be installed under /etc/abcde.conf and contains more or
151    less all the defaults abcde uses. You can use $(HOME)/.abcde.conf to 
152    override those defaults. More information can be obtained from the man page
153    which can be consulted using "man abcde".
154
155 Q. I am running out of disc space.
156 A. You have to options. Use -l or define WAVOUTPUTDIR=/some/other/path to your
157    /etc/abcde.conf or ~/.abcde.conf.
158    
159 OBSOLETE
160 --------
161 Q. I set KEEPWAVS to "y" but abcde insists on erasing my directory, along
162    with the wav tracks. What I am doing wrong?
163 A. The default action set includes clean, which cleans the temp directory, 
164    if nothing goes wrong. Take the "clean" out from the action list and you
165    are done.
166    UPDATE: KEEPWAVS unselects now the clean action.
167
168 --
169 Jesus Climent <jesus.climent@hispalinux.es>