source: multimedia/audioutils/audacious.xml@ ae7b79d

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since ae7b79d was ae7b79d, checked in by Pierre Labastie <pierre.labastie@…>, 10 months ago

Fix extraction of audacious-plugins source

Now that we use meson, the tarball is one directory further up
  • Property mode set to 100644
File size: 10.2 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 "https://distfiles.audacious-media-player.org/audacious-&audacious-version;.tar.bz2">
9 <!ENTITY audacious-download-ftp " ">
10 <!ENTITY audacious-md5sum "751a002964907c3a8fc2f571ffc00ec7">
11 <!ENTITY audacious-size "620 KB">
12 <!ENTITY audacious-buildsize "16 MB (with Qt5 and GTK3 support)">
13 <!ENTITY audacious-time "0.2 SBU (with Qt5 and GTK3 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 "3e233d8219407218244e684e096236ec">
18 <!ENTITY audacious-plugins-size "1.7 MB">
19 <!ENTITY audacious-plugins-buildsize "37 MB (with Qt5 and GTK3 support)">
20 <!ENTITY audacious-plugins-time "1.4 SBU (with Qt5 and GTK3 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 &lfs120_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 role="nodep" linkend="gtk2"/> or
111 <xref linkend="gtk3"/> or
112 (<xref role="nodep" linkend="qt5"/> or
113 <xref linkend="qt5-components"/> with qtimageformats)
114 </para>
115
116 <bridgehead renderas="sect4">Recommended</bridgehead>
117 <para role="optional">
118 <xref linkend="libarchive"/>
119 </para>
120
121 <bridgehead renderas="sect4">Optional</bridgehead>
122 <para role="optional">
123 <xref linkend="valgrind"/>
124 </para>
125
126 <bridgehead renderas="sect4">Recommended (for Plugins)</bridgehead>
127 <para role="recommended">
128 <xref linkend="mpg123"/>,
129 <xref linkend="ffmpeg"/>, and
130 <xref linkend="neon"/> (for online mp3 and ogg radio)
131 </para>
132
133 <bridgehead renderas="sect4">Optional (for Plugins)</bridgehead>
134 <para role="optional">
135 <xref linkend="alsa"/>,
136 <xref linkend="curl"/>,
137 <xref linkend="faad2"/>,
138 <xref linkend="flac"/>,
139 <xref linkend="lame"/>,
140 <xref linkend="libxml2"/>,
141 <xref linkend="libcdio"/> (to identify and play CDs),
142 <xref linkend="libnotify"/>,
143 <xref linkend="libsndfile"/>,
144 <xref linkend="libvorbis"/>,
145 <xref linkend="pipewire"/>,
146 <xref linkend="pulseaudio"/>,
147 <xref linkend="sdl2"/>,
148 <ulink url="https://ampache-browser.org/">ampache-browser</ulink>,
149 <ulink url="https://adplug.github.io/">adplug</ulink>,
150 <ulink url="https://sourceforge.net/projects/bs2b/">The Bauer
151 stereophonic-to-binaural DSP (bs2b) library</ulink>,
152 <ulink url="https://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
153 <ulink url="https://jackaudio.org/">JACK</ulink>
154 (requires <xref linkend="libsamplerate"/>),
155 <ulink url="https://sourceforge.net/projects/libcue/">libcue</ulink>,
156 <ulink url="https://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
157 <ulink url="https://sourceforge.net/projects/libmms">libmms</ulink>,
158 <ulink url="https://lib.openmpt.org/libopenmpt/">libopenmpt</ulink>,
159 <ulink url="https://www.sourceforge.net/projects/sidplay-residfp/">libsidplayfp</ulink>,
160 <ulink url="https://www.lirc.org/">LIRC</ulink>,
161 <ulink url="https://sndio.org/">sndio</ulink>,
162 <ulink url="https://sourceforge.net/p/soxr/wiki/Home/">SoX</ulink>, and
163 <ulink url="https://www.wavpack.com/">WavPack</ulink>
164 </para>
165
166 <para condition="html" role="usernotes">
167 Editor Notes: <ulink url="&blfs-wiki;/audacious"/>
168 </para>
169 </sect2>
170
171 <sect2 role="installation">
172 <title>Installation of Audacious</title>
173
174 <sect3>
175 <title>Installation of the Main Audacious Program</title>
176
177 <para>
178 Install <application>Audacious</application> by running the following
179 commands (you may wish to change the buildstamp to another string):
180 </para>
181
182<screen><userinput>mkdir build &amp;&amp;
183cd build &amp;&amp;
184
185meson setup --prefix=/usr \
186 --buildtype=release \
187 -Dgtk3=true \
188 -Dbuildstamp=BLFS \
189 -Dlibarchive=true \
190 .. &amp;&amp;
191
192ninja</userinput></screen>
193
194 <para>
195 This package does not come with a test suite.
196 </para>
197
198 <para>
199 Now, as the &root; user:
200 </para>
201
202<screen role="root"><userinput>ninja install</userinput></screen>
203
204 </sect3>
205
206 <sect3>
207 <title>Installation of Audacious Plugins</title>
208
209 <para>
210 Install the required plugins package by issuing the following commands:
211 </para>
212
213<screen><userinput>tar -xf ../../audacious-plugins-&audacious-plugins-version;.tar.bz2 &amp;&amp;
214cd audacious-plugins-&audacious-plugins-version; &amp;&amp;
215
216mkdir build &amp;&amp;
217cd build &amp;&amp;
218
219meson setup \
220 --prefix=/usr \
221 --buildtype=release \
222 -Dgtk3=true \
223 .. &amp;&amp;
224
225ninja</userinput></screen>
226
227 <para>
228 Now, as the &root; user:
229 </para>
230
231<screen role="root"><userinput>ninja install</userinput></screen>
232
233 </sect3>
234 </sect2>
235
236 <sect2 role="commands">
237 <title>Command Explanations</title>
238
239 <para>
240 <parameter>-Dbuildstamp=BLFS</parameter>: This switch appends
241 the given text to the version string.
242 </para>
243
244 <para>
245 <option>-Dgtk3=true</option>: This options sets the default graphical
246 user interface.
247 </para>
248
249 <para>
250 <option>-Dvalgrind=true</option>: The option enables Valgrind analysis support.
251 </para>
252
253 </sect2>
254
255<!-- None of this seems valid for audacios-4.3
256 <sect2 role="configuration">
257 <title>Configuring Audacious</title>
258
259 <para>
260 If you built with both Gtk and Qt user interfaces, the Qt version
261 can be executed from a terminal, issuing <command>audacious
262 - -qt</command>. If you wish a desktop menu entry to execute this Qt
263 version, issue the following commands as the <systemitem
264 class="username">root</systemitem> user:
265 </para>
266
267<screen role="root"><userinput>cp -v /usr/share/applications/audacious{,-qt}.desktop &amp;&amp;
268
269sed -e '/^Name/ s/$/ Qt/' \
270 -e '/Exec=/ s/audacious/&amp; - -qt/' \
271 -i /usr/share/applications/audacious-qt.desktop</userinput></screen>
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
286 audtool
287 </seg>
288 <seg>
289 libaudcore.so,
290 libaudgui.so,
291 libaudqt.so,
292 libaudtag.so,
293 and several plugin libraries under /usr/lib/audacious/ sub-directories
294 </seg>
295 <seg>
296 /usr/include/{audacious,libaudcore,libaudgui,libaudqt},
297 /usr/lib/audacious, and
298 /usr/share/audacious
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 an audio player and is a descendant of <application>XMMS</application>
313 </para>
314 <indexterm zone="audacious audacious-prog">
315 <primary sortas="b-audacious">audacious</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="audtool">
321 <term><command>audtool</command></term>
322 <listitem>
323 <para>
324 is a small tool to modify the behavior of a running
325 <command>audacious</command> instance
326 </para>
327 <indexterm zone="audacious audtool">
328 <primary sortas="b-audtool">audtool</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 </variablelist>
334
335 </sect2>
336
337</sect1>
Note: See TracBrowser for help on using the repository browser.