source: multimedia/videoutils/vlc.xml@ b5e1815e

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 b5e1815e was b5e1815e, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to talloc-2.1.8.
Update to nano-2.6.2.
Update to tcl/tk-8.6.6.

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