source: multimedia/videoutils/vlc.xml@ d45a8367

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 d45a8367 was d45a8367, checked in by Fernando de Oliveira <fernando@…>, 7 years ago
  • VLC-2.2.1: fixes to build with opencv-3.1.0.
  • Update to nettle-3.2.
  • Update to openssl-1.0.2f.
  • Update to stunnel-5.30.
  • Traceroute-2.0.21, Time-1.7 and UnZip-6.0: s/Less/less/ in repective time ENTITYs (SBU).
  • Update to mdadm-3.4 (tests not run).
  • Update to gtk+-3.18.7 (gtk+3.18.7).
  • Update to vte-0.42.3.
  • Update to gnome-calculator-3.18.3.

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

  • Property mode set to 100644
File size: 15.7 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 "42273945758b521c408fabc7fd6d9946">
11 <!ENTITY vlc-size "20 MB">
12 <!ENTITY vlc-buildsize "697 MB">
13 <!ENTITY vlc-time "4.5 SBU">
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="http://code.google.com/p/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="http://code.google.com/p/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://diracvideo.org/download/dirac-research/">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://diracvideo.org/download/schroedinger/">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),
177 <ulink url="http://pkgbuild.com/~giovanni/libtar/">libtar</ulink>, and
178 <ulink url="http://www.lirc.org/">LIRC</ulink>
179 <!--<ulink url="http://www.feep.net/libtar/">libtar</ulink>-->
180 </para>
181
182 <bridgehead renderas="sect4">Optional visualisations and video filter plugins</bridgehead>
183 <para role="optional">
184 <ulink url="http://sourceforge.net/projects/goom/">Goom</ulink> and
185 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
186 </para>
187
188 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
189 <para role="optional">
190 <xref linkend="avahi"/>,
191 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
192 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
193 </para>
194
195 <bridgehead renderas="sect4">Miscellaneous options</bridgehead>
196 <para role="optional">
197 <xref linkend="gnutls"/>,
198 <xref linkend="libnotify"/>,
199 <xref linkend="libxml2"/>,
200 <xref linkend="taglib"/>, and
201 <xref linkend="xdg-utils"/> (runtime)
202 </para>
203
204 <para condition="html" role="usernotes">
205 User Notes: <ulink url="&blfs-wiki;/vlc"/>
206 </para>
207 </sect2>
208
209 <sect2 role="installation">
210 <title>Installation of VLC</title>
211
212 <para>
213 Install <application>VLC</application> by running the following commands:
214 </para>
215
216<screen><userinput>sed -e 's:libsmbclient.h:samba-4.0/&amp;:' \
217 -i modules/access/smb.c &amp;&amp;
218
219sed -e '/LUA_C/ i #define LUA_COMPAT_APIINTCASTS' \
220 -i modules/lua/vlc.h &amp;&amp;
221
222sed -e '/core.h/ {
223 a #include &lt;opencv2/imgproc/imgproc_c.h&gt;
224 a #include &lt;opencv2/imgproc/imgproc.hpp&gt;
225 }' \
226 -i modules/video_filter/opencv_example.cpp &amp;&amp;
227
228./bootstrap &amp;&amp;
229
230OPENCV_LIBS="-L/usr/share/OpenCV" \
231./configure --prefix=/usr &amp;&amp;
232
233sed -e '/seems to be moved/s/^/#/' \
234 -i autotools/ltmain.sh libtool &amp;&amp;
235
236make</userinput></screen>
237
238 <para>
239 To test the results, issue: <command>make check</command>. Tests must be
240 run from an active X session.
241 </para>
242
243 <para>
244 Now, as the <systemitem class="username">root</systemitem> user:
245 </para>
246
247 <note>
248 <para>
249 If the XORG_PREFIX is not /usr, make sure the LIBRARY_PATH
250 environment variable is set properly when doing the install, For example:
251 <command>sudo make LIBRARY_PATH=$XORG_PREFIX/lib ... install</command>.
252 </para>
253 </note>
254
255<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
256
257 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
258 href="../../xincludes/update-icons-and-desktop.xml"/>
259
260 </sect2>
261
262 <sect2 role="commands">
263 <title>Command Explanations</title>
264
265 <para>
266 <command>sed -i ...</command>: This sed fixes compilation with
267 <application>Samba</application> 4.
268 </para>
269
270 <para>
271 <command>sed -e ... -i modules/lua/vlc.h</command> This sed fixes
272 compilation with <application>lua</application> 5.3.
273 </para>
274
275 <para>
276 <command>sed -e ... -i modules/video_filter/opencv_example.cpp</command>
277 This sed partially fixes compilation with
278 <application>OpenCV</application> 3.
279 </para>
280
281 <para>
282 <envar>OPENCV_LIBS="-L/usr/share/OpenCV"</envar> This environment variable
283 helps the linker to find <filename>libippicv.a</filename> installed by
284 <application>OpenCV</application> 3.
285 </para>
286
287 <para>
288 <command>./bootstrap</command>: This command calls autoreconf to generate
289 m4 macros and prepare Makefiles.
290 </para>
291
292 <para>
293 <command>sed -e ... -i.orig autotools/ltmain.sh libtool</command>: This
294 optional sed removes a lot of invalid build warnings.
295 If desired, remove it.
296 </para>
297
298 <para>
299 <option>--enable-opencv=no</option>: This switch disables
300 <application>OpenCV</application> suport.
301 </para>
302
303 <para>
304 <option>--disable-lua</option>: Use this switch if you don't have
305 <application>Lua</application> installed.
306 </para>
307
308 <para>
309 <option>--disable-mad</option>: Use this switch if you don't
310 have <application>libmad</application> installed.
311 </para>
312
313 <para>
314 <option>--disable-avcodec --disable-swscale</option>: Use these switches
315 if you don't have <application>FFmpeg</application> installed.
316 </para>
317
318 <para>
319 <option>--disable-a52</option>: Use this switch if you don't have
320 <application>liba52</application> installed.
321 </para>
322
323 <para>
324 <option>--disable-xcb</option>: Use this switch if you don't have
325 <application>X Window System</application> installed.
326 </para>
327
328 <para>
329 <option>--disable-alsa</option>: Use this switch if you don't have
330 <application>ALSA</application> installed.
331 </para>
332
333 <para>
334 <option>--disable-libgcrypt</option>: Use this switch if you don't
335 have <application>libgcrypt</application> installed.
336 </para>
337
338<!--
339 <para>
340 <option>- -enable-shine</option>: Use this option if you wish to build the
341 <application>Shine</application> plugin.
342 </para>
343
344 <para>
345 <option>- -enable-tremor</option>: Use this option if you have
346 <application>Tremor</application> installed and wish to build the
347 <application>Tremor</application> plugin.
348 </para>
349
350 <para>
351 <option>- -enable-aa</option>: Use this option if you have
352 <application>AAlib</application> installed and wish to build the
353 <application>AAlib</application> plugin.
354 </para>
355-->
356
357 <note>
358 <para>
359 There are many options to <application>VLC</application>'s
360 <command>configure</command> command. Check the
361 <command>configure --help</command> output for a complete list.
362 </para>
363 </note>
364
365 </sect2>
366
367 <sect2 role="content">
368 <title>Contents</title>
369
370 <segmentedlist>
371 <segtitle>Installed Programs</segtitle>
372 <segtitle>Installed Libraries</segtitle>
373 <segtitle>Installed Directories</segtitle>
374
375 <seglistitem>
376 <seg>
377 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
378 </seg>
379 <seg>
380 libvlccore.so, libvlc.so and several plugins in
381 /usr/lib/vlc/plugins
382 </seg>
383 <seg>
384 /usr/include/vlc,
385 /usr/lib/vlc,
386 /usr/share/vlc and
387 /usr/share/doc/vlc-&vlc-version;
388 </seg>
389 </seglistitem>
390 </segmentedlist>
391
392 <variablelist>
393 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
394 <?dbfo list-presentation="list"?>
395 <?dbhtml list-presentation="table"?>
396
397 <varlistentry id="cvlc">
398 <term><command>cvlc</command></term>
399 <listitem>
400 <para>
401 is a script to run VLC with the dummy interface.
402 </para>
403 <indexterm zone="vlc cvlc">
404 <primary sortas="b-cvlc">cvlc</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="nvlc">
410 <term><command>nvlc</command></term>
411 <listitem>
412 <para>
413 is a script to run VLC with the ncurses interface.
414 </para>
415 <indexterm zone="vlc nvlc">
416 <primary sortas="b-nvlc">nvlc</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="qvlc">
422 <term><command>qvlc</command></term>
423 <listitem>
424 <para>
425 is a script to run <application>VLC</application> with the
426 <application>Qt</application> interface.
427 </para>
428 <indexterm zone="vlc qvlc">
429 <primary sortas="b-qvlc">qvlc</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 <varlistentry id="rvlc">
435 <term><command>rvlc</command></term>
436 <listitem>
437 <para>
438 is a script to run <application>VLC</application> with a command
439 line interface.
440 </para>
441 <indexterm zone="vlc rvlc">
442 <primary sortas="b-rvlc">rvlc</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="svlc">
448 <term><command>svlc</command></term>
449 <listitem>
450 <para>
451 is a script to run <application>VLC</application> with the skins
452 interface.
453 </para>
454 <indexterm zone="vlc svlc">
455 <primary sortas="b-svlc">svlc</primary>
456 </indexterm>
457 </listitem>
458 </varlistentry>
459
460 <varlistentry id="vlc-prog">
461 <term><command>vlc</command></term>
462 <listitem>
463 <para>
464 is the <application>VLC</application> media player.
465 </para>
466 <indexterm zone="vlc vlc-prog">
467 <primary sortas="b-vlc">vlc</primary>
468 </indexterm>
469 </listitem>
470 </varlistentry>
471
472 <varlistentry id="vlc-wrapper">
473 <term><command>vlc-wrapper</command></term>
474 <listitem>
475 <para>
476 is a wrapper to drop privileges with <application>VLC</application>.
477 </para>
478 <indexterm zone="vlc vlc-wrapper">
479 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 </variablelist>
485
486 </sect2>
487
488</sect1>
Note: See TracBrowser for help on using the repository browser.