source: multimedia/videoutils/vlc.xml@ 7c51f58

10.0 10.1 11.0 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 7c51f58 was 7c51f58, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Lotsa tags

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

  • Property mode set to 100644
File size: 15.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 "3941b561f590cc95ca5e795213cba2f2">
11 <!ENTITY vlc-size "19 MB">
12 <!ENTITY vlc-buildsize "494 MB (additional 1 MB for the tests)">
13 <!ENTITY vlc-time "4.7 SBU (additional less than 0.1 SBU for the 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 like files, network streams, capture device,
36 desktops, or DVD, SVCD, VCD, and audio CD. It can play most audio and
37 video codecs (MPEG 1/2/4, H264, VC-1, DivX, WMV, Vorbis, AC3, AAC, etc.),
38 but can also convert to different formats and/or send streams through the
39 network.
40 </para>
41
42 &lfs77_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="samba"/>,
104 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
105 <ulink url="http://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
106 <ulink url="http://sourceforge.net/projects/libcddb/">libcddb</ulink>,
107 <ulink url="http://code.google.com/p/libproxy/">libproxy</ulink>,
108 <ulink url="http://www.live555.com/">Live555</ulink>,
109 <ulink url="http://sourceforge.net/projects/opencvlibrary/">OpenCV</ulink>,
110 <ulink url="http://linuxtv.org/downloads/v4l-utils/">Video4Linux</ulink>, and
111 <ulink url="http://www.gnu.org/software/vcdimager/">VCDImager</ulink>
112 (requires <ulink url="http://www.gnu.org/software/libcdio/">libcdio</ulink>)
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 <ulink url="http://pkgbuild.com/~giovanni/libtar/">libtar</ulink>, and
177 <ulink url="http://www.lirc.org/">LIRC</ulink>
178 <!--<ulink url="http://www.feep.net/libtar/">libtar</ulink>-->
179 </para>
180
181 <bridgehead renderas="sect4">Optional visualisations and video filter plugins</bridgehead>
182 <para role="optional">
183 <ulink url="http://sourceforge.net/projects/goom/">Goom</ulink> and
184 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
185 </para>
186
187 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
188 <para role="optional">
189 <xref linkend="avahi"/>,
190 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
191 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
192 </para>
193
194 <bridgehead renderas="sect4">Miscellaneous options</bridgehead>
195 <para role="optional">
196 <xref linkend="gnutls"/>,
197 <xref linkend="libnotify"/>,
198 <xref linkend="libxml2"/>,
199 <xref linkend="taglib"/>, and
200 <xref linkend="xdg-utils"/> (runtime)
201 </para>
202
203 <para condition="html" role="usernotes">
204 User Notes: <ulink url="&blfs-wiki;/vlc"/>
205 </para>
206 </sect2>
207
208 <sect2 role="installation">
209 <title>Installation of VLC</title>
210
211 <para>
212 Install <application>VLC</application> by running the following commands:
213 </para>
214
215<screen><userinput>sed -i 's:libsmbclient.h:samba-4.0/&amp;:' modules/access/smb.c &amp;&amp;
216./bootstrap &amp;&amp;
217
218sed "s:&lt; 56:&lt; 57:g" -i configure &amp;&amp;
219./configure --prefix=/usr &amp;&amp;
220
221sed -i 's/luaL_optint/(int)&amp;eger/' modules/lua/libs/{net,osd,volume}.c &amp;&amp;
222sed -i 's/luaL_checkint(/(int)luaL_checkinteger(/' \
223 modules/lua/{demux,libs/{configuration,net,osd,playlist,stream,variables,volume}}.c &amp;&amp;
224make</userinput></screen>
225
226 <para>
227 To test the results, issue: <command>make check</command>.
228 </para>
229
230 <para>
231 Now, as the <systemitem class="username">root</systemitem> user:
232 </para>
233
234 <note>
235 <para>
236 If the XORG_PREFIX is not /usr, make sure the LIBRARY_PATH
237 environment variable is set properly when doing the install, For example:
238 <command>sudo make LIBRARY_PATH=$XORG_PREFIX/lib ... install</command>.
239 </para>
240 </note>
241
242<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
243
244 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
245 href="../../xincludes/update-icons-and-desktop.xml"/>
246
247 </sect2>
248
249 <sect2 role="commands">
250 <title>Command Explanations</title>
251
252 <para>
253 <command>sed -i ...</command>: This sed fixes compilation with
254 <application>Samba</application> 4.
255 </para>
256
257 <para>
258 <command>./bootstrap</command>: This command calls autoreconf to generate
259 m4 macros and prepare Makefiles.
260 </para>
261
262 <para>
263 <command>sed ... configure</command>: This sed fixes compilation with
264 <application>ffmpeg</application> 2.4.
265 </para>
266
267 <para>
268 <command>sed -i ... {net,osd,volume}.c</command> This sed fixes
269 compilation with <application>lua</application> 5.3.
270 </para>
271
272 <para>
273 <command>sed -i ... variables,volume}}.c</command>: This sed fixes
274 compilation with <application>lua</application> 5.3.
275 </para>
276
277 <para>
278 <option>--disable-lua</option>: Use this switch if you don't have
279 <application>Lua</application> installed.
280 </para>
281
282 <para>
283 <option>--disable-mad</option>: Use this switch if you don't
284 have <application>libmad</application> installed.
285 </para>
286
287 <para>
288 <option>--disable-avcodec --disable-swscale</option>: Use these switches
289 if you don't have <application>FFmpeg</application> installed.
290 </para>
291
292 <para>
293 <option>--disable-a52</option>: Use this switch if you don't have
294 <application>liba52</application> installed.
295 </para>
296
297 <para>
298 <option>--disable-xcb</option>: Use this switch if you don't have
299 <application>X Window System</application> installed.
300 </para>
301
302 <para>
303 <option>--disable-alsa</option>: Use this switch if you don't have
304 <application>ALSA</application> installed.
305 </para>
306
307 <para>
308 <option>--disable-libgcrypt</option>: Use this switch if you don't
309 have <application>libgcrypt</application> installed.
310 </para>
311
312<!--
313 <para>
314 <option>- -enable-shine</option>: Use this option if you wish to build the
315 <application>Shine</application> plugin.
316 </para>
317
318 <para>
319 <option>- -enable-tremor</option>: Use this option if you have
320 <application>Tremor</application> installed and wish to build the
321 <application>Tremor</application> plugin.
322 </para>
323
324 <para>
325 <option>- -enable-aa</option>: Use this option if you have
326 <application>AAlib</application> installed and wish to build the
327 <application>AAlib</application> plugin.
328 </para>
329-->
330
331 <note>
332 <para>
333 There are many options to <application>VLC</application>'s
334 <command>configure</command> command. Check the
335 <command>configure --help</command> output for a complete list.
336 </para>
337 </note>
338
339 </sect2>
340
341 <sect2 role="content">
342 <title>Contents</title>
343
344 <segmentedlist>
345 <segtitle>Installed Programs</segtitle>
346 <segtitle>Installed Libraries</segtitle>
347 <segtitle>Installed Directories</segtitle>
348
349 <seglistitem>
350 <seg>
351 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
352 </seg>
353 <seg>
354 libvlccore.so, libvlc.so and several plugins in
355 /usr/lib/vlc/plugins
356 </seg>
357 <seg>
358 /usr/include/vlc,
359 /usr/lib/vlc,
360 /usr/share/vlc and
361 /usr/share/doc/vlc-&vlc-version;
362 </seg>
363 </seglistitem>
364 </segmentedlist>
365
366 <variablelist>
367 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
368 <?dbfo list-presentation="list"?>
369 <?dbhtml list-presentation="table"?>
370
371 <varlistentry id="cvlc">
372 <term><command>cvlc</command></term>
373 <listitem>
374 <para>
375 is a script to run VLC with the dummy interface.
376 </para>
377 <indexterm zone="vlc cvlc">
378 <primary sortas="b-cvlc">cvlc</primary>
379 </indexterm>
380 </listitem>
381 </varlistentry>
382
383 <varlistentry id="nvlc">
384 <term><command>nvlc</command></term>
385 <listitem>
386 <para>
387 is a script to run VLC with the ncurses interface.
388 </para>
389 <indexterm zone="vlc nvlc">
390 <primary sortas="b-nvlc">nvlc</primary>
391 </indexterm>
392 </listitem>
393 </varlistentry>
394
395 <varlistentry id="qvlc">
396 <term><command>qvlc</command></term>
397 <listitem>
398 <para>
399 is a script to run <application>VLC</application> with the
400 <application>Qt</application> interface.
401 </para>
402 <indexterm zone="vlc qvlc">
403 <primary sortas="b-qvlc">qvlc</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407
408 <varlistentry id="rvlc">
409 <term><command>rvlc</command></term>
410 <listitem>
411 <para>
412 is a script to run <application>VLC</application> with a command
413 line interface.
414 </para>
415 <indexterm zone="vlc rvlc">
416 <primary sortas="b-rvlc">rvlc</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="svlc">
422 <term><command>svlc</command></term>
423 <listitem>
424 <para>
425 is a script to run <application>VLC</application> with the skins
426 interface.
427 </para>
428 <indexterm zone="vlc svlc">
429 <primary sortas="b-svlc">svlc</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 <varlistentry id="vlc-prog">
435 <term><command>vlc</command></term>
436 <listitem>
437 <para>
438 is the <application>VLC</application> media player.
439 </para>
440 <indexterm zone="vlc vlc-prog">
441 <primary sortas="b-vlc">vlc</primary>
442 </indexterm>
443 </listitem>
444 </varlistentry>
445
446 <varlistentry id="vlc-wrapper">
447 <term><command>vlc-wrapper</command></term>
448 <listitem>
449 <para>
450 is a wrapper to drop privileges with <application>VLC</application>.
451 </para>
452 <indexterm zone="vlc vlc-wrapper">
453 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 </variablelist>
459
460 </sect2>
461
462</sect1>
Note: See TracBrowser for help on using the repository browser.