source: multimedia/videoutils/vlc.xml@ f6d40b7d

10.0 10.1 11.0 11.1 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since f6d40b7d was f6d40b7d, checked in by Fernando de Oliveira <fernando@…>, 7 years ago
  • liblinear-210: typo and minor "gqap".
  • Update to openldap-2.4.44.
  • Update to libwnck-3.14.1.
  • Update to cups-2.1.3.
  • v4l-utils-1.10.0: typo.
  • Update to vlc-2.2.2.

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

  • Property mode set to 100644
File size: 16.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-download-ftp "ftp://ftp.videolan.org/pub/videolan/vlc/&vlc-version;/vlc-&vlc-version;.tar.xz">-->
10 <!ENTITY vlc-md5sum "f98d60f0f59ef72b6e3407f2ff09bda6">
11 <!ENTITY vlc-size "22 MB">
12 <!ENTITY vlc-buildsize "679 MB (with tests)">
13 <!ENTITY vlc-time "4.4 SBU (with tests)">
14]>
15
16<sect1 id="vlc" xreflabel="VLC-&vlc-version;">
17 <?dbhtml filename="vlc.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>VLC-&vlc-version;</title>
25
26 <indexterm zone="vlc">
27 <primary sortas="a-VLC">VLC</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to VLC</title>
32
33 <para>
34 <application>VLC</application> is a media player, streamer, and encoder.
35 It can play from many inputs, such as files, network streams, capture
36 devices, desktops, or DVD, SVCD, VCD, and audio CD. It can use most audio
37 and video codecs (MPEG 1/2/4, H264, VC-1, DivX, WMV, Vorbis, AC3, AAC,
38 etc.), and it can also convert to different formats and/or send streams
39 through the network.
40 </para>
41
42 &lfs78_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&vlc-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&vlc-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &vlc-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &vlc-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &vlc-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &vlc-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">VLC Dependencies</bridgehead>
79
80 <bridgehead renderas="sect4">Recommended</bridgehead>
81 <para role="recommended">
82 <xref linkend="alsa-lib"/>,
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 </para>
95
96 <bridgehead renderas="sect4">Optional input plugins</bridgehead>
97 <para role="optional">
98
99 <xref linkend="libdv"/>,
100 <xref linkend="libdvdcss"/>,
101 <xref linkend="libdvdread"/>,
102 <xref linkend="libdvdnav"/>,
103 <xref linkend="opencv"/>,
104 <xref linkend="samba"/>,
105 <xref linkend="v4l-utils"/>,
106 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
107 <ulink url="http://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
108 <ulink url="http://sourceforge.net/projects/libcddb/">libcddb</ulink>,
109 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>,
110 <ulink url="http://www.live555.com/">Live555</ulink>, and
111 <ulink url="http://www.gnu.org/software/vcdimager/">VCDImager</ulink>
112 (requires <xref linkend="libcdio"/>)
113 </para>
114
115 <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
116 <para role="optional">
117 <xref linkend="libogg"/>,
118 <ulink url="https://github.com/kode54/Game_Music_Emu">Game Music Emu</ulink>,
119 <ulink url="http://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</ulink>,
120 <ulink url="http://downloads.xiph.org/releases/libshout/">libshout</ulink>,
121 <ulink url="http://dl.matroska.org/downloads/libmatroska/">libmatroska</ulink>
122 (requires <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
123 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
124 <ulink url="http://www.musepack.net/">Musepack</ulink>, and
125 <ulink url="http://sourceforge.net/projects/sidplay2/">sidplay-libs</ulink>
126 </para>
127
128 <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
129 <para role="optional">
130 <xref linkend="faad2"/>,
131 <xref linkend="flac"/>,
132 <xref linkend="libass"/>,
133 <xref linkend="libmpeg2"/>,
134 <xref linkend="libpng"/>,
135 <xref linkend="libtheora"/>,
136 <xref linkend="libva"/>,
137 <xref linkend="libvorbis"/>,
138 <xref linkend="opus"/>,
139 <xref linkend="speex"/>,
140 <xref linkend="x264"/>,
141 <ulink url="http://sourceforge.net/projects/dirac/">Dirac</ulink>,
142 <ulink url="http://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
143 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
144 <ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
145 <!--<ulink url="http://code.google.com/p/libtiger/">libtiger</ulink>,-->
146 <ulink url="http://www.khronos.org/openmax/">OpenMAX</ulink>,
147 <ulink url="http://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
148 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>,
149 <ulink url="http://www.twolame.org/">Twolame</ulink>, and
150 <ulink url="http://sourceforge.net/projects/zapping/">Zapping VBI</ulink>
151 </para>
152
153 <bridgehead renderas="sect4">Optional video plugins</bridgehead>
154 <para role="optional">
155 <xref linkend="aalib"/>,
156 <xref linkend="fontconfig"/>,
157 <xref linkend="freetype2"/>,
158 <xref linkend="fribidi"/>,
159 <xref linkend="librsvg"/>,
160 <xref linkend="libvdpau"/>,
161 <xref linkend="sdl"/>
162 (with <ulink url="http://www.libsdl.org/projects/SDL_image/">SDL_image</ulink>), and
163 <ulink url="http://caca.zoy.org/">libcaca</ulink>
164 </para>
165
166 <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
167 <para role="optional">
168 <xref linkend="pulseaudio"/>,
169 <xref linkend="libsamplerate"/>, and
170 <ulink url="http://jackaudio.org/">JACK</ulink>
171 </para>
172
173 <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
174 <para role="optional">
175 <xref linkend="qt4"/> (required for the graphical user interface),
176 <xref linkend="qt5"/> (for some plugins, but currently broken with
177 Qt-5.5),
178 <ulink url="http://pkgbuild.com/~giovanni/libtar/">libtar</ulink>, and
179 <ulink url="http://www.lirc.org/">LIRC</ulink>
180 <!--<ulink url="http://www.feep.net/libtar/">libtar</ulink>-->
181 </para>
182
183 <bridgehead renderas="sect4">Optional visualisations and video filter plugins</bridgehead>
184 <para role="optional">
185 <ulink url="http://sourceforge.net/projects/goom/">Goom</ulink> and
186 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
187 </para>
188
189 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
190 <para role="optional">
191 <xref linkend="avahi"/>,
192 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
193 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
194 </para>
195
196 <bridgehead renderas="sect4">Miscellaneous options</bridgehead>
197 <para role="optional">
198 <xref linkend="gnutls"/>,
199 <xref linkend="libnotify"/>,
200 <xref linkend="libxml2"/>,
201 <xref linkend="taglib"/>, and
202 <xref linkend="xdg-utils"/> (runtime)
203 </para>
204
205 <para condition="html" role="usernotes">
206 User Notes: <ulink url="&blfs-wiki;/vlc"/>
207 </para>
208 </sect2>
209
210 <sect2 role="installation">
211 <title>Installation of VLC</title>
212
213 <para>
214 If both Qt4 and Qt5 are installed, Qt5 has to be hidden from
215 <envar>PKG_CONFIG_PATH</envar>, due to a bug. Temporarily do it, issuing:
216 </para>
217
218<screen><userinput>SAVEPATH=$PKG_CONFIG_PATH &amp;&amp;
219PKG_CONFIG_PATH="\
220`echo $PKG_CONFIG_PATH | sed 's@:/opt/qt5/lib/pkgconfig@@'`"</userinput></screen>
221
222 <para>
223 Install <application>VLC</application> by running the following commands:
224 </para>
225
226<screen><userinput>sed -e 's:libsmbclient.h:samba-4.0/&amp;:' \
227 -i modules/access/smb.c &amp;&amp;
228
229sed -e '/LUA_C/ i #define LUA_COMPAT_APIINTCASTS' \
230 -i modules/lua/vlc.h &amp;&amp;
231
232sed -e '/core.h/ {
233 a #include &lt;opencv2/imgproc/imgproc_c.h&gt;
234 a #include &lt;opencv2/imgproc/imgproc.hpp&gt;
235 }' \
236 -i modules/video_filter/opencv_example.cpp &amp;&amp;
237
238./bootstrap &amp;&amp;
239
240OPENCV_LIBS="-L/usr/share/OpenCV" \
241./configure --prefix=/usr &amp;&amp;
242
243sed -e '/seems to be moved/s/^/#/' \
244 -i autotools/ltmain.sh libtool &amp;&amp;
245
246make</userinput></screen>
247
248 <para>
249 Again, if both Qt4 and 5 are installed, restore
250 <envar>PKG_CONFIG_PATH</envar>:
251 </para>
252
253<screen><userinput>PKG_CONFIG_PATH=$SAVEPATH &amp;&amp;
254unset SAVEPATH</userinput></screen>
255
256 <para>
257 To test the results, issue: <command>make -k check</command>. Tests must be
258 run from an active X session. One test fails for unknown reasons.
259 </para>
260
261 <para>
262 Now, as the <systemitem class="username">root</systemitem> user:
263 </para>
264
265 <note>
266 <para>
267 If the XORG_PREFIX is not /usr, make sure the LIBRARY_PATH
268 environment variable is set properly when doing the install, For example:
269 <command>sudo make LIBRARY_PATH=$XORG_PREFIX/lib ... install</command>.
270 </para>
271 </note>
272
273<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
274
275 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
276 href="../../xincludes/update-icons-and-desktop.xml"/>
277
278 </sect2>
279
280 <sect2 role="commands">
281 <title>Command Explanations</title>
282
283 <para>
284 <command>sed -i ...</command>: This sed fixes compilation with
285 <application>Samba</application> 4.
286 </para>
287
288 <para>
289 <command>sed -e ... -i modules/lua/vlc.h</command> This sed fixes
290 compilation with <application>lua</application> 5.3.
291 </para>
292
293 <para>
294 <command>sed -e ... -i modules/video_filter/opencv_example.cpp</command>
295 This sed partially fixes compilation with
296 <application>OpenCV</application> 3.
297 </para>
298
299 <para>
300 <envar>OPENCV_LIBS="-L/usr/share/OpenCV"</envar> This environment variable
301 helps the linker to find <filename>libippicv.a</filename> installed by
302 <application>OpenCV</application> 3.
303 </para>
304
305 <para>
306 <command>./bootstrap</command>: This command calls autoreconf to generate
307 m4 macros and prepare Makefiles.
308 </para>
309
310 <para>
311 <command>sed -e ... -i.orig autotools/ltmain.sh libtool</command>: This
312 optional sed removes a lot of invalid build warnings.
313 If desired, remove it.
314 </para>
315
316 <para>
317 <option>--enable-opencv=no</option>: This switch disables
318 <application>OpenCV</application> suport.
319 </para>
320
321 <para>
322 <option>--disable-lua</option>: Use this switch if you don't have
323 <application>Lua</application> installed.
324 </para>
325
326 <para>
327 <option>--disable-mad</option>: Use this switch if you don't
328 have <application>libmad</application> installed.
329 </para>
330
331 <para>
332 <option>--disable-avcodec --disable-swscale</option>: Use these switches
333 if you don't have <application>FFmpeg</application> installed.
334 </para>
335
336 <para>
337 <option>--disable-a52</option>: Use this switch if you don't have
338 <application>liba52</application> installed.
339 </para>
340
341 <para>
342 <option>--disable-xcb</option>: Use this switch if you don't have
343 <application>X Window System</application> installed.
344 </para>
345
346 <para>
347 <option>--disable-alsa</option>: Use this switch if you don't have
348 <application>ALSA</application> installed.
349 </para>
350
351 <para>
352 <option>--disable-libgcrypt</option>: Use this switch if you don't
353 have <application>libgcrypt</application> installed.
354 </para>
355
356<!--
357 <para>
358 <option>- -enable-shine</option>: Use this option if you wish to build the
359 <application>Shine</application> plugin.
360 </para>
361
362 <para>
363 <option>- -enable-tremor</option>: Use this option if you have
364 <application>Tremor</application> installed and wish to build the
365 <application>Tremor</application> plugin.
366 </para>
367
368 <para>
369 <option>- -enable-aa</option>: Use this option if you have
370 <application>AAlib</application> installed and wish to build the
371 <application>AAlib</application> plugin.
372 </para>
373-->
374
375 <note>
376 <para>
377 There are many options to <application>VLC</application>'s
378 <command>configure</command> command. Check the
379 <command>configure --help</command> output for a complete list.
380 </para>
381 </note>
382
383 </sect2>
384
385 <sect2 role="content">
386 <title>Contents</title>
387
388 <segmentedlist>
389 <segtitle>Installed Programs</segtitle>
390 <segtitle>Installed Libraries</segtitle>
391 <segtitle>Installed Directories</segtitle>
392
393 <seglistitem>
394 <seg>
395 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
396 </seg>
397 <seg>
398 libvlccore.so, libvlc.so and several plugins in
399 /usr/lib/vlc/plugins
400 </seg>
401 <seg>
402 /usr/{include,lib,share}/vlc and
403 /usr/share/doc/vlc-&vlc-version;
404 </seg>
405 </seglistitem>
406 </segmentedlist>
407
408 <variablelist>
409 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
410 <?dbfo list-presentation="list"?>
411 <?dbhtml list-presentation="table"?>
412
413 <varlistentry id="cvlc">
414 <term><command>cvlc</command></term>
415 <listitem>
416 <para>
417 is a script to run VLC with the dummy interface.
418 </para>
419 <indexterm zone="vlc cvlc">
420 <primary sortas="b-cvlc">cvlc</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="nvlc">
426 <term><command>nvlc</command></term>
427 <listitem>
428 <para>
429 is a script to run VLC with the ncurses interface.
430 </para>
431 <indexterm zone="vlc nvlc">
432 <primary sortas="b-nvlc">nvlc</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 <varlistentry id="qvlc">
438 <term><command>qvlc</command></term>
439 <listitem>
440 <para>
441 is a script to run <application>VLC</application> with the
442 <application>Qt</application> interface.
443 </para>
444 <indexterm zone="vlc qvlc">
445 <primary sortas="b-qvlc">qvlc</primary>
446 </indexterm>
447 </listitem>
448 </varlistentry>
449
450 <varlistentry id="rvlc">
451 <term><command>rvlc</command></term>
452 <listitem>
453 <para>
454 is a script to run <application>VLC</application> with a command
455 line interface.
456 </para>
457 <indexterm zone="vlc rvlc">
458 <primary sortas="b-rvlc">rvlc</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 <varlistentry id="svlc">
464 <term><command>svlc</command></term>
465 <listitem>
466 <para>
467 is a script to run <application>VLC</application> with the skins
468 interface.
469 </para>
470 <indexterm zone="vlc svlc">
471 <primary sortas="b-svlc">svlc</primary>
472 </indexterm>
473 </listitem>
474 </varlistentry>
475
476 <varlistentry id="vlc-prog">
477 <term><command>vlc</command></term>
478 <listitem>
479 <para>
480 is the <application>VLC</application> media player.
481 </para>
482 <indexterm zone="vlc vlc-prog">
483 <primary sortas="b-vlc">vlc</primary>
484 </indexterm>
485 </listitem>
486 </varlistentry>
487
488 <varlistentry id="vlc-wrapper">
489 <term><command>vlc-wrapper</command></term>
490 <listitem>
491 <para>
492 is a wrapper to drop privileges with <application>VLC</application>.
493 </para>
494 <indexterm zone="vlc vlc-wrapper">
495 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
496 </indexterm>
497 </listitem>
498 </varlistentry>
499
500 </variablelist>
501
502 </sect2>
503
504</sect1>
Note: See TracBrowser for help on using the repository browser.