source: multimedia/videoutils/vlc.xml@ 03886fd

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 03886fd was 03886fd, checked in by Krejzi <krejzi@…>, 8 years ago

seriously ...

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11526 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
8 "http://download.videolan.org/pub/videolan/vlc/&vlc-version;/vlc-&vlc-version;.tar.xz">
9 <!ENTITY vlc-download-ftp
10 "ftp://ftp.videolan.org/pub/videolan/vlc/&vlc-version;/vlc-&vlc-version;.tar.xz">
11 <!ENTITY vlc-md5sum "6445eb55aa087f30abe27423535e1ab8">
12 <!ENTITY vlc-size "18 MB">
13 <!ENTITY vlc-buildsize "as much as 600 MB, but likely around 500 MB">
14 <!ENTITY vlc-time "4.0 SBU">
15]>
16
17<sect1 id="vlc" xreflabel="VLC-&vlc-version;">
18 <?dbhtml filename="vlc.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>VLC-&vlc-version;</title>
26
27 <indexterm zone="vlc">
28 <primary sortas="a-VLC">VLC</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to VLC</title>
33
34 <para>
35 <application>VLC</application> is a media player, streamer, and encoder.
36 It can play from many inputs like files, network streams, capture device,
37 desktops, or DVD, SVCD, VCD, and audio CD. It can play most audio and
38 video codecs (MPEG 1/2/4, H264, VC-1, DivX, WMV, Vorbis, AC3, AAC, etc.),
39 but can also convert to different formats and/or send streams through the
40 network.
41 </para>
42
43 &lfs73_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>
49 Download (HTTP): <ulink url="&vlc-download-http;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download (FTP): <ulink url="&vlc-download-ftp;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download MD5 sum: &vlc-md5sum;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download size: &vlc-size;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated disk space required: &vlc-buildsize;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated build time: &vlc-time;
75 </para>
76 </listitem>
77 </itemizedlist>
78
79 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
80 <itemizedlist spacing="compact">
81 <listitem>
82 <para>
83 Required patch:
84 <ulink url="&patch-root;/vlc-&vlc-version;-opencv_fixes-1.patch"/>
85 </para>
86 </listitem>
87 <listitem>
88 <para>
89 Required patch:
90 <ulink url="&patch-root;/vlc-&vlc-version;-live_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="dbus"/>,
101 <xref linkend="ffmpeg"/>,
102 <xref linkend="gnutls"/>,
103 <xref linkend="liba52"/>,
104 <xref linkend="libgcrypt"/>,
105 <xref linkend="libmad"/>,
106 <xref linkend="lua"/> and
107 <xref linkend="qt4"/> (<application>Qt</application> is required for the
108 graphical user interface; without <application>Qt</application> you will
109 only be able to use the command line or <application>ncurses</application>
110 interface)
111 </para>
112
113 <bridgehead renderas="sect4">Optional input drivers and libraries</bridgehead>
114 <para role="optional">
115 <ulink url="http://code.google.com/p/libproxy/">libproxy</ulink>,
116 <ulink url="http://www.live555.com/">Live555</ulink>,
117 <ulink url="http://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
118 <xref linkend="libdv"/>,
119 <xref linkend="libdvdread"/>,
120 <xref linkend="libdvdnav"/>,
121 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
122 <ulink url="http://opencv.willowgarage.com/wiki/">OpenCV</ulink>,
123 <xref linkend="samba"/>,
124 <ulink url="http://linuxtv.org/downloads/v4l-utils/">Video4Linux</ulink>,
125 <ulink url="http://www.gnu.org/software/vcdimager/">VCDImager</ulink>
126 (requires <ulink url="http://www.gnu.org/software/libcdio/">libcdio</ulink>)
127 and <ulink url="http://sourceforge.net/projects/libcddb/">libcddb</ulink>
128 </para>
129
130 <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
131 <para role="optional">
132 <ulink url="http://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</ulink>,
133 <ulink url="http://code.google.com/p/game-music-emu/">Game Music Emu</ulink>,
134 <ulink url="http://sourceforge.net/projects/sidplay2/">sidplay-libs</ulink>,
135 <xref linkend="libogg"/>,
136 <ulink url="http://downloads.xiph.org/releases/libshout/">libshout</ulink>,
137 <ulink url="http://dl.matroska.org/downloads/libmatroska/">libmatroska</ulink>
138 (requires <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
139 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink> and
140 <ulink url="http://www.musepack.net/">Musepack</ulink>
141 </para>
142
143 <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
144 <para role="optional">
145 <ulink url="http://www.freedesktop.org/wiki/Software/vaapi">libva</ulink>,
146 <ulink url="http://www.khronos.org/openmax/">OpenMAX</ulink>,
147 <xref linkend="faad2"/>,
148 <ulink url="http://www.twolame.org/">Twolame</ulink>,
149 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
150 <xref linkend="flac"/>,
151 <xref linkend="libmpeg2"/>,
152 <xref linkend="libvorbis"/>,
153 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>,
154 <xref linkend="speex"/>,
155 <ulink url="http://downloads.xiph.org/releases/opus/">Opus</ulink>,
156 <xref linkend="libtheora"/>,
157 <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,
158 <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>,
159 <xref linkend="libpng"/>,
160 <ulink url="http://www.videolan.org/developers/x264.html">libx264</ulink>,
161 <ulink url="http://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
162 <ulink url="http://sourceforge.net/projects/zapping/">Zapping VBI</ulink>,
163 <ulink url="http://code.google.com/p/libass/">libass</ulink>,
164 <ulink url="http://code.google.com/p/libkate/">libkate</ulink> and
165 <ulink url="http://code.google.com/p/libtiger/">libtiger</ulink>
166 </para>
167
168 <bridgehead renderas="sect4">Optional video plugins</bridgehead>
169 <para role="optional">
170 <xref linkend="sdl"/>
171 (with <ulink url="http://www.libsdl.org/projects/SDL_image/">SDL_image</ulink>),
172 <xref linkend="freetype2"/>,
173 <xref linkend="fontconfig"/>,
174 <xref linkend="fribidi"/>,
175 <xref linkend="librsvg"/>,
176 <xref linkend="aalib"/> and
177 <ulink url="http://caca.zoy.org/">libcaca</ulink>
178 </para>
179
180 <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
181 <para role="optional">
182 <xref linkend="pulseaudio"/>,
183 <ulink url="http://www.portaudio.com/">PortAudio</ulink>,
184 <ulink url="http://jackaudio.org/">JACK</ulink> and
185 <xref linkend="libsamplerate"/>
186 </para>
187
188 <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
189 <para role="optional">
190 <xref linkend="xcb-util-keysyms"/>,
191 <ulink url="http://www.lirc.org/">LIRC</ulink> and
192 <ulink url="http://www.feep.net/libtar/">libtar</ulink>
193 </para>
194
195 <bridgehead renderas="sect4">Optional visualization plugins</bridgehead>
196 <para role="optional">
197 <ulink url="http://sourceforge.net/projects/goom/">Goom</ulink> and
198 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
199 </para>
200
201 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
202 <para role="optional">
203 <xref linkend="avahi"/>,
204 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
205 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
206 </para>
207
208 <bridgehead renderas="sect4">Optional miscellaneous dependencies</bridgehead>
209 <para role="optional">
210 <xref linkend="libxml2"/>,
211 <xref linkend="taglib"/>,
212 <xref linkend="libnotify"/> and
213 <ulink url="http://sourceforge.net/projects/medialibrary/">MediaLibrary</ulink>
214 (requires <xref linkend="sqlite"/>)
215 </para>
216
217 <para condition="html" role="usernotes">
218 User Notes: <ulink url="&blfs-wiki;/vlc"/>
219 </para>
220 </sect2>
221
222 <sect2 role="installation">
223 <title>Installation of VLC</title>
224
225 <para>
226 Install <application>VLC</application> by running the following commands:
227 </para>
228
229<screen><userinput>patch -Np1 -i ../vlc-&vlc-version;-opencv_fixes-1.patch &amp;&amp;
230patch -Np1 -i ../vlc-&vlc-version;-live_fixes-1.patch &amp;&amp;
231sed -i 's:libsmbclient.h:samba-4.0/&amp;:' configure.ac modules/access/smb.c &amp;&amp;
232./bootstrap &amp;&amp;
233
234./configure --prefix=/usr &amp;&amp;
235make</userinput></screen>
236
237 <para>
238 To test the results, issue: <command>make check</command>.
239 </para>
240
241 <para>
242 Now, as the <systemitem class="username">root</systemitem> user:
243 </para>
244
245<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
246
247 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
248 href="../../xincludes/update-icons-and-desktop.xml"/>
249
250 </sect2>
251
252 <sect2 role="commands">
253 <title>Command Explanations</title>
254
255 <para>
256 <command>sed -i ...</command>: This sed fixes compilation with
257 <application>Samba</application> 4.
258 </para>
259
260 <para>
261 <command>./bootstrap</command>: This command is required because the patch
262 modifies <application>Autotools</application> files and
263 <application>VLC</application> uses a custom reconfiguration system.
264 </para>
265
266 <para>
267 <option>--disable-lua</option>: Use this switch if you don't have
268 <application>Lua</application> installed.
269 </para>
270
271 <para>
272 <option>--disable-dbus</option>: Use this switch if you don't have
273 <application>D-Bus</application> installed.
274 </para>
275
276 <para>
277 <option>--disable-avcodec</option>: Use this switch if you don't
278 have <application>FFmpeg</application> installed.
279 </para>
280
281 <para>
282 <option>--disable-a52</option>: Use this switch if you don't have
283 <application>liba52</application> installed.
284 </para>
285
286 <para>
287 <option>--disable-libgcrypt</option>: Use this switch if you don't
288 have <application>libgcrypt</application> installed.
289 </para>
290
291 <para>
292 <option>--disable-mad</option>: Use this switch if you don't
293 have <application>libmad</application> installed.
294 </para>
295
296 <para>
297 <option>--enable-shine</option>: Use this option if you wish to build the
298 <application>Shine</application> plugin.
299 </para>
300
301 <para>
302 <option>--enable-faad</option>: Use this option if you have
303 <application>FAAD</application> installed and wish to build the
304 <application>FAAD</application> plugin.
305 </para>
306
307 <para>
308 <option>--enable-tremor</option>: Use this option if you have
309 <application>Tremor</application> installed and wish to build the
310 <application>Tremor</application> plugin.
311 </para>
312
313 <para>
314 <option>--enable-aa</option>: Use this option if you have
315 <application>AAlib</application> installed and wish to build the
316 <application>AAlib</application> plugin.
317 </para>
318
319 </sect2>
320
321 <sect2 role="content">
322 <title>Contents</title>
323
324 <segmentedlist>
325 <segtitle>Installed Programs</segtitle>
326 <segtitle>Installed Libraries</segtitle>
327 <segtitle>Installed Directories</segtitle>
328
329 <seglistitem>
330 <seg>
331 cvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
332 </seg>
333 <seg>
334 libvlccore.so, libvlc.so and several libraries in
335 /usr/lib/vlc/plugins
336 </seg>
337 <seg>
338 /usr/include/vlc,
339 /usr/lib/vlc,
340 /usr/share/vlc and
341 /usr/share/doc/vlc-&vlc-version;
342 </seg>
343 </seglistitem>
344 </segmentedlist>
345
346 <variablelist>
347 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
348 <?dbfo list-presentation="list"?>
349 <?dbhtml list-presentation="table"?>
350
351 <varlistentry id="cvlc">
352 <term><command>cvlc</command></term>
353 <listitem>
354 <para>
355 is a script to run VLC with the dummy interface.
356 </para>
357 <indexterm zone="vlc cvlc">
358 <primary sortas="b-cvlc">cvlc</primary>
359 </indexterm>
360 </listitem>
361 </varlistentry>
362
363 <varlistentry id="qvlc">
364 <term><command>qvlc</command></term>
365 <listitem>
366 <para>
367 is a script to run <application>VLC</application> with the
368 <application>Qt</application> interface.
369 </para>
370 <indexterm zone="vlc qvlc">
371 <primary sortas="b-qvlc">qvlc</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="rvlc">
377 <term><command>rvlc</command></term>
378 <listitem>
379 <para>
380 is a script to run <application>VLC</application> with a command
381 line interface.
382 </para>
383 <indexterm zone="vlc rvlc">
384 <primary sortas="b-rvlc">rvlc</primary>
385 </indexterm>
386 </listitem>
387 </varlistentry>
388
389 <varlistentry id="svlc">
390 <term><command>svlc</command></term>
391 <listitem>
392 <para>
393 is a script to run <application>VLC</application> with the skins
394 interface.
395 </para>
396 <indexterm zone="vlc svlc">
397 <primary sortas="b-svlc">svlc</primary>
398 </indexterm>
399 </listitem>
400 </varlistentry>
401
402 <varlistentry id="vlc-prog">
403 <term><command>vlc</command></term>
404 <listitem>
405 <para>
406 is the <application>VLC</application> media player.
407 </para>
408 <indexterm zone="vlc vlc-prog">
409 <primary sortas="b-vlc">vlc</primary>
410 </indexterm>
411 </listitem>
412 </varlistentry>
413
414 <varlistentry id="vlc-wrapper">
415 <term><command>vlc-wrapper</command></term>
416 <listitem>
417 <para>
418 is a wrapper to drop privileges with <application>VLC</application>.
419 </para>
420 <indexterm zone="vlc vlc-wrapper">
421 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
422 </indexterm>
423 </listitem>
424 </varlistentry>
425
426 </variablelist>
427
428 </sect2>
429
430</sect1>
Note: See TracBrowser for help on using the repository browser.