source: multimedia/videoutils/vlc.xml@ ae5a7024

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.9 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 ae5a7024 was ae5a7024, checked in by Fernando de Oliveira <fernando@…>, 8 years ago
  • Lua-5.3.2 and VLC-2.2.2 need to be compiled with Lua compat 5.1

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16972 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 16.6 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 If you wish to avoid thousands of annoying warnings, issue:
224 </para>
225
226<screen><userinput>sed -i 's/ifndef __FAST_MATH__/if 0/g' configure.ac</userinput></screen>
227
228 <para>
229 Install <application>VLC</application> by running the following commands:
230 </para>
231
232<screen><userinput>sed -e 's:libsmbclient.h:samba-4.0/&amp;:' \
233 -i modules/access/smb.c &amp;&amp;
234
235sed -e '/LUA_C/ i #define LUA_COMPAT_APIINTCASTS' \
236 -i modules/lua/vlc.h &amp;&amp;
237
238sed -e '/core.h/ {
239 a #include &lt;opencv2/imgproc/imgproc_c.h&gt;
240 a #include &lt;opencv2/imgproc/imgproc.hpp&gt;
241 }' \
242 -i modules/video_filter/opencv_example.cpp &amp;&amp;
243
244./bootstrap &amp;&amp;
245
246OPENCV_LIBS="-L/usr/share/OpenCV" \
247./configure --prefix=/usr &amp;&amp;
248
249sed -e '/seems to be moved/s/^/#/' \
250 -i autotools/ltmain.sh libtool &amp;&amp;</userinput></screen>
251
252 <para>
253 In order to build with Lua 5.1 compatiblity, issue:
254 </para>
255
256<screen><userinput>CFLAGS='-fPIC -O2 -Wall -Wextra -DLUA_COMPAT_5_1' make </userinput></screen>
257
258 <para>
259 Again, if both Qt4 and 5 are installed, restore
260 <envar>PKG_CONFIG_PATH</envar>:
261 </para>
262
263<screen><userinput>PKG_CONFIG_PATH=$SAVEPATH &amp;&amp;
264unset SAVEPATH</userinput></screen>
265
266 <para>
267 To test the results, issue: <command>make -k check</command>. Tests must be
268 run from an active X session. One test fails for unknown reasons.
269 </para>
270
271 <para>
272 Now, as the <systemitem class="username">root</systemitem> user:
273 </para>
274
275 <note>
276 <para>
277 If the XORG_PREFIX is not /usr, make sure the LIBRARY_PATH
278 environment variable is set properly when doing the install, For example:
279 <command>sudo make LIBRARY_PATH=$XORG_PREFIX/lib ... install</command>.
280 </para>
281 </note>
282
283<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
284
285 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
286 href="../../xincludes/update-icons-and-desktop.xml"/>
287
288 </sect2>
289
290 <sect2 role="commands">
291 <title>Command Explanations</title>
292
293 <para>
294 <command>sed -i ...</command>: This sed fixes compilation with
295 <application>Samba</application> 4.
296 </para>
297
298 <para>
299 <command>sed -e ... -i modules/lua/vlc.h</command> This sed fixes
300 compilation with <application>lua</application> 5.3.
301 </para>
302
303 <para>
304 <command>sed -e ... -i modules/video_filter/opencv_example.cpp</command>
305 This sed partially fixes compilation with
306 <application>OpenCV</application> 3.
307 </para>
308
309 <para>
310 <envar>OPENCV_LIBS="-L/usr/share/OpenCV"</envar> This environment variable
311 helps the linker to find <filename>libippicv.a</filename> installed by
312 <application>OpenCV</application> 3.
313 </para>
314
315 <para>
316 <command>./bootstrap</command>: This command calls autoreconf to generate
317 m4 macros and prepare Makefiles.
318 </para>
319
320 <para>
321 <command>sed -e ... -i.orig autotools/ltmain.sh libtool</command>: This
322 optional sed removes a lot of invalid build warnings.
323 If desired, remove it.
324 </para>
325
326 <para>
327 <option>--enable-opencv=no</option>: This switch disables
328 <application>OpenCV</application> suport.
329 </para>
330
331 <para>
332 <option>--disable-lua</option>: Use this switch if you don't have
333 <application>Lua</application> installed.
334 </para>
335
336 <para>
337 <option>--disable-mad</option>: Use this switch if you don't
338 have <application>libmad</application> installed.
339 </para>
340
341 <para>
342 <option>--disable-avcodec --disable-swscale</option>: Use these switches
343 if you don't have <application>FFmpeg</application> installed.
344 </para>
345
346 <para>
347 <option>--disable-a52</option>: Use this switch if you don't have
348 <application>liba52</application> installed.
349 </para>
350
351 <para>
352 <option>--disable-xcb</option>: Use this switch if you don't have
353 <application>X Window System</application> installed.
354 </para>
355
356 <para>
357 <option>--disable-alsa</option>: Use this switch if you don't have
358 <application>ALSA</application> installed.
359 </para>
360
361 <para>
362 <option>--disable-libgcrypt</option>: Use this switch if you don't
363 have <application>libgcrypt</application> installed.
364 </para>
365
366<!--
367 <para>
368 <option>- -enable-shine</option>: Use this option if you wish to build the
369 <application>Shine</application> plugin.
370 </para>
371
372 <para>
373 <option>- -enable-tremor</option>: Use this option if you have
374 <application>Tremor</application> installed and wish to build the
375 <application>Tremor</application> plugin.
376 </para>
377
378 <para>
379 <option>- -enable-aa</option>: Use this option if you have
380 <application>AAlib</application> installed and wish to build the
381 <application>AAlib</application> plugin.
382 </para>
383-->
384
385 <note>
386 <para>
387 There are many options to <application>VLC</application>'s
388 <command>configure</command> command. Check the
389 <command>configure --help</command> output for a complete list.
390 </para>
391 </note>
392
393 </sect2>
394
395 <sect2 role="content">
396 <title>Contents</title>
397
398 <segmentedlist>
399 <segtitle>Installed Programs</segtitle>
400 <segtitle>Installed Libraries</segtitle>
401 <segtitle>Installed Directories</segtitle>
402
403 <seglistitem>
404 <seg>
405 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
406 </seg>
407 <seg>
408 libvlccore.so, libvlc.so and several plugins in
409 /usr/lib/vlc/plugins
410 </seg>
411 <seg>
412 /usr/{include,lib,share}/vlc and
413 /usr/share/doc/vlc-&vlc-version;
414 </seg>
415 </seglistitem>
416 </segmentedlist>
417
418 <variablelist>
419 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
420 <?dbfo list-presentation="list"?>
421 <?dbhtml list-presentation="table"?>
422
423 <varlistentry id="cvlc">
424 <term><command>cvlc</command></term>
425 <listitem>
426 <para>
427 is a script to run VLC with the dummy interface.
428 </para>
429 <indexterm zone="vlc cvlc">
430 <primary sortas="b-cvlc">cvlc</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
435 <varlistentry id="nvlc">
436 <term><command>nvlc</command></term>
437 <listitem>
438 <para>
439 is a script to run VLC with the ncurses interface.
440 </para>
441 <indexterm zone="vlc nvlc">
442 <primary sortas="b-nvlc">nvlc</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="qvlc">
448 <term><command>qvlc</command></term>
449 <listitem>
450 <para>
451 is a script to run <application>VLC</application> with the
452 <application>Qt</application> interface.
453 </para>
454 <indexterm zone="vlc qvlc">
455 <primary sortas="b-qvlc">qvlc</primary>
456 </indexterm>
457 </listitem>
458 </varlistentry>
459
460 <varlistentry id="rvlc">
461 <term><command>rvlc</command></term>
462 <listitem>
463 <para>
464 is a script to run <application>VLC</application> with a command
465 line interface.
466 </para>
467 <indexterm zone="vlc rvlc">
468 <primary sortas="b-rvlc">rvlc</primary>
469 </indexterm>
470 </listitem>
471 </varlistentry>
472
473 <varlistentry id="svlc">
474 <term><command>svlc</command></term>
475 <listitem>
476 <para>
477 is a script to run <application>VLC</application> with the skins
478 interface.
479 </para>
480 <indexterm zone="vlc svlc">
481 <primary sortas="b-svlc">svlc</primary>
482 </indexterm>
483 </listitem>
484 </varlistentry>
485
486 <varlistentry id="vlc-prog">
487 <term><command>vlc</command></term>
488 <listitem>
489 <para>
490 is the <application>VLC</application> media player.
491 </para>
492 <indexterm zone="vlc vlc-prog">
493 <primary sortas="b-vlc">vlc</primary>
494 </indexterm>
495 </listitem>
496 </varlistentry>
497
498 <varlistentry id="vlc-wrapper">
499 <term><command>vlc-wrapper</command></term>
500 <listitem>
501 <para>
502 is a wrapper to drop privileges with <application>VLC</application>.
503 </para>
504 <indexterm zone="vlc vlc-wrapper">
505 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
506 </indexterm>
507 </listitem>
508 </varlistentry>
509
510 </variablelist>
511
512 </sect2>
513
514</sect1>
Note: See TracBrowser for help on using the repository browser.