source: multimedia/videoutils/vlc.xml@ 0a739106

trunk
Last change on this file since 0a739106 was 0e16b36, checked in by Bruce Dubbs <bdubbs@…>, 3 weeks ago

Archive qt5.

There are a large number of packages that needed to be changed to
remove qt5, but most are harmless. One package that is affected
is vlc where the gui interface is no longer available. Videos
can still be played from the command line and the kf6 dependency
on vlc is still satisfied.

If necessary qt5 can be restored for vlc.

Also three other files are archived that are no longer needed.

  • Property mode set to 100644
File size: 16.3 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 vlc-download-http "https://download.videolan.org/vlc/&vlc-version;/vlc-&vlc-version;.tar.xz">
8 <!ENTITY vlc-download-ftp " ">
9 <!ENTITY vlc-md5sum "cde72f38943c685a1a39acc82da2339f">
10 <!ENTITY vlc-size "24 MB">
11 <!ENTITY vlc-buildsize "746 MB">
12 <!ENTITY vlc-time "1.9 SBU (using parallelism=4; with tests)">
13]>
14
15<sect1 id="vlc" xreflabel="VLC-&vlc-version;">
16 <?dbhtml filename="vlc.html"?>
17
18
19 <title>VLC-&vlc-version;</title>
20
21 <indexterm zone="vlc">
22 <primary sortas="a-VLC">VLC</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to VLC</title>
27
28 <para>
29 <application>VLC</application> is a media player, streamer, and encoder.
30 It can play from many inputs, such as files, network streams, capture
31 devices, desktops, or DVD, SVCD, VCD, and audio CD. It can use most audio
32 and video codecs (MPEG 1/2/4, H264, VC-1, DivX, WMV, Vorbis, AC3, AAC,
33 etc.), and it can also convert to different formats and/or send streams
34 through the network.
35 </para>
36
37 &lfs122_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&vlc-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&vlc-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &vlc-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &vlc-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &vlc-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &vlc-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing='compact'>
75 <listitem>
76 <para>
77 Required patch:
78 <ulink url="&patch-root;/vlc-&vlc-version;-taglib-1.patch"/>
79 </para>
80 </listitem>
81<!-- <listitem>
82 <para>
83 Required patch:
84 <ulink url="&patch-root;/vlc-&vlc-version;-gcc14-1.patch"/>
85 </para>
86 </listitem> -->
87 <listitem>
88 <para>
89 Required patch:
90 <ulink url="&patch-root;/vlc-&vlc-version;-fedora_ffmpeg7-1.patch"/>
91 </para>
92 </listitem>
93 </itemizedlist>
94
95 <bridgehead renderas="sect3">VLC Dependencies</bridgehead>
96
97 <bridgehead renderas="sect4">Recommended</bridgehead>
98 <para role="recommended">
99 <xref linkend="alsa-lib"/>,
100 <xref linkend="desktop-file-utils"/>,
101 <xref linkend="ffmpeg"/>,
102 <xref linkend="liba52"/>,
103 <xref linkend="libgcrypt"/>
104 <xref linkend="libmad"/>,
105 <xref linkend="lua52"/>, and
106 <xref linkend="x-window-system"/>
107 </para>
108
109 <bridgehead renderas="sect4">Optional features and packages</bridgehead>
110 <para role="optional">
111 <xref linkend="dbus"/>,
112 <xref linkend="libidn"/>, and
113 <xref linkend="libssh2"/>
114 </para>
115
116 <bridgehead renderas="sect4">Optional input plugins</bridgehead>
117 <para role="optional">
118 <xref linkend="libarchive"/>,
119 <xref linkend="libcddb"/>,
120 <xref linkend="libdv"/>,
121 <xref linkend="libdvdcss"/>,
122 <xref linkend="libdvdread"/>,
123 <xref linkend="libdvdnav"/>,
124 <xref linkend="opencv"/>,
125 <xref linkend="samba"/>,
126 <xref linkend="v4l-utils"/>,
127 <ulink url="https://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
128 <ulink url="https://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
129 <ulink url="https://github.com/sahlberg/libnfs">libnfs</ulink>,
130 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>,
131 <ulink url="https://sourceforge.net/projects/libraw1394/">libraw1394</ulink>,
132 <ulink url="http://www.live555.com/">Live555</ulink>, and
133 <ulink url="https://www.gnu.org/software/vcdimager/">VCDImager</ulink>
134 (requires <xref linkend="libcdio"/>)
135 </para>
136
137 <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
138 <para role="optional">
139 <xref linkend="libogg"/>,
140 <ulink url="https://github.com/kode54/Game_Music_Emu">Game Music Emu</ulink>,
141 <ulink url="https://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</ulink>,
142 <ulink url="https://downloads.xiph.org/releases/libshout/">libshout</ulink>,
143 <ulink url="https://dl.matroska.org/downloads/libmatroska/">libmatroska</ulink>
144 (requires <ulink url="https://dl.matroska.org/downloads/libebml/">libebml</ulink>),
145 <ulink url="https://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
146 <ulink url="https://www.musepack.net/">Musepack</ulink>, and
147 <ulink url="https://sourceforge.net/projects/sidplay2/">sidplay-libs</ulink>
148 </para>
149
150 <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
151 <para role="optional">
152 <xref linkend="faad2"/>,
153 <xref linkend="flac"/>,
154 <xref linkend="libaom"/>,
155 <xref linkend="libass"/>,
156 <xref linkend="libmpeg2"/>,
157 <xref linkend="libpng"/>,
158 <!--<xref linkend="libtheora"/>,-->
159 <xref linkend="libva"/>,
160 <xref linkend="libvorbis"/>,
161 <xref linkend="opus"/>,
162 <xref linkend="speex"/>,
163 <xref linkend="libvpx"/>,
164 <xref linkend="x264"/>,
165 <!--<ulink url="https://aomedia.googlesource.com/aom/">aom</ulink>,-->
166 <ulink url="https://github.com/nkoriyama/aribb24">aribb24</ulink>,
167 <ulink url="https://code.videolan.org/videolan/dav1d">dav1d</ulink>,
168 <ulink url="https://sourceforge.net/projects/dirac/">Dirac</ulink>,
169 <ulink url="https://github.com/divideconcept/FluidLite">FluidLite</ulink>,
170 <ulink url="https://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
171 <ulink url="https://www.videolan.org/developers/libdca.html">libdca</ulink>,
172 <ulink url="https://wiki.xiph.org/index.php/OggKate">libkate</ulink>,
173 <ulink url="https://www.theora.org">libtheora</ulink>,
174 <ulink url="https://www.khronos.org/openmax/">OpenMAX</ulink>,
175 <ulink url="https://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
176 <ulink url="https://github.com/toots/shine">Shine</ulink>,
177 <ulink url="https://sourceforge.net/p/soxr/wiki/Home/">SoX</ulink>,
178 <ulink url="https://wiki.xiph.org/Tremor">Tremor</ulink>,
179 <ulink url="https://www.twolame.org/">Twolame</ulink>, and
180 <ulink url="https://sourceforge.net/projects/zapping/">Zapping VBI</ulink>
181 </para>
182
183 <bridgehead renderas="sect4">Optional video plugins</bridgehead>
184 <para role="optional">
185 <xref linkend="aalib"/>,
186 <xref linkend="fontconfig"/>,
187 <xref linkend="freetype2"/>,
188 <xref linkend="fribidi"/>,
189 <!-- Using libplacebo is broken due to many API changes. The patch Arch
190 has for this only works on a version of libplacebo from July. VLC has
191 fixed this problem, but only for the upcoming VLC4.
192 https://code.videolan.org/videolan/vlc/-/merge_requests/2233#top -->
193 <xref linkend="libplacebo"/> (currently broken),
194 <xref linkend="librsvg"/>,
195 <xref linkend="libvdpau"/>,
196 <xref linkend="sdl"/>,
197 <ulink url="https://github.com/cacalabs/libcaca">libcaca</ulink>, and
198 <!--<ulink url="http://libplacebo.org/">libplacebo</ulink>, and-->
199 <ulink url="https://github.com/Intel-Media-SDK/MediaSDK">libmfx</ulink>
200 </para>
201
202 <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
203 <para role="optional">
204 <xref linkend="pulseaudio"/>,
205 <xref linkend="libsamplerate"/>,
206 <ulink url="https://github.com/videolabs/libspatialaudio">spatialaudio</ulink>, and
207 <ulink url="https://jackaudio.org/">JACK</ulink>
208 </para>
209
210 <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
211 <para role="optional">
212 <xref linkend="freerdp"/>,
213 <ulink url="https://repo.or.cz/w/libtar.git/">libtar</ulink>,
214 <ulink url="https://libvnc.github.io/">libvncclient</ulink>, and
215 <ulink url="https://www.lirc.org/">LIRC</ulink>
216 </para>
217
218 <bridgehead renderas="sect4">Optional visualisations and video filter plugins</bridgehead>
219 <para role="optional">
220 <ulink url="https://sourceforge.net/projects/goom/">Goom</ulink>,
221 <ulink url="https://www.vsxu.com">libvsxu</ulink>, and
222 <ulink url="https://sourceforge.net/projects/projectm/">projectM</ulink>
223 </para>
224
225 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
226 <para role="optional">
227 <xref linkend="avahi"/>,
228 <ulink url="https://sourceforge.net/projects/libmtp/">libmtp</ulink> and
229 <ulink url="https://sourceforge.net/projects/pupnp/">libupnp</ulink>
230 </para>
231
232 <bridgehead renderas="sect4">Miscellaneous options</bridgehead>
233 <para role="optional">
234 <xref linkend="gnutls"/>,
235 <xref linkend="libnotify"/>,
236 <xref linkend="libxml2"/>,
237 <xref linkend="protobuf"/>,
238 <xref linkend="taglib"/>,
239 <xref role="runtime" linkend="xdg-utils"/> (runtime),
240 <ulink url="https://www.team-mediaportal.com/extensions/mp2-plugins/atmolight">AtmoLight</ulink>,
241 <ulink url="https://github.com/videolabs/libmicrodns">libmicrodns</ulink>, and
242 <!--<ulink url="https://developers.google.com/protocol-buffers/">protobuf</ulink>, and-->
243 <ulink url="https://github.com/Haivision/srt">Srt</ulink>
244 </para>
245
246 </sect2>
247
248 <sect2 role="installation">
249 <title>Installation of VLC</title>
250
251 <para>
252 First, add corrections for problems of taglib-2.0 and ffmpeg-7 and later:
253 </para>
254
255<screen><userinput>patch -Np1 -i ../vlc-&vlc-version;-taglib-1.patch &amp;&amp;
256patch -Np1 -i ../vlc-&vlc-version;-fedora_ffmpeg7-1.patch</userinput></screen>
257
258 <para>
259 If you wish to add support for lua extensions, enforce the use of <application>lua52</application>:
260 </para>
261
262<screen><userinput>export LUAC=/usr/bin/luac5.2 &amp;&amp;
263export LUA_LIBS="$(pkg-config --libs lua52)" &amp;&amp;
264export CPPFLAGS="$(pkg-config --cflags lua52)"</userinput></screen>
265
266 <para>
267 Install <application>VLC</application> by running the following commands:
268 </para>
269
270<screen><userinput>BUILDCC=gcc ./configure --prefix=/usr --disable-libplacebo &amp;&amp;
271make</userinput></screen>
272
273 <para>
274 To test the results, issue: <command>make check</command>.
275 </para>
276
277 <para>
278 Now, as the <systemitem class="username">root</systemitem> user:
279 </para>
280
281<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
282
283 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
284 href="../../xincludes/update-icons-and-desktop.xml"/>
285
286 </sect2>
287
288 <sect2 role="commands">
289 <title>Command Explanations</title>
290
291 <para>
292 <parameter>--disable-libplacebo</parameter>: This switch is required to
293 disable support for using libplacebo as a rendering pipeline because VLC
294 is incompatible with the latest version of libplacebo.
295 </para>
296
297 <para>
298 <option>--disable-vpx</option>: Use this switch to disable
299 <application>libvpx</application>.
300 </para>
301
302 <!--<para>
303 <option>- -disable-lua</option>: Use this switch if you don't have
304 <application>Lua</application> installed.
305 </para>-->
306
307 <para>
308 <option>--disable-mad</option>: Use this switch if you don't
309 have <application>libmad</application> installed.
310 </para>
311
312 <para>
313 <option>--disable-avcodec --disable-swscale</option>: Use these switches
314 if you don't have <application>FFmpeg</application> installed.
315 </para>
316
317 <para>
318 <option>--disable-a52</option>: Use this switch if you don't have
319 <application>liba52</application> installed.
320 </para>
321
322 <para>
323 <option>--disable-xcb</option>: Use this switch if you don't have
324 <application>X Window System</application> installed.
325 </para>
326
327 <para>
328 <option>--disable-alsa</option>: Use this switch if you don't have
329 <application>ALSA</application> installed.
330 </para>
331
332 <para>
333 <option>--disable-libgcrypt</option>: Use this switch if you don't
334 have <application>libgcrypt</application> installed.
335 </para>
336
337 <para>
338 <option>--disable-sftp</option>: The default is to build the sftp
339 module if <xref linkend="libssh2"/> is installed. Use this switch
340 if you do not want to build this module.
341 </para>
342
343 <note>
344 <para>
345 There are many options to <application>VLC</application>'s
346 <command>configure</command> command. Check the
347 <command>configure --help</command> output for a complete list.
348 </para>
349 </note>
350
351 </sect2>
352
353 <sect2 role="content">
354 <title>Contents</title>
355
356 <segmentedlist>
357 <segtitle>Installed Programs</segtitle>
358 <segtitle>Installed Libraries</segtitle>
359 <segtitle>Installed Directories</segtitle>
360
361 <seglistitem>
362 <seg>
363 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
364 </seg>
365 <seg>
366 libvlccore.so, libvlc.so, and many plugins in
367 /usr/lib/vlc/plugins
368 </seg>
369 <seg>
370 /usr/{include,lib,share}/vlc,
371 /usr/share/kde4, and
372 /usr/share/doc/vlc-&vlc-version;
373 </seg>
374 </seglistitem>
375 </segmentedlist>
376
377 <variablelist>
378 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
379 <?dbfo list-presentation="list"?>
380 <?dbhtml list-presentation="table"?>
381
382 <varlistentry id="cvlc">
383 <term><command>cvlc</command></term>
384 <listitem>
385 <para>
386 is a script to run VLC with the dummy interface
387 </para>
388 <indexterm zone="vlc cvlc">
389 <primary sortas="b-cvlc">cvlc</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="nvlc">
395 <term><command>nvlc</command></term>
396 <listitem>
397 <para>
398 is a script to run VLC with the ncurses interface
399 </para>
400 <indexterm zone="vlc nvlc">
401 <primary sortas="b-nvlc">nvlc</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="qvlc">
407 <term><command>qvlc</command></term>
408 <listitem>
409 <para>
410 is a script to run <application>VLC</application> with the
411 <application>Qt</application> interface
412 </para>
413 <indexterm zone="vlc qvlc">
414 <primary sortas="b-qvlc">qvlc</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="rvlc">
420 <term><command>rvlc</command></term>
421 <listitem>
422 <para>
423 is a script to run <application>VLC</application> with a command
424 line interface
425 </para>
426 <indexterm zone="vlc rvlc">
427 <primary sortas="b-rvlc">rvlc</primary>
428 </indexterm>
429 </listitem>
430 </varlistentry>
431
432 <varlistentry id="svlc">
433 <term><command>svlc</command></term>
434 <listitem>
435 <para>
436 is a script to run <application>VLC</application> with the skins
437 interface
438 </para>
439 <indexterm zone="vlc svlc">
440 <primary sortas="b-svlc">svlc</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="vlc-prog">
446 <term><command>vlc</command></term>
447 <listitem>
448 <para>
449 is the <application>VLC</application> media player
450 </para>
451 <indexterm zone="vlc vlc-prog">
452 <primary sortas="b-vlc">vlc</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="vlc-wrapper">
458 <term><command>vlc-wrapper</command></term>
459 <listitem>
460 <para>
461 is a wrapper to drop privileges with <application>VLC</application>
462 </para>
463 <indexterm zone="vlc vlc-wrapper">
464 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
465 </indexterm>
466 </listitem>
467 </varlistentry>
468
469 </variablelist>
470
471 </sect2>
472
473</sect1>
Note: See TracBrowser for help on using the repository browser.