source: multimedia/videoutils/vlc.xml@ 01e86d88

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 01e86d88 was 01e86d88, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to vlc-2.2.3.
Update to iso-codes-3.68.
Update to btrfs-progs-v4.5.2.
Update List-MoreUtils perl module to version 0.415.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17329 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 15.3 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 "http://download.videolan.org/vlc/&vlc-version;/vlc-&vlc-version;.tar.xz">
8 <!ENTITY vlc-download-ftp " ">
9 <!ENTITY vlc-md5sum "ecbc65be549e5cc83e4cbe0129e66dcd">
10 <!ENTITY vlc-size "21 MB">
11 <!ENTITY vlc-buildsize "603 MB (add xx MB for tests)">
12 <!ENTITY vlc-time "4.6 SBU (add x.y 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 &lfs79_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">Additional Downloads</bridgehead>
78 <itemizedlist spacing="compact">
79 <listitem>
80 <para>
81 Required patch:
82 <ulink
83 url="&patch-root;/vlc-&vlc-version;-ffmpeg3-1.patch"/>
84 </para>
85 </listitem>
86 </itemizedlist>
87
88 <bridgehead renderas="sect3">VLC Dependencies</bridgehead>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="alsa-lib"/>,
93 <xref linkend="ffmpeg"/>,
94 <xref linkend="liba52"/>,
95 <xref linkend="libgcrypt"/>
96 <xref linkend="libmad"/>,
97 <xref linkend="lua"/>, and
98 <xref linkend="x-window-system"/>,
99 </para>
100
101 <bridgehead renderas="sect4">Optional features and packages</bridgehead>
102 <para role="optional">
103 <xref linkend="dbus"/>
104 </para>
105
106 <bridgehead renderas="sect4">Optional input plugins</bridgehead>
107 <para role="optional">
108
109 <xref linkend="libdv"/>,
110 <xref linkend="libdvdcss"/>,
111 <xref linkend="libdvdread"/>,
112 <xref linkend="libdvdnav"/>,
113 <xref linkend="opencv"/>,
114 <xref linkend="samba"/>,
115 <xref linkend="v4l-utils"/>,
116 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
117 <ulink url="http://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
118 <ulink url="http://sourceforge.net/projects/libcddb/">libcddb</ulink>,
119 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>,
120 <ulink url="http://www.live555.com/">Live555</ulink>, and
121 <ulink url="http://www.gnu.org/software/vcdimager/">VCDImager</ulink>
122 (requires <xref linkend="libcdio"/>)
123 </para>
124
125 <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
126 <para role="optional">
127 <xref linkend="libogg"/>,
128 <ulink url="https://github.com/kode54/Game_Music_Emu">Game Music Emu</ulink>,
129 <ulink url="http://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</ulink>,
130 <ulink url="http://downloads.xiph.org/releases/libshout/">libshout</ulink>,
131 <ulink url="http://dl.matroska.org/downloads/libmatroska/">libmatroska</ulink>
132 (requires <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
133 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
134 <ulink url="http://www.musepack.net/">Musepack</ulink>, and
135 <ulink url="http://sourceforge.net/projects/sidplay2/">sidplay-libs</ulink>
136 </para>
137
138 <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
139 <para role="optional">
140 <xref linkend="faad2"/>,
141 <xref linkend="flac"/>,
142 <xref linkend="libass"/>,
143 <xref linkend="libmpeg2"/>,
144 <xref linkend="libpng"/>,
145 <xref linkend="libtheora"/>,
146 <xref linkend="libva"/>,
147 <xref linkend="libvorbis"/>,
148 <xref linkend="opus"/>,
149 <xref linkend="speex"/>,
150 <xref linkend="x264"/>,
151 <ulink url="http://sourceforge.net/projects/dirac/">Dirac</ulink>,
152 <ulink url="http://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
153 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
154 <ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
155 <!--<ulink url="http://code.google.com/p/libtiger/">libtiger</ulink>,-->
156 <ulink url="http://www.khronos.org/openmax/">OpenMAX</ulink>,
157 <ulink url="http://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
158 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>,
159 <ulink url="http://www.twolame.org/">Twolame</ulink>, and
160 <ulink url="http://sourceforge.net/projects/zapping/">Zapping VBI</ulink>
161 </para>
162
163 <bridgehead renderas="sect4">Optional video plugins</bridgehead>
164 <para role="optional">
165 <xref linkend="aalib"/>,
166 <xref linkend="fontconfig"/>,
167 <xref linkend="freetype2"/>,
168 <xref linkend="fribidi"/>,
169 <xref linkend="librsvg"/>,
170 <xref linkend="libvdpau"/>,
171 <xref linkend="sdl"/>
172 (with <ulink url="http://www.libsdl.org/projects/SDL_image/">SDL_image</ulink>), and
173 <ulink url="http://caca.zoy.org/">libcaca</ulink>
174 </para>
175
176 <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
177 <para role="optional">
178 <xref linkend="pulseaudio"/>,
179 <xref linkend="libsamplerate"/>, and
180 <ulink url="http://jackaudio.org/">JACK</ulink>
181 </para>
182
183 <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
184 <para role="optional">
185 <xref linkend="qt4"/> (required for the graphical user interface),
186 <xref linkend="qt5"/> (for some plugins, but currently broken with
187 Qt-5.5),
188 <ulink url="http://pkgbuild.com/~giovanni/libtar/">libtar</ulink>, and
189 <ulink url="http://www.lirc.org/">LIRC</ulink>
190 <!--<ulink url="http://www.feep.net/libtar/">libtar</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> and
196 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
197 </para>
198
199 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
200 <para role="optional">
201 <xref linkend="avahi"/>,
202 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
203 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
204 </para>
205
206 <bridgehead renderas="sect4">Miscellaneous options</bridgehead>
207 <para role="optional">
208 <xref linkend="gnutls"/>,
209 <xref linkend="libnotify"/>,
210 <xref linkend="libxml2"/>,
211 <xref linkend="taglib"/>, and
212 <xref linkend="xdg-utils"/> (runtime)
213 </para>
214
215 <para condition="html" role="usernotes">
216 User Notes: <ulink url="&blfs-wiki;/vlc"/>
217 </para>
218 </sect2>
219
220 <sect2 role="installation">
221 <title>Installation of VLC</title>
222
223 <para>
224 If both Qt4 and Qt5 are installed, Qt5 needs to be hidden from
225 <envar>PKG_CONFIG_PATH</envar>, due to a bug. Temporarily do it by issuing:
226 </para>
227
228<screen><userinput>SAVEPATH=$PKG_CONFIG_PATH &amp;&amp;
229PKG_CONFIG_PATH="\
230`echo $PKG_CONFIG_PATH | sed 's@:/opt/qt5/lib/pkgconfig@@'`"</userinput></screen>
231
232 <para>
233 If you wish to avoid many invalid warnings, issue:
234 </para>
235
236<screen><userinput>sed -i '/seems to be moved/s/^/#/' autotools/ltmain.sh</userinput></screen>
237
238 <para>
239 Install <application>VLC</application> by running the following commands:
240 </para>
241
242<screen><userinput>patch -Np1 -i ../vlc-&vlc-version;-ffmpeg3-1.patch &amp;&amp;
243
244CXX="g++ -std=c++11" \
245CFLAGS="-DLUA_COMPAT_5_1" \
246OPENCV_LIBS="-L/usr/share/OpenCV" \
247./configure --prefix=/usr &amp;&amp;
248
249make</userinput></screen>
250
251 <para>
252 Again, if both Qt4 and 5 are installed, restore
253 <envar>PKG_CONFIG_PATH</envar>:
254 </para>
255
256<screen><userinput>PKG_CONFIG_PATH=$SAVEPATH &amp;&amp;
257unset SAVEPATH</userinput></screen>
258
259 <para>
260 To test the results, issue: <command>make -k check</command>. Tests must be
261 run from an active X session. One test fails for unknown reasons.
262 </para>
263
264 <para>
265 Now, as the <systemitem class="username">root</systemitem> user:
266 </para>
267
268 <note>
269 <para>
270 If the XORG_PREFIX is not /usr, make sure the LIBRARY_PATH
271 environment variable is set properly when doing the install, For example:
272 <command>sudo make LIBRARY_PATH=$XORG_PREFIX/lib ... install</command>.
273 </para>
274 </note>
275
276<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
277
278 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
279 href="../../xincludes/update-icons-and-desktop.xml"/>
280
281 </sect2>
282
283 <sect2 role="commands">
284 <title>Command Explanations</title>
285
286 <para>
287 <envar>CXX="g++ -std=c++11"</envar> This environment variable
288 is needed for compatibility with <xref linkend='gcc'/>.
289 </para>
290
291 <para>
292 <envar>CFLAGS="-DLUA_COMPAT_5_1"</envar> This environment variable
293 is needed for compatibilty with <xref linkend='lua'/>.
294 </para>
295
296 <para>
297 <envar>OPENCV_LIBS="-L/usr/share/OpenCV"</envar> This environment variable
298 helps the linker to find <filename>libippicv.a</filename> installed by
299 <application>OpenCV</application> 3.
300 </para>
301
302 <para>
303 <option>--enable-opencv=no</option>: This switch disables
304 <application>OpenCV</application> suport.
305 </para>
306
307 <para>
308 <option>--disable-lua</option>: Use this switch if you don't have
309 <application>Lua</application> installed.
310 </para>
311
312 <para>
313 <option>--disable-mad</option>: Use this switch if you don't
314 have <application>libmad</application> installed.
315 </para>
316
317 <para>
318 <option>--disable-avcodec --disable-swscale</option>: Use these switches
319 if you don't have <application>FFmpeg</application> installed.
320 </para>
321
322 <para>
323 <option>--disable-a52</option>: Use this switch if you don't have
324 <application>liba52</application> installed.
325 </para>
326
327 <para>
328 <option>--disable-xcb</option>: Use this switch if you don't have
329 <application>X Window System</application> installed.
330 </para>
331
332 <para>
333 <option>--disable-alsa</option>: Use this switch if you don't have
334 <application>ALSA</application> installed.
335 </para>
336
337 <para>
338 <option>--disable-libgcrypt</option>: Use this switch if you don't
339 have <application>libgcrypt</application> installed.
340 </para>
341
342 <note>
343 <para>
344 There are many options to <application>VLC</application>'s
345 <command>configure</command> command. Check the
346 <command>configure --help</command> output for a complete list.
347 </para>
348 </note>
349
350 </sect2>
351
352 <sect2 role="content">
353 <title>Contents</title>
354
355 <segmentedlist>
356 <segtitle>Installed Programs</segtitle>
357 <segtitle>Installed Libraries</segtitle>
358 <segtitle>Installed Directories</segtitle>
359
360 <seglistitem>
361 <seg>
362 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
363 </seg>
364 <seg>
365 libvlccore.so, libvlc.so, and many plugins in
366 /usr/lib/vlc/plugins
367 </seg>
368 <seg>
369 /usr/{include,lib,share}/vlc and
370 /usr/share/doc/vlc-&vlc-version;
371 </seg>
372 </seglistitem>
373 </segmentedlist>
374
375 <variablelist>
376 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
377 <?dbfo list-presentation="list"?>
378 <?dbhtml list-presentation="table"?>
379
380 <varlistentry id="cvlc">
381 <term><command>cvlc</command></term>
382 <listitem>
383 <para>
384 is a script to run VLC with the dummy interface.
385 </para>
386 <indexterm zone="vlc cvlc">
387 <primary sortas="b-cvlc">cvlc</primary>
388 </indexterm>
389 </listitem>
390 </varlistentry>
391
392 <varlistentry id="nvlc">
393 <term><command>nvlc</command></term>
394 <listitem>
395 <para>
396 is a script to run VLC with the ncurses interface.
397 </para>
398 <indexterm zone="vlc nvlc">
399 <primary sortas="b-nvlc">nvlc</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403
404 <varlistentry id="qvlc">
405 <term><command>qvlc</command></term>
406 <listitem>
407 <para>
408 is a script to run <application>VLC</application> with the
409 <application>Qt</application> interface.
410 </para>
411 <indexterm zone="vlc qvlc">
412 <primary sortas="b-qvlc">qvlc</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="rvlc">
418 <term><command>rvlc</command></term>
419 <listitem>
420 <para>
421 is a script to run <application>VLC</application> with a command
422 line interface.
423 </para>
424 <indexterm zone="vlc rvlc">
425 <primary sortas="b-rvlc">rvlc</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="svlc">
431 <term><command>svlc</command></term>
432 <listitem>
433 <para>
434 is a script to run <application>VLC</application> with the skins
435 interface.
436 </para>
437 <indexterm zone="vlc svlc">
438 <primary sortas="b-svlc">svlc</primary>
439 </indexterm>
440 </listitem>
441 </varlistentry>
442
443 <varlistentry id="vlc-prog">
444 <term><command>vlc</command></term>
445 <listitem>
446 <para>
447 is the <application>VLC</application> media player.
448 </para>
449 <indexterm zone="vlc vlc-prog">
450 <primary sortas="b-vlc">vlc</primary>
451 </indexterm>
452 </listitem>
453 </varlistentry>
454
455 <varlistentry id="vlc-wrapper">
456 <term><command>vlc-wrapper</command></term>
457 <listitem>
458 <para>
459 is a wrapper to drop privileges with <application>VLC</application>.
460 </para>
461 <indexterm zone="vlc vlc-wrapper">
462 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 </variablelist>
468
469 </sect2>
470
471</sect1>
Note: See TracBrowser for help on using the repository browser.