source: multimedia/videoutils/vlc.xml@ 8630358

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 8630358 was 8630358, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update to dbus-1.12.6.
Update to phonon-backend-vlc-0.10.1.
Update to vlc-3.0.1.

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

  • Property mode set to 100644
File size: 14.0 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 "https://download.videolan.org/vlc/&vlc-version;/vlc-&vlc-version;.tar.xz">
8 <!ENTITY vlc-download-ftp " ">
9 <!ENTITY vlc-md5sum "32292f9fc6eab0b00432cdd574fc9eae">
10 <!ENTITY vlc-size "24 MB">
11 <!ENTITY vlc-buildsize "539 MB (add 6 MB for tests)">
12 <!ENTITY vlc-time "2.0 SBU (using parallelism=4; add 0.3 SBU for tests)">
13]>
14
15<sect1 id="vlc" xreflabel="VLC-&vlc-version;">
16 <?dbhtml filename="vlc.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>VLC-&vlc-version;</title>
24
25 <indexterm zone="vlc">
26 <primary sortas="a-VLC">VLC</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to VLC</title>
31
32 <para>
33 <application>VLC</application> is a media player, streamer, and encoder.
34 It can play from many inputs, such as files, network streams, capture
35 devices, desktops, or DVD, SVCD, VCD, and audio CD. It can use most audio
36 and video codecs (MPEG 1/2/4, H264, VC-1, DivX, WMV, Vorbis, AC3, AAC,
37 etc.), and it can also convert to different formats and/or send streams
38 through the network.
39 </para>
40
41 &lfs82_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&vlc-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&vlc-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &vlc-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &vlc-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &vlc-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &vlc-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">VLC Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Recommended</bridgehead>
80 <para role="recommended">
81 <xref linkend="alsa-lib"/>,
82 <xref linkend="ffmpeg"/>,
83 <xref linkend="liba52"/>,
84 <xref linkend="libgcrypt"/>
85 <xref linkend="libmad"/>,
86 <xref linkend="lua"/>, and
87 <xref linkend="x-window-system"/>,
88 </para>
89
90 <bridgehead renderas="sect4">Optional features and packages</bridgehead>
91 <para role="optional">
92 <xref linkend="dbus"/>
93 </para>
94
95 <bridgehead renderas="sect4">Optional input plugins</bridgehead>
96 <para role="optional">
97
98 <xref linkend="libcddb"/>,
99 <xref linkend="libdv"/>,
100 <xref linkend="libdvdcss"/>,
101 <xref linkend="libdvdread"/>,
102 <xref linkend="libdvdnav"/>,
103 <xref linkend="opencv"/> (currently broken),
104 <xref linkend="samba"/>,
105 <xref linkend="v4l-utils"/>,
106 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
107 <ulink url="http://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
108 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>,
109 <ulink url="http://www.live555.com/">Live555</ulink>, and
110 <ulink url="http://www.gnu.org/software/vcdimager/">VCDImager</ulink>
111 (requires <xref linkend="libcdio"/>)
112 </para>
113
114 <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
115 <para role="optional">
116 <xref linkend="libogg"/>,
117 <ulink url="https://github.com/kode54/Game_Music_Emu">Game Music Emu</ulink>,
118 <ulink url="http://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</ulink>,
119 <ulink url="http://downloads.xiph.org/releases/libshout/">libshout</ulink>,
120 <ulink url="http://dl.matroska.org/downloads/libmatroska/">libmatroska</ulink>
121 (requires <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
122 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
123 <ulink url="http://www.musepack.net/">Musepack</ulink>, and
124 <ulink url="http://sourceforge.net/projects/sidplay2/">sidplay-libs</ulink>
125 </para>
126
127 <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
128 <para role="optional">
129 <xref linkend="faad2"/>,
130 <xref linkend="flac"/>,
131 <xref linkend="libass"/>,
132 <xref linkend="libmpeg2"/>,
133 <xref linkend="libpng"/>,
134 <xref linkend="libtheora"/>,
135 <xref linkend="libva"/>,
136 <xref linkend="libvorbis"/>,
137 <xref linkend="opus"/>,
138 <xref linkend="speex"/>,
139 <xref linkend="x264"/>,
140 <ulink url="http://sourceforge.net/projects/dirac/">Dirac</ulink>,
141 <ulink url="http://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
142 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
143 <ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
144 <ulink url="http://www.khronos.org/openmax/">OpenMAX</ulink>,
145 <ulink url="http://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
146 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>,
147 <ulink url="http://www.twolame.org/">Twolame</ulink>, and
148 <ulink url="http://sourceforge.net/projects/zapping/">Zapping VBI</ulink>
149 </para>
150
151 <bridgehead renderas="sect4">Optional video plugins</bridgehead>
152 <para role="optional">
153 <xref linkend="aalib"/>,
154 <xref linkend="fontconfig"/>,
155 <xref linkend="freetype2"/>,
156 <xref linkend="fribidi"/>,
157 <xref linkend="librsvg"/>,
158 <xref linkend="libvdpau"/>,
159 <xref linkend="sdl"/>
160 (with <ulink url="http://www.libsdl.org/projects/SDL_image/">SDL_image</ulink>), and
161 <ulink url="http://caca.zoy.org/">libcaca</ulink>
162 </para>
163
164 <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
165 <para role="optional">
166 <xref linkend="pulseaudio"/>,
167 <xref linkend="libsamplerate"/>, and
168 <ulink url="http://jackaudio.org/">JACK</ulink>
169 </para>
170
171 <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
172 <para role="optional">
173 <xref linkend="qt5"/> (required for the graphical user interface),
174 <ulink url="http://pkgbuild.com/~giovanni/libtar/">libtar</ulink>, and
175 <ulink url="http://www.lirc.org/">LIRC</ulink>
176 </para>
177
178 <bridgehead renderas="sect4">Optional visualisations and video filter plugins</bridgehead>
179 <para role="optional">
180 <ulink url="http://sourceforge.net/projects/goom/">Goom</ulink> and
181 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
182 </para>
183
184 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
185 <para role="optional">
186 <xref linkend="avahi"/>,
187 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
188 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
189 </para>
190
191 <bridgehead renderas="sect4">Miscellaneous options</bridgehead>
192 <para role="optional">
193 <xref linkend="gnutls"/>,
194 <xref linkend="libnotify"/>,
195 <xref linkend="libxml2"/>,
196 <xref linkend="taglib"/>,
197 <xref role="runtime" linkend="xdg-utils"/> (runtime), and
198 <ulink url="http://www.ambilight4pc.com/atmolight.html">AtmoLight</ulink>
199 </para>
200
201 <para condition="html" role="usernotes">
202 User Notes: <ulink url="&blfs-wiki;/vlc"/>
203 </para>
204 </sect2>
205
206 <sect2 role="installation">
207 <title>Installation of VLC</title>
208
209 <para>
210 Install <application>VLC</application> by running the following commands:
211 </para>
212
213 <screen><userinput>sed -i '/vlc_demux.h/a #define LUA_COMPAT_APIINTCASTS' modules/lua/vlc.h &amp;&amp;
214sed -i '/DEPRECATED/s:^://:' modules/text_renderer/freetype/text_layout.c &amp;&amp;
215
216BUILDCC=gcc ./configure --prefix=/usr --disable-opencv &amp;&amp;
217
218make</userinput></screen>
219
220 <para>
221 To test the results, issue: <command>make check</command>.
222 </para>
223
224 <para>
225 Now, as the <systemitem class="username">root</systemitem> user:
226 </para>
227<!--
228 <note>
229 <para>
230 If the XORG_PREFIX is not /usr, make sure the LIBRARY_PATH
231 environment variable is set properly for the root user when
232 doing the install, For example:
233 <command>sudo make LIBRARY_PATH=$XORG_PREFIX/lib ... install</command>.
234 </para>
235 </note>
236-->
237<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
238
239 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
240 href="../../xincludes/update-icons-and-desktop.xml"/>
241
242 </sect2>
243
244 <sect2 role="commands">
245 <title>Command Explanations</title>
246
247 <para>
248 <command>sed ... modules/lua/...</command>: This command allows
249 building with the current version of <xref linkend="lua"/>.
250 </para>
251
252 <para>
253 <command>sed ... text_layout.c</command>: This command allows
254 building with the current version of <xref linkend="freetype2"/>.
255 </para>
256
257 <para>
258 <option>--disable-opencv</option>: This swithc i srequired to disable
259 <application>opencv</application> which is not compatible with this
260 version of <application>vlc</application>.
261 </para>
262
263 <para>
264 <option>--disable-lua</option>: Use this switch if you don't have
265 <application>Lua</application> installed.
266 </para>
267
268 <para>
269 <option>--disable-mad</option>: Use this switch if you don't
270 have <application>libmad</application> installed.
271 </para>
272
273 <para>
274 <option>--disable-avcodec --disable-swscale</option>: Use these switches
275 if you don't have <application>FFmpeg</application> installed.
276 </para>
277
278 <para>
279 <option>--disable-a52</option>: Use this switch if you don't have
280 <application>liba52</application> installed.
281 </para>
282
283 <para>
284 <option>--disable-xcb</option>: Use this switch if you don't have
285 <application>X Window System</application> installed.
286 </para>
287
288 <para>
289 <option>--disable-alsa</option>: Use this switch if you don't have
290 <application>ALSA</application> installed.
291 </para>
292
293 <para>
294 <option>--disable-libgcrypt</option>: Use this switch if you don't
295 have <application>libgcrypt</application> installed.
296 </para>
297
298 <note>
299 <para>
300 There are many options to <application>VLC</application>'s
301 <command>configure</command> command. Check the
302 <command>configure --help</command> output for a complete list.
303 </para>
304 </note>
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, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
319 </seg>
320 <seg>
321 libvlccore.so, libvlc.so, and many plugins in
322 /usr/lib/vlc/plugins
323 </seg>
324 <seg>
325 /usr/{include,lib,share}/vlc and
326 /usr/share/doc/vlc-&vlc-version;
327 </seg>
328 </seglistitem>
329 </segmentedlist>
330
331 <variablelist>
332 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
333 <?dbfo list-presentation="list"?>
334 <?dbhtml list-presentation="table"?>
335
336 <varlistentry id="cvlc">
337 <term><command>cvlc</command></term>
338 <listitem>
339 <para>
340 is a script to run VLC with the dummy interface.
341 </para>
342 <indexterm zone="vlc cvlc">
343 <primary sortas="b-cvlc">cvlc</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="nvlc">
349 <term><command>nvlc</command></term>
350 <listitem>
351 <para>
352 is a script to run VLC with the ncurses interface.
353 </para>
354 <indexterm zone="vlc nvlc">
355 <primary sortas="b-nvlc">nvlc</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="qvlc">
361 <term><command>qvlc</command></term>
362 <listitem>
363 <para>
364 is a script to run <application>VLC</application> with the
365 <application>Qt</application> interface.
366 </para>
367 <indexterm zone="vlc qvlc">
368 <primary sortas="b-qvlc">qvlc</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="rvlc">
374 <term><command>rvlc</command></term>
375 <listitem>
376 <para>
377 is a script to run <application>VLC</application> with a command
378 line interface.
379 </para>
380 <indexterm zone="vlc rvlc">
381 <primary sortas="b-rvlc">rvlc</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="svlc">
387 <term><command>svlc</command></term>
388 <listitem>
389 <para>
390 is a script to run <application>VLC</application> with the skins
391 interface.
392 </para>
393 <indexterm zone="vlc svlc">
394 <primary sortas="b-svlc">svlc</primary>
395 </indexterm>
396 </listitem>
397 </varlistentry>
398
399 <varlistentry id="vlc-prog">
400 <term><command>vlc</command></term>
401 <listitem>
402 <para>
403 is the <application>VLC</application> media player.
404 </para>
405 <indexterm zone="vlc vlc-prog">
406 <primary sortas="b-vlc">vlc</primary>
407 </indexterm>
408 </listitem>
409 </varlistentry>
410
411 <varlistentry id="vlc-wrapper">
412 <term><command>vlc-wrapper</command></term>
413 <listitem>
414 <para>
415 is a wrapper to drop privileges with <application>VLC</application>.
416 </para>
417 <indexterm zone="vlc vlc-wrapper">
418 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 </variablelist>
424
425 </sect2>
426
427</sect1>
Note: See TracBrowser for help on using the repository browser.