source: multimedia/audioutils/audacious.xml@ 0945dd2d

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 0945dd2d was 91318eb, checked in by Pierre Labastie <pierre.labastie@…>, 15 months ago

Add "setup" to meson commands

I've not been very consistent on typography, but it is a start
  • Property mode set to 100644
File size: 10.1 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 "eed7a193981abc32a418810f4f6d3ed7">
11 <!ENTITY audacious-size "612 KB">
12 <!ENTITY audacious-buildsize "15 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 "e8261853b63cc9d45e5897f266058c65">
18 <!ENTITY audacious-plugins-size "1.8 MB">
19 <!ENTITY audacious-plugins-buildsize "48 MB (with Qt5 and GTK3 support)">
20 <!ENTITY audacious-plugins-time "0.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 &lfs113_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"/>
113 </para>
114
115 <bridgehead renderas="sect4">Recommended</bridgehead>
116 <para role="optional">
117 <xref linkend="libarchive"/>
118 </para>
119
120 <bridgehead renderas="sect4">Optional</bridgehead>
121 <para role="optional">
122 <xref linkend="valgrind"/>
123 </para>
124
125 <bridgehead renderas="sect4">Recommended (for Plugins)</bridgehead>
126 <para role="recommended">
127 <xref linkend="mpg123"/>,
128 <xref linkend="ffmpeg"/>, and
129 <xref linkend="neon"/> (for online mp3 and ogg radio)
130 </para>
131
132 <bridgehead renderas="sect4">Optional (for Plugins)</bridgehead>
133 <para role="optional">
134 <xref linkend="alsa"/>,
135 <xref linkend="curl"/>,
136 <xref linkend="faad2"/>,
137 <xref linkend="flac"/>,
138 <xref linkend="lame"/>,
139 <xref linkend="libxml2"/>,
140 <xref linkend="libcdio"/> (to identify and play CDs),
141 <xref linkend="libnotify"/>,
142 <xref linkend="libsndfile"/>,
143 <xref linkend="libvorbis"/>,
144 <xref linkend="pipewire"/>,
145 <xref linkend="pulseaudio"/>,
146 <xref linkend="sdl2"/>,
147 <ulink url="https://ampache-browser.org/">ampache-browser</ulink>,
148 <ulink url="https://adplug.github.io/">adplug</ulink>,
149 <ulink url="https://sourceforge.net/projects/bs2b/">The Bauer
150 stereophonic-to-binaural DSP (bs2b) library</ulink>,
151 <ulink url="https://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
152 <ulink url="https://jackaudio.org/">JACK</ulink>
153 (requires <xref linkend="libsamplerate"/>),
154 <ulink url="https://sourceforge.net/projects/libcue/">libcue</ulink>,
155 <ulink url="https://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
156 <ulink url="https://sourceforge.net/projects/libmms">libmms</ulink>,
157 <ulink url="https://lib.openmpt.org/libopenmpt/">libopenmpt</ulink>,
158 <ulink url="https://www.sourceforge.net/projects/sidplay-residfp/">libsidplayfp</ulink>,
159 <ulink url="https://www.lirc.org/">LIRC</ulink>,
160 <ulink url="https://sndio.org/">sndio</ulink>,
161 <ulink url="https://sourceforge.net/p/soxr/wiki/Home/">SoX</ulink>, and
162 <ulink url="https://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 <sect3>
174 <title>Installation of the Main Audacious Program</title>
175
176 <para>
177 Install <application>Audacious</application> by running the following
178 commands (you may wish to change the buildstamp to another string):
179 </para>
180
181<screen><userinput>mkdir build &amp;&amp;
182cd build &amp;&amp;
183
184meson setup --prefix=/usr \
185 --buildtype=release \
186 -Dgtk3=true \
187 -Dbuildstamp=BLFS \
188 -Dlibarchive=true \
189 .. &amp;&amp;
190
191ninja</userinput></screen>
192
193 <para>
194 This package does not come with a test suite.
195 </para>
196
197 <para>
198 Now, as the &root; user:
199 </para>
200
201<screen role="root"><userinput>ninja install</userinput></screen>
202
203 </sect3>
204
205 <sect3>
206 <title>Installation of Audacious Plugins</title>
207
208 <para>
209 Install the required plugins package by issuing the following commands:
210 </para>
211
212<screen><userinput>tar -xf ../audacious-plugins-&audacious-plugins-version;.tar.bz2 &amp;&amp;
213cd audacious-plugins-&audacious-plugins-version; &amp;&amp;
214
215mkdir build &amp;&amp;
216cd build &amp;&amp;
217
218meson setup \
219 --prefix=/usr \
220 --buildtype=release \
221 -Dgtk3=true \
222 .. &amp;&amp;
223
224ninja</userinput></screen>
225
226 <para>
227 Now, as the &root; user:
228 </para>
229
230<screen role="root"><userinput>ninja install</userinput></screen>
231
232 </sect3>
233 </sect2>
234
235 <sect2 role="commands">
236 <title>Command Explanations</title>
237
238 <para>
239 <parameter>-Dbuildstamp=BLFS</parameter>: This switch appends
240 the given text to the version string.
241 </para>
242
243 <para>
244 <option>-Dgtk3=true</option>: This options sets the default graphical
245 user interface.
246 </para>
247
248 <para>
249 <option>-Dvalgrind=true</option>: The option enables Valgrind analysis support.
250 </para>
251
252 </sect2>
253
254<!-- None of this seems valid for audacios-4.3
255 <sect2 role="configuration">
256 <title>Configuring Audacious</title>
257
258 <para>
259 If you built with both Gtk and Qt user interfaces, the Qt version
260 can be executed from a terminal, issuing <command>audacious
261 - -qt</command>. If you wish a desktop menu entry to execute this Qt
262 version, issue the following commands as the <systemitem
263 class="username">root</systemitem> user:
264 </para>
265
266<screen role="root"><userinput>cp -v /usr/share/applications/audacious{,-qt}.desktop &amp;&amp;
267
268sed -e '/^Name/ s/$/ Qt/' \
269 -e '/Exec=/ s/audacious/&amp; - -qt/' \
270 -i /usr/share/applications/audacious-qt.desktop</userinput></screen>
271
272 </sect2>
273-->
274 <sect2 role="content">
275 <title>Contents</title>
276
277 <segmentedlist>
278 <segtitle>Installed Programs</segtitle>
279 <segtitle>Installed Libraries</segtitle>
280 <segtitle>Installed Directories</segtitle>
281
282 <seglistitem>
283 <seg>
284 audacious and
285 audtool
286 </seg>
287 <seg>
288 libaudcore.so,
289 libaudgui.so,
290 libaudqt.so,
291 libaudtag.so,
292 and several plugin libraries under /usr/lib/audacious/ sub-directories
293 </seg>
294 <seg>
295 /usr/include/{audacious,libaudcore,libaudgui,libaudqt},
296 /usr/lib/audacious, and
297 /usr/share/audacious
298 </seg>
299 </seglistitem>
300 </segmentedlist>
301
302 <variablelist>
303 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
304 <?dbfo list-presentation="list"?>
305 <?dbhtml list-presentation="table"?>
306
307 <varlistentry id="audacious-prog">
308 <term><command>audacious</command></term>
309 <listitem>
310 <para>
311 is an audio player and is a descendant of <application>XMMS</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.