source: multimedia/audioutils/audacious.xml@ ac38e9dc

systemd-13485
Last change on this file since ac38e9dc was ac38e9dc, checked in by Douglas R. Reno <renodr@…>, 9 years ago

Import back into SVN from Github

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16309 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 10.5 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 "79132b694714c90dbcd8593919abed1c">
11 <!ENTITY audacious-size "528 KB">
12 <!ENTITY audacious-buildsize "18 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 "b4340be4d3c1ec577937a2c5399c6d53">
18 <!ENTITY audacious-plugins-size "1.8 MB">
19 <!ENTITY audacious-plugins-buildsize "60 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 an audio player.
42 </para>
43
44 &lfs77_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&audacious-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&audacious-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &audacious-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &audacious-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &audacious-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &audacious-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81 <itemizedlist spacing="compact">
82 <title>Required Plugins</title>
83 <listitem>
84 <para>
85 Download (HTTP): <ulink url="&audacious-plugins-download;"/>
86 </para>
87 </listitem>
88 <listitem>
89 <para>
90 Download MD5 sum: &audacious-plugins-md5sum;
91 </para>
92 </listitem>
93 <listitem>
94 <para>
95 Download size: &audacious-plugins-size;
96 </para>
97 </listitem>
98 <listitem>
99 <para>
100 Estimated disk space required: &audacious-plugins-buildsize;
101 </para>
102 </listitem>
103 <listitem>
104 <para>
105 Estimated build time: &audacious-plugins-time;
106 </para>
107 </listitem>
108 </itemizedlist>
109
110 <bridgehead renderas="sect3">Audacious Dependencies</bridgehead>
111
112 <bridgehead renderas="sect4">Required</bridgehead>
113 <para role="required">
114 <xref linkend="gtk3"/>,
115 <xref linkend="libxml2"/> (plugins),
116 <xref linkend="xorg-env"/> (plugins), and
117 <xref linkend="x-window-system"/> (runtime)
118 </para>
119
120 <bridgehead renderas="sect4">Recommended</bridgehead>
121 <para role="optional">
122 <xref linkend="alsa"/> and
123 <xref linkend="dbus"/>
124 </para>
125
126 <bridgehead renderas="sect4">Optional</bridgehead>
127 <para role="optional">
128 <xref linkend="pcre"/> or
129 <ulink url="http://www.geocities.jp/kosako3/oniguruma/">Oniguruma</ulink>,
130 <xref linkend="valgrind"/> and
131 <ulink url="http://atheme.org/projects/libguess.html">libguess</ulink>
132 </para>
133
134 <bridgehead renderas="sect4">Optional (for Plugins)</bridgehead>
135 <para role="optional">
136 <xref linkend="curl"/>,
137 <xref linkend="faad2"/>,
138 <xref linkend="ffmpeg"/>,
139 <xref linkend="flac"/>,
140 <xref linkend="lame"/>,
141 <xref linkend="libcdio"/> (to identify and play CDs),
142 <xref linkend="libnotify"/>,
143 <xref linkend='libsamplerate'/>,
144 <xref linkend="libsndfile"/>,
145 <xref linkend="libvorbis"/>,
146 <xref linkend="mpg123"/>,
147 <xref linkend="neon"/> (for online mpg3 and ogg radio),
148 <xref linkend='pulseaudio'/>,
149 <xref linkend='qt5'/>,
150 <xref linkend="sdl"/>,
151 <ulink url="http://sourceforge.net/projects/bs2b/">The Bauer
152 stereophonic-to-binaural DSP (bs2b) library</ulink>,
153 <ulink url="http://sourceforge.net/apps/trac/fluidsynth/">FluidSynth</ulink>,
154 <ulink url="http://jackit.sourceforge.net/">JACK</ulink>
155 (requires <xref linkend="libsamplerate"/>),
156 <ulink url="http://sourceforge.net/projects/libbinio/">libbinio</ulink>
157 (to build the AdPlug plugin),
158 <ulink url="http://sourceforge.net/projects/libcue/">libcue</ulink>,
159 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
160 <ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
161 <ulink url="http://www.lirc.org/">LIRC</ulink>, and
162 <ulink url="http://www.wavpack.com/">WavPack</ulink>
163 </para>
164
165 <para condition="html" role="usernotes">
166 User Notes: <ulink url="&blfs-wiki;/audacious"/>
167 </para>
168 </sect2>
169
170 <sect2 role="installation">
171 <title>Installation of Audacious</title>
172
173 <para>
174 Install <application>Audacious</application> by running the following
175 commands (you may wish to change the stamp to another string):
176 </para>
177
178<screen><userinput>TPUT=/bin/true ./configure --prefix=/usr --with-buildstamp="BLFS" &amp;&amp;
179make</userinput></screen>
180<!--
181 <para>
182 If you have <xref linkend="doxygen"/> installed and wish to build the
183 API documentation, issue <command>doxygen</command>.
184 </para>-->
185
186 <para>
187 This package does not come with a test suite.
188 </para>
189
190 <para>
191 Now, as the <systemitem class="username">root</systemitem> user:
192 </para>
193
194<screen role="root"><userinput>make install</userinput></screen>
195<!--
196 <para>
197 If you built the API documentation, install it as the
198 <systemitem class="username">root</systemitem> user by issuing:
199 </para>
200
201<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/audacious-&audacious-version;/api &amp;&amp;
202install -v -m644 doc/html/* \
203 /usr/share/doc/audacious-&audacious-version;/api</userinput></screen>-->
204 </sect2>
205
206 <sect2 role="installation">
207 <title>Installation of Audacious Plugins</title>
208<!--
209 <note>
210 <para>
211 If <application>Xorg</application> is not installed in
212 <filename class="directory">/usr</filename>, tell the linker
213 where to find it:
214 </para>
215
216<screen><userinput>export LIBRARY_PATH=$XORG_PREFIX/lib</userinput></screen>
217
218 </note>-->
219
220 <para>
221 Install the required plugins package by unpacking the tarball, changing
222 into the newly created directory, and issuing the following
223 commands:
224 </para>
225
226<screen><userinput>TPUT=/bin/true ./configure --prefix=/usr &amp;&amp;
227make</userinput></screen>
228
229 <para>
230 This package does not come with a test suite.
231 </para>
232
233 <para>
234 Now, as the <systemitem class="username">root</systemitem> user:
235 </para>
236
237<screen role="root"><userinput>make install</userinput></screen>
238
239 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
240 href="../../xincludes/update-icons-and-desktop.xml"/>
241 </sect2>
242
243 <sect2 role="commands">
244 <title>Command Explanations</title>
245
246 <para>
247 <parameter>TPUT=/bin/true</parameter>: the default is for
248 <command>make</command> to output text in color. This is fine if you're
249 building in a terminal, but if you script the build process and pipe the
250 output from <command>make</command> to a log file then the control
251 characters used to color the text can make the logfile unreadable. This
252 option stops it coloring the text.
253 </para>
254
255 <para><parameter>--with-buildstamp</parameter>: This switch appends
256 the given text to the version string.</para>
257
258 <para><option>--disable-mp3</option>: Use this for the plugins if you have
259 not installed mpg123 and do not wish to play mp3 files.</para>
260
261 <para><option>--enable-valgrind</option>: Allow better Valgrind leak checks.</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 libaudcore.so, libaudgui.so, libaudtag.so, and several plugin
289 libraries under /usr/lib/audacious/ sub-directories
290 </seg>
291 <seg>
292 /usr/include/audacious,
293 /usr/include/libaudcore,
294 /usr/include/libaudgui,
295 /usr/lib/audacious and
296 /usr/share/audacious
297 </seg>
298 </seglistitem>
299 </segmentedlist>
300
301 <variablelist>
302 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
303 <?dbfo list-presentation="list"?>
304 <?dbhtml list-presentation="table"?>
305
306 <varlistentry id="audacious-prog">
307 <term><command>audacious</command></term>
308 <listitem>
309 <para>
310 is a GTK+2 port of <application>XMMS</application> based on the
311 <application>Beep Media Player</application>.
312 </para>
313 <indexterm zone="audacious audacious-prog">
314 <primary sortas="b-audacious">audacious</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="audtool">
320 <term><command>audtool</command></term>
321 <listitem>
322 <para>
323 is a small tool to modify the behavior of a running
324 <command>audacious</command> instance.
325 </para>
326 <indexterm zone="audacious audtool">
327 <primary sortas="b-audtool">audtool</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 </variablelist>
333
334 </sect2>
335
336</sect1>
Note: See TracBrowser for help on using the repository browser.