source: multimedia/audioutils/audacious.xml@ be75671

12.2 trunk
Last change on this file since be75671 was c36ca685, checked in by Bruce Dubbs <bdubbs@…>, 4 weeks ago

Tag Part XII. Multimedia
  • 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 &lfs122_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"/> and
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 qt=true \
184 -D buildstamp=BLFS \
185 -D libarchive=true \
186 .. &amp;&amp;
187
188ninja</userinput></screen>
189
190 <para>
191 This package does not come with a test suite.
192 </para>
193
194 <para>
195 Now, as the &root; user:
196 </para>
197
198<screen role="root"><userinput>ninja install</userinput></screen>
199
200 </sect3>
201
202 <sect3>
203 <title>Installation of Audacious Plugins</title>
204
205 <para>
206 Install the required plugins package by issuing the following commands:
207 </para>
208
209<screen><userinput>tar -xf ../../audacious-plugins-&audacious-plugins-version;.tar.bz2 &amp;&amp;
210cd audacious-plugins-&audacious-plugins-version; &amp;&amp;
211
212mkdir build &amp;&amp;
213cd build &amp;&amp;
214
215meson setup \
216 --prefix=/usr \
217 --buildtype=release \
218 -D gtk=true \
219 -D qt=true \
220 .. &amp;&amp;
221
222ninja</userinput></screen>
223
224 <para>
225 Now, as the &root; user:
226 </para>
227
228<screen role="root"><userinput>ninja install</userinput></screen>
229
230 </sect3>
231 </sect2>
232
233 <sect2 role="commands">
234 <title>Command Explanations</title>
235
236 <para>
237 <parameter>-D buildstamp=BLFS</parameter>: This switch appends
238 the given text to the version string.
239 </para>
240
241 <para>
242 <parameter>-D gtk=true</parameter>: This option enables GTK support for the
243 graphical user interface.
244 </para>
245
246 <para>
247 <parameter>-D qt=true</parameter>: This option enables Qt support for the
248 graphical user interface.
249 </para>
250
251 <para>
252 <parameter>-D libarchive=true</parameter>: This adds libarchive support,
253 for reading compressed module sets or skins.
254 </para>
255
256 <para>
257 <option>-D valgrind=true</option>: The option enables Valgrind analysis
258 support.
259 </para>
260
261 </sect2>
262
263<!-- None of this seems valid for audacios-4.3
264 <sect2 role="configuration">
265 <title>Configuring Audacious</title>
266
267 <para>
268 If you built with both Gtk and Qt user interfaces, the Qt version
269 can be executed from a terminal, issuing <command>audacious
270 - -qt</command>. If you wish a desktop menu entry to execute this Qt
271 version, issue the following commands as the <systemitem
272 class="username">root</systemitem> user:
273 </para>
274
275<screen role="root"><userinput>cp -v /usr/share/applications/audacious{,-qt}.desktop &amp;&amp;
276
277sed -e '/^Name/ s/$/ Qt/' \
278 -e '/Exec=/ s/audacious/&amp; - -qt/' \
279 -i /usr/share/applications/audacious-qt.desktop</userinput></screen>
280
281 </sect2>
282-->
283 <sect2 role="content">
284 <title>Contents</title>
285
286 <segmentedlist>
287 <segtitle>Installed Programs</segtitle>
288 <segtitle>Installed Libraries</segtitle>
289 <segtitle>Installed Directories</segtitle>
290
291 <seglistitem>
292 <seg>
293 audacious and
294 audtool
295 </seg>
296 <seg>
297 libaudcore.so,
298 libaudgui.so,
299 libaudqt.so,
300 libaudtag.so,
301 and several plugin libraries under /usr/lib/audacious/ sub-directories
302 </seg>
303 <seg>
304 /usr/include/{audacious,libaudcore,libaudgui,libaudqt},
305 /usr/lib/audacious, and
306 /usr/share/audacious
307 </seg>
308 </seglistitem>
309 </segmentedlist>
310
311 <variablelist>
312 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
313 <?dbfo list-presentation="list"?>
314 <?dbhtml list-presentation="table"?>
315
316 <varlistentry id="audacious-prog">
317 <term><command>audacious</command></term>
318 <listitem>
319 <para>
320 is an audio player and is a descendant of <application>XMMS</application>
321 </para>
322 <indexterm zone="audacious audacious-prog">
323 <primary sortas="b-audacious">audacious</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="audtool">
329 <term><command>audtool</command></term>
330 <listitem>
331 <para>
332 is a small tool to modify the behavior of a running
333 <command>audacious</command> instance
334 </para>
335 <indexterm zone="audacious audtool">
336 <primary sortas="b-audtool">audtool</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 </variablelist>
342
343 </sect2>
344
345</sect1>
Note: See TracBrowser for help on using the repository browser.