source: multimedia/audioutils/audacious.xml@ 6e5d584

10.0 10.1 11.0 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6e5d584 was 6e5d584, checked in by Fernando de Oliveira <fernando@…>, 8 years ago

Move optional switches to 'Command Explanations' in Sudo-1.8.9p3 and Audacious-3.4.3. Thanks, Randy M.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@12579 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY audacious-download-http
8 "http://distfiles.audacious-media-player.org/audacious-&audacious-version;.tar.bz2">
9 <!ENTITY audacious-download-ftp " ">
10 <!ENTITY audacious-md5sum "3935e3c1e6bdc2907ce2672a85476f20">
11 <!ENTITY audacious-size "476 KB">
12 <!ENTITY audacious-buildsize "13 MB">
13 <!ENTITY audacious-time "0.2 SBU">
14
15 <!ENTITY audacious-plugins-download
16 "http://distfiles.audacious-media-player.org/audacious-plugins-&audacious-plugins-version;.tar.bz2">
17 <!ENTITY audacious-plugins-md5sum "a52e1ec2f37e9269e26ee67b41153d73">
18 <!ENTITY audacious-plugins-size "1.8 MB">
19 <!ENTITY audacious-plugins-buildsize "45 MB">
20 <!ENTITY audacious-plugins-time "0.6 SBU">
21]>
22
23<sect1 id="audacious" xreflabel="Audacious-&audacious-version;">
24 <?dbhtml filename="audacious.html"?>
25
26 <sect1info>
27 <othername>$LastChangedBy$</othername>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>Audacious-&audacious-version;</title>
32
33 <indexterm zone="audacious">
34 <primary sortas="a-Audacious">Audacious</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to Audacious</title>
39
40 <para>
41 <application>Audacious</application> is a <application>GTK+</application>
42 based audio player.
43 </para>
44
45 &lfs74_checked;
46
47 <bridgehead renderas="sect3">Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>
51 Download (HTTP): <ulink url="&audacious-download-http;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download (FTP): <ulink url="&audacious-download-ftp;"/>
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download MD5 sum: &audacious-md5sum;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download size: &audacious-size;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated disk space required: &audacious-buildsize;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Estimated build time: &audacious-time;
77 </para>
78 </listitem>
79 </itemizedlist>
80
81 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
82 <itemizedlist spacing="compact">
83 <title>Required Plugins</title>
84 <listitem>
85 <para>
86 Download (HTTP): <ulink url="&audacious-plugins-download;"/>
87 </para>
88 </listitem>
89 <listitem>
90 <para>
91 Download MD5 sum: &audacious-plugins-md5sum;
92 </para>
93 </listitem>
94 <listitem>
95 <para>
96 Download size: &audacious-plugins-size;
97 </para>
98 </listitem>
99 <listitem>
100 <para>
101 Estimated disk space required: &audacious-plugins-buildsize;
102 </para>
103 </listitem>
104 <listitem>
105 <para>
106 Estimated build time: &audacious-plugins-time;
107 </para>
108 </listitem>
109 </itemizedlist>
110
111 <bridgehead renderas="sect3">Audacious Dependencies</bridgehead>
112
113 <bridgehead renderas="sect4">Required</bridgehead>
114 <para role="required">
115 <xref linkend="gtk3"/>,
116 <xref linkend="libxml2"/> (plugins),
117 <xref linkend="xorg-env"/> (plugins), and
118 <xref linkend="x-window-system"/> (runtime)
119 </para>
120
121 <bridgehead renderas="sect4">Recommended</bridgehead>
122 <para role="optional">
123 <xref linkend="dbus"/> and
124 <xref linkend="alsa"/>
125 </para>
126
127 <bridgehead renderas="sect4">Optional</bridgehead>
128 <para role="optional">
129 <xref linkend="thunar"/>,
130 <xref linkend="pcre"/> or
131 <ulink url="http://www.geocities.jp/kosako3/oniguruma/">Oniguruma</ulink> and
132 <ulink url="http://www.atheme.org/project/libguess">libguess</ulink>
133 </para>
134
135 <bridgehead renderas="sect4">Optional (for Plugins)</bridgehead>
136 <para role="optional">
137 <xref linkend="curl"/>,
138 <xref linkend="neon"/> (for online mpg3 and ogg radio),
139 <xref linkend="lame"/>,
140 <xref linkend="flac"/>,
141 <xref linkend="libvorbis"/>,
142 <xref linkend="faad2"/>,
143 <xref linkend="ffmpeg"/>,
144 <xref linkend="sdl"/>,
145 <xref linkend="mpg123"/>,
146 <xref linkend="libnotify"/>,
147 <xref linkend='pulseaudio'/>,
148 <xref linkend="libsndfile"/>,
149 <xref linkend='libsamplerate'/>,
150 <ulink url="http://www.lirc.org/">LIRC</ulink>,
151 <ulink url="http://ftp.gnu.org/gnu/libcdio/">libcdio</ulink>
152 (both libcdio and libcdio-paranoia are needed to play CDs),
153 <ulink url="http://libcddb.sourceforge.net/">libcddb</ulink>
154 (to identify CDs),
155 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
156 <ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
157 <ulink url="http://jackit.sourceforge.net/">JACK</ulink>
158 (requires <xref linkend="libsamplerate"/>),
159 <ulink url="http://sourceforge.net/apps/trac/fluidsynth/">FluidSynth</ulink>,
160 <ulink url="http://sourceforge.net/projects/libcue/">libcue</ulink>,
161 <ulink url="http://sourceforge.net/projects/bs2b/">The Bauer
162 stereophonic-to-binaural DSP (bs2b) library</ulink>,
163 <ulink url="http://sourceforge.net/projects/libbinio/">libbinio</ulink>
164 (to build the AdPlug plugin), and
165 <ulink url="http://www.wavpack.com/">WavPack</ulink>
166 </para>
167
168 <para condition="html" role="usernotes">
169 User Notes: <ulink url="&blfs-wiki;/audacious"/>
170 </para>
171 </sect2>
172
173 <sect2 role="installation">
174 <title>Installation of Audacious</title>
175
176 <para>
177 Install <application>Audacious</application> by running the following
178 commands (you may wish to change the stamp to another string):
179 </para>
180
181<screen><userinput>TPUT=/bin/true ./configure --prefix=/usr &amp;&amp;
182make</userinput></screen>
183
184 <para>
185 If you have <xref linkend="doxygen"/> installed and wish to build the
186 API documentation, issue <command>doxygen</command>.
187 </para>
188
189 <para>
190 This package does not come with a test suite.
191 </para>
192
193 <para>
194 Now, as the <systemitem class="username">root</systemitem> user:
195 </para>
196
197<screen role="root"><userinput>make install</userinput></screen>
198
199 <para>
200 If you built the API documentation, install it as the
201 <systemitem class="username">root</systemitem> user by issuing:
202 </para>
203
204<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/audacious-&audacious-version;/api &amp;&amp;
205install -v -m644 doc/html/* \
206 /usr/share/doc/audacious-&audacious-version;/api</userinput></screen>
207 </sect2>
208
209 <sect2 role="installation">
210 <title>Installation of Audacious Plugins</title>
211<!--
212 <note>
213 <para>
214 If <application>Xorg</application> is not installed in
215 <filename class="directory">/usr</filename>, tell the linker
216 where to find it:
217 </para>
218
219<screen><userinput>export LIBRARY_PATH=$XORG_PREFIX/lib</userinput></screen>
220
221 </note>-->
222
223 <para>
224 Install the required plugins package by unpacking the tarball, changing
225 into the newly created directory, and issuing the following
226 commands:
227 </para>
228
229<screen><userinput>TPUT=/bin/true ./configure --prefix=/usr &amp;&amp;
230make</userinput></screen>
231
232 <para>
233 This package does not come with a test suite.
234 </para>
235
236 <para>
237 Now, as the <systemitem class="username">root</systemitem> user:
238 </para>
239
240<screen role="root"><userinput>make install</userinput></screen>
241
242 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
243 href="../../xincludes/update-icons-and-desktop.xml"/>
244 </sect2>
245
246 <sect2 role="commands">
247 <title>Command Explanations</title>
248
249 <para>
250 <parameter>TPUT=/bin/true</parameter>: the default is for
251 <command>make</command> to output text in color. This is fine if you're
252 building in a terminal, but if you script the build process and pipe the
253 output from <command>make</command> to a log file then the control
254 characters used to color the text can make the logfile unreadable. This
255 option stops it coloring the text.
256 </para>
257
258 <para>
259 <option>--with-buildstamp="BLFS"</option>: Set build stamp to BLFS
260 (change it to fit your preference).
261 </para>
262
263 </sect2>
264
265 <sect2 role="configuration">
266 <title>Configuring Audacious</title>
267
268 <para>
269 If you prefer the old, smaller Winamp/XMMS interface, click on View&gt;
270 Interface&gt; Winamp Classic Interface.
271 </para>
272
273 </sect2>
274
275 <sect2 role="content">
276 <title>Contents</title>
277
278 <segmentedlist>
279 <segtitle>Installed Programs</segtitle>
280 <segtitle>Installed Libraries</segtitle>
281 <segtitle>Installed Directories</segtitle>
282
283 <seglistitem>
284 <seg>
285 audacious and audtool
286 </seg>
287 <seg>
288 libaudclient.so, libaudcore.so, libaudgui.so,
289 libaudtag.so, and several plugin libraries under
290 /usr/lib/audacious/ sub-directories
291 </seg>
292 <seg>
293 /usr/include/audacious,
294 /usr/include/libaudcore,
295 /usr/include/libaudgui,
296 /usr/lib/audacious,
297 /usr/share/audacious and
298 /usr/share/doc/audacious-&audacious-version;
299 </seg>
300 </seglistitem>
301 </segmentedlist>
302
303 <variablelist>
304 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
305 <?dbfo list-presentation="list"?>
306 <?dbhtml list-presentation="table"?>
307
308 <varlistentry id="audacious-prog">
309 <term><command>audacious</command></term>
310 <listitem>
311 <para>
312 is a GTK+2 port of <application>XMMS</application> based on the
313 <application>Beep Media Player</application>.
314 </para>
315 <indexterm zone="audacious audacious-prog">
316 <primary sortas="b-audacious">audacious</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="audtool">
322 <term><command>audtool</command></term>
323 <listitem>
324 <para>
325 is a small tool to modify the behavior of a running
326 <command>audacious</command> instance.
327 </para>
328 <indexterm zone="audacious audtool">
329 <primary sortas="b-audtool">audtool</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="libaudclient">
335 <term><filename class="libraryfile">libaudclient.so</filename></term>
336 <listitem>
337 <para>
338 contains functions that are used by <command>audacious</command> to
339 render its graphical interface.
340 </para>
341 <indexterm zone="audacious libaudclient">
342 <primary sortas="c-libaudclient">libaudclient.so</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 </variablelist>
348
349 </sect2>
350
351</sect1>
Note: See TracBrowser for help on using the repository browser.