source: multimedia/videoutils/vlc.xml@ 5059efc

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 5059efc was 5059efc, checked in by Krejzi <krejzi@…>, 11 years ago

Fix links to vlc optional deps.

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

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