Doc rework
[clinton/abcde.git] / FAQ
c9c2ca27 1
79e3928b 21. INSTALLATION
3 ============
5Q. How can I install abcde on my system?
6A. 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
13 abcde needs cd-discid. Grab it from:
18 =========
21 =======
24 ==== ========
72d7162b 26Q. What happened with normalize?
27A. 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.
c9c2ca27 33Q. I am using MacOSX and I am having problems to use abcde.
34A. 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.
42Q. I would like to give the trackname and the artist_name directly to the
43 encoder (in my case oggenc), but found no documentation.
44A. 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".
47Q. What formats can I encode my music to?
40c61684 48A. As for version 2.2, abcde includes support for MP3, Ogg/Vorbis,
79e3928b 49 Ogg/Speex, Flac and MPP/MP+(Musepack). Support for AAC will be added once
50 an FLOSS encoder/decoder is working.
c9c2ca27 51
52Q. I have a CD with a data track, and abcde complaints it cannot read/encode
53 it.
54A. 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.
40c61684 59 Version 2.2 includes some checkings with cdparanoia, to try to get this
60 right.
c9c2ca27 61
62Q. How can I separate the different output files I get using multiple-output
63 support?
64A. 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.
68Q. I keep on getting files with ".ogg.ogg" extension. What am I doing wrong?
69A. 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
74Q. I use Debian/RedHat/(put your Unix flavour here) and MP3 encoding is not
75 working. What am I doing wrong?
76A. 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.
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.
93 If you are among those individuals, you might need to add support for MP3
94 encoding to your system:
95 Debian : check to install lame in your system.
96 others prefer bladeenc. Check or google.
97 RedHat : search on
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.
103 Others : Please, help me here.
105Q. I have modified some of the options, and now CDDB has stopped working.
106A. 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.
79e3928b 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:
116 LAMEOPTS=-h -k
118 Try this instead:
120 LAMEOPTS='-h -k'
c9c2ca27 121
122Q. My hardware player (put it here) does not recognize the playlists created
123 with abcde. What I am doing wrong?
124A. Try using "-m" when creating the playlists, or setting DOSPLAYLIST as an
125 option in the config file.
127Q. I am requested to have eject when setting the speed although I do not use
128 for anything.
129A. If you do not use cdparanoia, eject is used for setting the speed of the
40c61684 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).
c9c2ca27 133 Another way to get the same results is using the pre_read function, defined
134 in your /etc/abcde.conf file.
99d009fa 136Q. Huh! Why is MPPENCODER (with MPP) and .mpc the extension?
137A. 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.
9f659ada 140Q. 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...
143A. 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.
40c61684 148Q. (Thanks to Amaya) Where are those options and settings defined? Why dont
149 you include a proper abcde.conf as an example?
150A. 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
79e3928b 152 override those defaults. More information can be obtained from the man page
153 which can be consulted using "man abcde".
40c61684 154
79e3928b 155Q. I am running out of disc space.
156A. You have to options. Use -l or define WAVOUTPUTDIR=/some/other/path to your
157 /etc/abcde.conf or ~/.abcde.conf.
c9c2ca27 159OBSOLETE
161Q. I set KEEPWAVS to "y" but abcde insists on erasing my directory, along
162 with the wav tracks. What I am doing wrong?
163A. 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.
79e3928b 167
169Jesus Climent <>