source: multimedia/videoutils/vlc.xml@ c67fbf64

systemd-11177
Last change on this file since c67fbf64 was c67fbf64, checked in by Krejzi <krejzi@…>, 11 years ago

Remove packages that are now in lfs systemd from blfs.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@11302 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 14.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
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 "b45be633c71dca04ca7d6c3d64dd728b">
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 </itemizedlist>
88
89 <bridgehead renderas="sect3">VLC Dependencies</bridgehead>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="alsa-lib"/>,
94 <xref linkend="ffmpeg"/>,
95 <xref linkend="gnutls"/>,
96 <xref linkend="liba52"/>,
97 <xref linkend="libgcrypt"/>,
98 <xref linkend="libmad"/> and
99 <xref linkend="qt4"/> (<application>Qt</application> is required for the
100 graphical user interface; without <application>Qt</application> you will
101 only be able to use the command line or <application>ncurses</application>
102 interface)
103 </para>
104
105 <bridgehead renderas="sect4">Optional input drivers and libraries</bridgehead>
106 <para role="optional">
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/libdc1394/">libdc1394</ulink>,
110 <xref linkend="libdv"/>,
111 <xref linkend="libdvdread"/>,
112 <xref linkend="libdvdnav"/>,
113 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
114 <ulink url="http://opencv.willowgarage.com/wiki/">OpenCV</ulink>,
115 <xref linkend="samba3"/>,
116 <ulink url="http://linuxtv.org/downloads/v4l-utils/">Video4Linux</ulink>,
117 <ulink url="http://www.gnu.org/software/vcdimager/">VCDImager</ulink>
118 (requires <ulink url="http://www.gnu.org/software/libcdio/">libcdio</ulink>)
119 and <ulink url="http://sourceforge.net/projects/libcddb/">libcddb</ulink>
120 </para>
121
122 <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
123 <para role="optional">
124 <ulink url="http://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</ulink>,
125 <ulink url="http://code.google.com/p/game-music-emu/">Game Music Emu</ulink>,
126 <ulink url="http://sourceforge.net/projects/sidplay2/">sidplay-libs</ulink>,
127 <xref linkend="libogg"/>,
128 <ulink url="http://downloads.xiph.org/releases/libshout/">libshout</ulink>,
129 <ulink url="http://dl.matroska.org/downloads/libmatroska/">libmatroska</ulink>
130 (requires <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
131 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink> and
132 <ulink url="http://www.musepack.net/">Musepack</ulink>
133 </para>
134
135 <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
136 <para role="optional">
137 <ulink url="http://www.freedesktop.org/wiki/Software/vaapi">libva</ulink>,
138 <ulink url="http://www.khronos.org/openmax/">OpenMAX</ulink>,
139 <xref linkend="faad2"/>,
140 <ulink url="http://www.twolame.org/">Twolame</ulink>,
141 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
142 <xref linkend="flac"/>,
143 <xref linkend="libmpeg2"/>,
144 <xref linkend="libvorbis"/>,
145 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>,
146 <xref linkend="speex"/>,
147 <ulink url="http://downloads.xiph.org/releases/opus/">Opus</ulink>,
148 <xref linkend="libtheora"/>,
149 <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,
150 <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>,
151 <xref linkend="libpng"/>,
152 <ulink url="http://www.videolan.org/developers/x264.html">libx264</ulink>,
153 <ulink url="http://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
154 <ulink url="http://sourceforge.net/projects/zapping/">Zapping VBI</ulink>,
155 <ulink url="http://code.google.com/p/libass/">libass</ulink>,
156 <ulink url="http://code.google.com/p/libkate/">libkate</ulink> and
157 <ulink url="http://code.google.com/p/libtiger/">libtiger</ulink>
158 </para>
159
160 <bridgehead renderas="sect4">Optional video plugins</bridgehead>
161 <para role="optional">
162 <xref linkend="sdl"/>
163 (with <ulink url="http://www.libsdl.org/projects/SDL_image/">SDL_image</ulink>),
164 <xref linkend="freetype2"/>,
165 <xref linkend="fontconfig"/>,
166 <xref linkend="fribidi"/>,
167 <xref linkend="librsvg"/>,
168 <xref linkend="aalib"/> and
169 <ulink url="http://caca.zoy.org/">libcaca</ulink>
170 </para>
171
172 <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
173 <para role="optional">
174 <xref linkend="pulseaudio"/>,
175 <ulink url="http://www.portaudio.com/">PortAudio</ulink>,
176 <ulink url="http://jackaudio.org/">JACK</ulink> and
177 <xref linkend="libsamplerate"/>
178 </para>
179
180 <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
181 <para role="optional">
182 <xref linkend="xcb-util-keysyms"/>,
183 <ulink url="http://www.lirc.org/">LIRC</ulink> and
184 <ulink url="http://www.feep.net/libtar/">libtar</ulink>
185 </para>
186
187 <bridgehead renderas="sect4">Optional visualization plugins</bridgehead>
188 <para role="optional">
189 <ulink url="http://sourceforge.net/projects/goom/">Goom</ulink> and
190 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
191 </para>
192
193 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
194 <para role="optional">
195 <xref linkend="avahi"/>,
196 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
197 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
198 </para>
199
200 <bridgehead renderas="sect4">Optional miscellaneous dependencies</bridgehead>
201 <para role="optional">
202 <xref linkend="libxml2"/>,
203 <xref linkend="taglib"/>,
204 <xref linkend="libnotify"/>,
205 <ulink url="http://sourceforge.net/projects/medialibrary/">MediaLibrary</ulink>
206 (requires <xref linkend="sqlite"/>) and
207 <ulink url="http://www.lua.org/">Lua (version 5.1)</ulink>
208 </para>
209
210 <para condition="html" role="usernotes">
211 User Notes: <ulink url="&blfs-wiki;/vlc"/>
212 </para>
213 </sect2>
214
215 <sect2 role="installation">
216 <title>Installation of VLC</title>
217
218 <para>
219 Install <application>VLC</application> by running the following commands:
220 </para>
221
222<screen><userinput>patch -Np1 -i ../vlc-&vlc-version;-opencv_fixes-1.patch &amp;&amp;
223./bootstrap &amp;&amp;
224
225./configure --prefix=/usr --disable-lua &amp;&amp;
226make</userinput></screen>
227
228 <para>
229 To test the results, issue: <command>make check</command>.
230 </para>
231
232 <para>
233 Now, as the <systemitem class="username">root</systemitem> user:
234 </para>
235
236<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
237
238 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
239 href="../../xincludes/update-icons-and-desktop.xml"/>
240 </sect2>
241
242 <sect2 role="commands">
243 <title>Command Explanations</title>
244
245 <para>
246 <command>./bootstrap</command>: This command is required because the patch
247 modifies <application>Autotools</application> files and
248 <application>VLC</application> uses a custom reconfiguration system.
249 </para>
250
251 <para>
252 <parameter>--disable-lua</parameter>: The package fails to install if
253 <application>Lua</application> is missing. Omit this option if you have
254 installed <application>Lua</application>.
255 </para>
256
257 <para>
258 <parameter>--disable-dbus</parameter>: The package fails to install if
259 <application>D-Bus</application> is missing. Use this switch if you don't
260 have <application>D-Bus</application> installed.
261 </para>
262
263 <para>
264 <option>--disable-avcodec</option>: Use this switch if you don't
265 have <application>FFmpeg</application> installed.
266 </para>
267
268 <para>
269 <option>--disable-a52</option>: Use this switch if you don't have
270 <application>liba52</application> installed.
271 </para>
272
273 <para>
274 <option>--disable-libgcrypt</option>: Use this switch if you don't
275 have <application>libgcrypt</application> installed.
276 </para>
277
278 <para>
279 <option>--disable-mad</option>: Use this switch if you don't
280 have <application>libmad</application> installed.
281 </para>
282
283 <para>
284 <option>--enable-shine</option>: Use this option if you wish to build the
285 <application>Shine</application> plugin.
286 </para>
287
288 <para>
289 <option>--enable-faad</option>: Use this option if you have
290 <application>FAAD</application> installed and wish to build the
291 <application>FAAD</application> plugin.
292 </para>
293
294 <para>
295 <option>--enable-tremor</option>: Use this option if you have
296 <application>Tremor</application> installed and wish to build the
297 <application>Tremor</application> plugin.
298 </para>
299
300 <para>
301 <option>--enable-aa</option>: Use this option if you have
302 <application>AAlib</application> installed and wish to build the
303 <application>AAlib</application> plugin.
304 </para>
305
306 </sect2>
307
308 <sect2 role="content">
309 <title>Contents</title>
310
311 <segmentedlist>
312 <segtitle>Installed Programs</segtitle>
313 <segtitle>Installed Libraries</segtitle>
314 <segtitle>Installed Directories</segtitle>
315
316 <seglistitem>
317 <seg>
318 cvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
319 </seg>
320 <seg>
321 libvlccore.so, libvlc.so and several libraries in
322 /usr/lib/vlc/plugins
323 </seg>
324 <seg>
325 /usr/include/vlc,
326 /usr/lib/vlc,
327 /usr/share/vlc and
328 /usr/share/doc/vlc-&vlc-version;
329 </seg>
330 </seglistitem>
331 </segmentedlist>
332
333 <variablelist>
334 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
335 <?dbfo list-presentation="list"?>
336 <?dbhtml list-presentation="table"?>
337
338 <varlistentry id="cvlc">
339 <term><command>cvlc</command></term>
340 <listitem>
341 <para>
342 is a script to run VLC with the dummy interface.
343 </para>
344 <indexterm zone="vlc cvlc">
345 <primary sortas="b-cvlc">cvlc</primary>
346 </indexterm>
347 </listitem>
348 </varlistentry>
349
350 <varlistentry id="qvlc">
351 <term><command>qvlc</command></term>
352 <listitem>
353 <para>
354 is a script to run <application>VLC</application> with the
355 <application>Qt</application> interface.
356 </para>
357 <indexterm zone="vlc qvlc">
358 <primary sortas="b-qvlc">qvlc</primary>
359 </indexterm>
360 </listitem>
361 </varlistentry>
362
363 <varlistentry id="rvlc">
364 <term><command>rvlc</command></term>
365 <listitem>
366 <para>
367 is a script to run <application>VLC</application> with a command
368 line interface.
369 </para>
370 <indexterm zone="vlc rvlc">
371 <primary sortas="b-rvlc">rvlc</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="svlc">
377 <term><command>svlc</command></term>
378 <listitem>
379 <para>
380 is a script to run <application>VLC</application> with the skins
381 interface.
382 </para>
383 <indexterm zone="vlc svlc">
384 <primary sortas="b-svlc">svlc</primary>
385 </indexterm>
386 </listitem>
387 </varlistentry>
388
389 <varlistentry id="vlc-prog">
390 <term><command>vlc</command></term>
391 <listitem>
392 <para>
393 is the <application>VLC</application> media player.
394 </para>
395 <indexterm zone="vlc vlc-prog">
396 <primary sortas="b-vlc">vlc</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="vlc-wrapper">
402 <term><command>vlc-wrapper</command></term>
403 <listitem>
404 <para>
405 is a wrapper to drop privileges with <application>VLC</application>.
406 </para>
407 <indexterm zone="vlc vlc-wrapper">
408 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
409 </indexterm>
410 </listitem>
411 </varlistentry>
412
413 </variablelist>
414
415 </sect2>
416
417</sect1>
Note: See TracBrowser for help on using the repository browser.