source: multimedia/videoutils/vlc.xml@ 8ee0429

systemd-13485
Last change on this file since 8ee0429 was 1ef4048, checked in by Douglas R. Reno <renodr@…>, 8 years ago

Updated to Qt-5.6.0 (merged from trunk... not tested yet)
Added qtwebkit5 page from trunk
Force gst-plugins-base to use Qt5
Added qt5 as a dependency for gst-plugins-bad
Forced wpa_supplicant to use Qt5
Removed the Qt4 dependency from NetworkManager
Forced VLC to use Qt5
Archived qtchooser
Archived Amarok (will probably be readded when an official Qt5/KF5 ready release is provided)
Archived k3b (will probably be readded whan an official Qt5/KF5 ready release is made)
Dependency changes to Qt5

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