source: multimedia/videoutils/vlc.xml@ 28fb6fd

10.0 10.1 11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 28fb6fd was 28fb6fd, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Update to libqmi-1.24.10
Update to cbindgen-0.14.1
Update to vlc-3.0.9.2
Update pdfbox and fontbox in fop

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22990 af4574ff-66df-0310-9fd7-8a98e5e911e0

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