source: multimedia/audioutils/audacious.xml@ e89b2a0

trunk
Last change on this file since e89b2a0 was e89b2a0, checked in by Bruce Dubbs <bdubbs@…>, 2 weeks ago

Update to audacious/audacious-plugins-4.4.
  • Property mode set to 100644
File size: 10.2 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 "https://distfiles.audacious-media-player.org/audacious-&audacious-version;.tar.bz2">
9 <!ENTITY audacious-download-ftp " ">
10 <!ENTITY audacious-md5sum "812367242529db8ca0fb0fdb71ffc91f">
11 <!ENTITY audacious-size "624 KB">
12 <!ENTITY audacious-buildsize "14 MB (with GTK support)">
13 <!ENTITY audacious-time "0.2 SBU (with GTK support)">
14
15 <!ENTITY audacious-plugins-download
16 "https://distfiles.audacious-media-player.org/audacious-plugins-&audacious-plugins-version;.tar.bz2">
17 <!ENTITY audacious-plugins-md5sum "0946f32277afc60ec12510bd09507016">
18 <!ENTITY audacious-plugins-size "1.7 MB">
19 <!ENTITY audacious-plugins-buildsize "40 MB (with GTK support)">
20 <!ENTITY audacious-plugins-time "2.0 SBU (with GTK support)">
21]>
22
23<sect1 id="audacious" xreflabel="Audacious-&audacious-version;">
24 <?dbhtml filename="audacious.html"?>
25
26
27 <title>Audacious-&audacious-version;</title>
28
29 <indexterm zone="audacious">
30 <primary sortas="a-Audacious">Audacious</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Audacious</title>
35
36 <para>
37 <application>Audacious</application> is an audio player.
38 </para>
39
40 &lfs121_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&audacious-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&audacious-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &audacious-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &audacious-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &audacious-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &audacious-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
77 <itemizedlist spacing="compact">
78 <title>Required Plugins</title>
79 <listitem>
80 <para>
81 Download (HTTP): <ulink url="&audacious-plugins-download;"/>
82 </para>
83 </listitem>
84 <listitem>
85 <para>
86 Download MD5 sum: &audacious-plugins-md5sum;
87 </para>
88 </listitem>
89 <listitem>
90 <para>
91 Download size: &audacious-plugins-size;
92 </para>
93 </listitem>
94 <listitem>
95 <para>
96 Estimated disk space required: &audacious-plugins-buildsize;
97 </para>
98 </listitem>
99 <listitem>
100 <para>
101 Estimated build time: &audacious-plugins-time;
102 </para>
103 </listitem>
104 </itemizedlist>
105
106 <bridgehead renderas="sect3">Audacious Dependencies</bridgehead>
107
108 <bridgehead renderas="sect4">Required</bridgehead>
109 <para role="required">
110 <xref linkend="gtk3"/> or
111 <xref linkend="qt6"/>
112 </para>
113
114 <bridgehead renderas="sect4">Recommended</bridgehead>
115 <para role="optional">
116 <xref linkend="libarchive"/>
117 </para>
118
119 <bridgehead renderas="sect4">Optional</bridgehead>
120 <para role="optional">
121 <xref linkend="valgrind"/>
122 </para>
123
124 <bridgehead renderas="sect4">Recommended (for Plugins)</bridgehead>
125 <para role="recommended">
126 <xref linkend="mpg123"/>,
127 <xref linkend="ffmpeg"/>, and
128 <xref linkend="neon"/> (for online mp3 and ogg radio)
129 </para>
130
131 <bridgehead renderas="sect4">Optional (for Plugins)</bridgehead>
132 <para role="optional">
133 <xref linkend="alsa-lib"/>,
134 <xref linkend="curl"/>,
135 <xref linkend="faad2"/>,
136 <xref linkend="flac"/>,
137 <xref linkend="lame"/>,
138 <xref linkend="libxml2"/>,
139 <xref linkend="libcdio"/> (to identify and play CDs),
140 <xref linkend="libnotify"/>,
141 <xref linkend="libsndfile"/>,
142 <xref linkend="libvorbis"/>,
143 <xref linkend="pipewire"/>,
144 <xref linkend="pulseaudio"/>,
145 <xref linkend="sdl2"/>,
146 <ulink url="https://ampache-browser.org/">ampache-browser</ulink>,
147 <ulink url="https://adplug.github.io/">adplug</ulink>,
148 <ulink url="https://sourceforge.net/projects/bs2b/">The Bauer
149 stereophonic-to-binaural DSP (bs2b) library</ulink>,
150 <ulink url="https://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
151 <ulink url="https://jackaudio.org/">JACK</ulink>
152 (requires <xref linkend="libsamplerate"/>),
153 <ulink url="https://sourceforge.net/projects/libcue/">libcue</ulink>,
154 <ulink url="https://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
155 <ulink url="https://sourceforge.net/projects/libmms">libmms</ulink>,
156 <ulink url="https://lib.openmpt.org/libopenmpt/">libopenmpt</ulink>,
157 <ulink url="https://www.sourceforge.net/projects/sidplay-residfp/">libsidplayfp</ulink>,
158 <ulink url="https://www.lirc.org/">LIRC</ulink>,
159 <ulink url="https://sndio.org/">sndio</ulink>,
160 <ulink url="https://sourceforge.net/p/soxr/wiki/Home/">SoX</ulink>, and
161 <ulink url="https://www.wavpack.com/">WavPack</ulink>
162 </para>
163
164 </sect2>
165
166 <sect2 role="installation">
167 <title>Installation of Audacious</title>
168
169 <sect3>
170 <title>Installation of the Main Audacious Program</title>
171
172 <para>
173 Install <application>Audacious</application> by running the following
174 commands (you may wish to change the buildstamp to another string):
175 </para>
176
177<screen><userinput>mkdir build &amp;&amp;
178cd build &amp;&amp;
179
180meson setup --prefix=/usr \
181 --buildtype=release \
182 -D gtk=true \
183 -D buildstamp=BLFS \
184 -D libarchive=true \
185 .. &amp;&amp;
186
187ninja</userinput></screen>
188
189 <para>
190 This package does not come with a test suite.
191 </para>
192
193 <para>
194 Now, as the &root; user:
195 </para>
196
197<screen role="root"><userinput>ninja install</userinput></screen>
198
199 </sect3>
200
201 <sect3>
202 <title>Installation of Audacious Plugins</title>
203
204 <para>
205 Install the required plugins package by issuing the following commands:
206 </para>
207
208<screen><userinput>tar -xf ../../audacious-plugins-&audacious-plugins-version;.tar.bz2 &amp;&amp;
209cd audacious-plugins-&audacious-plugins-version; &amp;&amp;
210
211mkdir build &amp;&amp;
212cd build &amp;&amp;
213
214meson setup \
215 --prefix=/usr \
216 --buildtype=release \
217 -D gtk=true \
218 .. &amp;&amp;
219
220ninja</userinput></screen>
221
222 <para>
223 Now, as the &root; user:
224 </para>
225
226<screen role="root"><userinput>ninja install</userinput></screen>
227
228 </sect3>
229 </sect2>
230
231 <sect2 role="commands">
232 <title>Command Explanations</title>
233
234 <para>
235 <parameter>-Di buildstamp=BLFS</parameter>: This switch appends
236 the given text to the version string.
237 </para>
238
239 <para>
240 <parameter>-D gtk=true</parameter>: This option enables GTK support for th
241 graphical user interface.
242 </para>
243
244 <para>
245 <parameter>-D qt=true</parameter>: This option enables Qt support for the
246 graphical user interface.
247 </para>
248
249 <para>
250 <parameter>-D libarchive=true</parameter>: This adds libarchive support,
251 for reading compressed module sets or skins.
252 </para>
253
254 <para>
255 <option>-D valgrind=true</option>: The option enables Valgrind analysis
256 support.
257 </para>
258
259 </sect2>
260
261<!-- None of this seems valid for audacios-4.3
262 <sect2 role="configuration">
263 <title>Configuring Audacious</title>
264
265 <para>
266 If you built with both Gtk and Qt user interfaces, the Qt version
267 can be executed from a terminal, issuing <command>audacious
268 - -qt</command>. If you wish a desktop menu entry to execute this Qt
269 version, issue the following commands as the <systemitem
270 class="username">root</systemitem> user:
271 </para>
272
273<screen role="root"><userinput>cp -v /usr/share/applications/audacious{,-qt}.desktop &amp;&amp;
274
275sed -e '/^Name/ s/$/ Qt/' \
276 -e '/Exec=/ s/audacious/&amp; - -qt/' \
277 -i /usr/share/applications/audacious-qt.desktop</userinput></screen>
278
279 </sect2>
280-->
281 <sect2 role="content">
282 <title>Contents</title>
283
284 <segmentedlist>
285 <segtitle>Installed Programs</segtitle>
286 <segtitle>Installed Libraries</segtitle>
287 <segtitle>Installed Directories</segtitle>
288
289 <seglistitem>
290 <seg>
291 audacious and
292 audtool
293 </seg>
294 <seg>
295 libaudcore.so,
296 libaudgui.so,
297 libaudqt.so,
298 libaudtag.so,
299 and several plugin libraries under /usr/lib/audacious/ sub-directories
300 </seg>
301 <seg>
302 /usr/include/{audacious,libaudcore,libaudgui,libaudqt},
303 /usr/lib/audacious, and
304 /usr/share/audacious
305 </seg>
306 </seglistitem>
307 </segmentedlist>
308
309 <variablelist>
310 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
311 <?dbfo list-presentation="list"?>
312 <?dbhtml list-presentation="table"?>
313
314 <varlistentry id="audacious-prog">
315 <term><command>audacious</command></term>
316 <listitem>
317 <para>
318 is an audio player and is a descendant of <application>XMMS</application>
319 </para>
320 <indexterm zone="audacious audacious-prog">
321 <primary sortas="b-audacious">audacious</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="audtool">
327 <term><command>audtool</command></term>
328 <listitem>
329 <para>
330 is a small tool to modify the behavior of a running
331 <command>audacious</command> instance
332 </para>
333 <indexterm zone="audacious audtool">
334 <primary sortas="b-audtool">audtool</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 </variablelist>
340
341 </sect2>
342
343</sect1>
Note: See TracBrowser for help on using the repository browser.