source: multimedia/videoutils/vlc.xml@ af1093d

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since af1093d was af1093d, checked in by Krejzi <krejzi@…>, 11 years ago

Package updates.

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

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