source: multimedia/videoutils/vlc.xml@ 2216c1b1

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.0 9.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 2216c1b1 was 2216c1b1, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to balsa-2.5.7.
Update to vlc-3.0.7.1.
Update to xscreensaver-5.43.
Update to goffice-0.10.45.
Update to libICE-1.0.10 (Xorg Library).

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21835 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 "https://download.videolan.org/vlc/&vlc-version;/vlc-&vlc-version;.tar.xz">
8 <!ENTITY vlc-download-ftp " ">
9 <!ENTITY vlc-md5sum "1adf2fe21070378b0e45ad163d3b232d">
10 <!ENTITY vlc-size "25 MB">
11 <!ENTITY vlc-buildsize "727 MB (add 14 MB for tests)">
12 <!ENTITY vlc-time "2.1 SBU (using parallelism=4; add 0.2 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 &lfs84_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"/> and
93 <xref linkend="libssh2"/>
94 </para>
95
96 <bridgehead renderas="sect4">Optional input plugins</bridgehead>
97 <para role="optional">
98
99 <xref linkend="libcddb"/>,
100 <xref linkend="libdv"/>,
101 <xref linkend="libdvdcss"/>,
102 <xref linkend="libdvdread"/>,
103 <xref linkend="libdvdnav"/>,
104 <xref linkend="opencv"/> (currently broken),
105 <xref linkend="samba"/>,
106 <xref linkend="v4l-utils"/>,
107 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
108 <ulink url="http://sourceforge.net/projects/libdc1394/">libdc1394</ulink>,
109 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>,
110 <ulink url="http://www.live555.com/">Live555</ulink>, and
111 <ulink url="http://www.gnu.org/software/vcdimager/">VCDImager</ulink>
112 (requires <xref linkend="libcdio"/>)
113 </para>
114
115 <bridgehead renderas="sect4">Optional mux/demux plugins</bridgehead>
116 <para role="optional">
117 <xref linkend="libogg"/>,
118 <ulink url="https://github.com/kode54/Game_Music_Emu">Game Music Emu</ulink>,
119 <ulink url="http://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</ulink>,
120 <ulink url="http://downloads.xiph.org/releases/libshout/">libshout</ulink>,
121 <ulink url="http://dl.matroska.org/downloads/libmatroska/">libmatroska</ulink>
122 (requires <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
123 <ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
124 <ulink url="http://www.musepack.net/">Musepack</ulink>, and
125 <ulink url="http://sourceforge.net/projects/sidplay2/">sidplay-libs</ulink>
126 </para>
127
128 <bridgehead renderas="sect4">Optional codec plugins</bridgehead>
129 <para role="optional">
130 <xref linkend="faad2"/>,
131 <xref linkend="flac"/>,
132 <xref linkend="libass"/>,
133 <xref linkend="libmpeg2"/>,
134 <xref linkend="libpng"/>,
135 <xref linkend="libtheora"/>,
136 <xref linkend="libva"/>,
137 <xref linkend="libvorbis"/>,
138 <xref linkend="opus"/>,
139 <xref linkend="speex"/>,
140 <xref linkend="x264"/>,
141 <ulink url="https://aomedia.googlesource.com/aom/">aom</ulink>,
142 <ulink url="https://code.videolan.org/videolan/dav1d">dav1d</ulink>,
143 <ulink url="http://sourceforge.net/projects/dirac/">Dirac</ulink>,
144 <ulink url="http://sourceforge.net/projects/fluidsynth/">FluidSynth</ulink>,
145 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
146 <ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
147 <ulink url="http://www.khronos.org/openmax/">OpenMAX</ulink>,
148 <ulink url="http://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
149 <ulink url="https://sourceforge.net/p/soxr/wiki/Home/">SoX</ulink>,
150 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>,
151 <ulink url="http://www.twolame.org/">Twolame</ulink>, and
152 <ulink url="http://sourceforge.net/projects/zapping/">Zapping VBI</ulink>
153 </para>
154
155 <bridgehead renderas="sect4">Optional video plugins</bridgehead>
156 <para role="optional">
157 <xref linkend="aalib"/>,
158 <xref linkend="fontconfig"/>,
159 <xref linkend="freetype2"/>,
160 <xref linkend="fribidi"/>,
161 <xref linkend="librsvg"/>,
162 <xref linkend="libvdpau"/>,
163 <xref linkend="sdl"/>
164 (with <ulink url="http://www.libsdl.org/projects/SDL_image/">SDL_image</ulink>), and
165 <ulink url="http://caca.zoy.org/">libcaca</ulink>
166 </para>
167
168 <bridgehead renderas="sect4">Optional audio plugins</bridgehead>
169 <para role="optional">
170 <xref linkend="pulseaudio"/>,
171 <xref linkend="libsamplerate"/>, and
172 <ulink url="http://jackaudio.org/">JACK</ulink>
173 </para>
174
175 <bridgehead renderas="sect4">Optional interface plugins</bridgehead>
176 <para role="optional">
177 <xref linkend="qt5"/> (required for the graphical user interface),
178 <ulink url="http://pkgbuild.com/~giovanni/libtar/">libtar</ulink>, and
179 <ulink url="http://www.lirc.org/">LIRC</ulink>
180 </para>
181
182 <bridgehead renderas="sect4">Optional visualisations and video filter plugins</bridgehead>
183 <para role="optional">
184 <ulink url="http://sourceforge.net/projects/goom/">Goom</ulink> and
185 <ulink url="http://sourceforge.net/projects/projectm/">projectM</ulink>
186 </para>
187
188 <bridgehead renderas="sect4">Optional service discovery plugins</bridgehead>
189 <para role="optional">
190 <xref linkend="avahi"/>,
191 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink> and
192 <ulink url="http://sourceforge.net/projects/pupnp/">libupnp</ulink>
193 </para>
194
195 <bridgehead renderas="sect4">Miscellaneous options</bridgehead>
196 <para role="optional">
197 <xref linkend="gnutls"/>,
198 <xref linkend="libnotify"/>,
199 <xref linkend="libxml2"/>,
200 <xref linkend="taglib"/>,
201 <xref role="runtime" linkend="xdg-utils"/> (runtime), and
202 <ulink url="http://www.ambilight4pc.com/atmolight.html">AtmoLight</ulink>
203 </para>
204
205 <para condition="html" role="usernotes">
206 User Notes: <ulink url="&blfs-wiki;/vlc"/>
207 </para>
208 </sect2>
209
210 <sect2 role="installation">
211 <title>Installation of VLC</title>
212
213 <para>
214 Install <application>VLC</application> by running the following commands:
215 </para>
216
217 <screen><userinput>sed -i '/vlc_demux.h/a #define LUA_COMPAT_APIINTCASTS' modules/lua/vlc.h &amp;&amp;
218sed -i '/LIBSSH2_VERSION_NUM/s/10801/10900/' modules/access/sftp.c &amp;&amp;
219
220BUILDCC=gcc ./configure --prefix=/usr \
221 --disable-opencv \
222 --disable-vpx &amp;&amp;
223
224make</userinput></screen>
225
226 <para>
227 To test the results, issue: <command>make check</command>.
228 </para>
229
230 <para>
231 Now, as the <systemitem class="username">root</systemitem> user:
232 </para>
233
234<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
235
236 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
237 href="../../xincludes/update-icons-and-desktop.xml"/>
238
239 </sect2>
240
241 <sect2 role="commands">
242 <title>Command Explanations</title>
243
244 <para>
245 <command>sed ... modules/lua/...</command>: This command allows
246 building with the current version of <xref linkend="lua"/>.
247 </para>
248
249 <para>
250 <command>sed ... modules/access/sftp.c</command>: This command fixes
251 building with <xref linkend="libssh2"/>.
252 </para>
253
254 <para>
255 <parameter>--disable-opencv</parameter>: This switch is required to disable
256 <application>opencv</application> which is not compatible with this
257 version of <application>vlc</application>.
258 </para>
259
260 <para>
261 <parameter>--disable-vpx</parameter>: This switch is required to disable
262 <application>libvpx</application>. The latest version is not compatible
263 with this version of <application>vlc</application>.
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-mad</option>: Use this switch if you don't
273 have <application>libmad</application> installed.
274 </para>
275
276 <para>
277 <option>--disable-avcodec --disable-swscale</option>: Use these switches
278 if you don't 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-xcb</option>: Use this switch if you don't have
288 <application>X Window System</application> installed.
289 </para>
290
291 <para>
292 <option>--disable-alsa</option>: Use this switch if you don't have
293 <application>ALSA</application> installed.
294 </para>
295
296 <para>
297 <option>--disable-libgcrypt</option>: Use this switch if you don't
298 have <application>libgcrypt</application> installed.
299 </para>
300
301 <para>
302 <option>--disable-sftp</option>: The default is to build the sftp
303 module if <xref linkend="libssh2"/> is installed. Use this switch
304 if you do not want to build this module.
305 </para>
306
307 <note>
308 <para>
309 There are many options to <application>VLC</application>'s
310 <command>configure</command> command. Check the
311 <command>configure --help</command> output for a complete list.
312 </para>
313 </note>
314
315 </sect2>
316
317 <sect2 role="content">
318 <title>Contents</title>
319
320 <segmentedlist>
321 <segtitle>Installed Programs</segtitle>
322 <segtitle>Installed Libraries</segtitle>
323 <segtitle>Installed Directories</segtitle>
324
325 <seglistitem>
326 <seg>
327 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
328 </seg>
329 <seg>
330 libvlccore.so, libvlc.so, and many plugins in
331 /usr/lib/vlc/plugins
332 </seg>
333 <seg>
334 /usr/{include,lib,share}/vlc and
335 /usr/share/doc/vlc-&vlc-version;
336 </seg>
337 </seglistitem>
338 </segmentedlist>
339
340 <variablelist>
341 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
342 <?dbfo list-presentation="list"?>
343 <?dbhtml list-presentation="table"?>
344
345 <varlistentry id="cvlc">
346 <term><command>cvlc</command></term>
347 <listitem>
348 <para>
349 is a script to run VLC with the dummy interface.
350 </para>
351 <indexterm zone="vlc cvlc">
352 <primary sortas="b-cvlc">cvlc</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="nvlc">
358 <term><command>nvlc</command></term>
359 <listitem>
360 <para>
361 is a script to run VLC with the ncurses interface.
362 </para>
363 <indexterm zone="vlc nvlc">
364 <primary sortas="b-nvlc">nvlc</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="qvlc">
370 <term><command>qvlc</command></term>
371 <listitem>
372 <para>
373 is a script to run <application>VLC</application> with the
374 <application>Qt</application> interface.
375 </para>
376 <indexterm zone="vlc qvlc">
377 <primary sortas="b-qvlc">qvlc</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="rvlc">
383 <term><command>rvlc</command></term>
384 <listitem>
385 <para>
386 is a script to run <application>VLC</application> with a command
387 line interface.
388 </para>
389 <indexterm zone="vlc rvlc">
390 <primary sortas="b-rvlc">rvlc</primary>
391 </indexterm>
392 </listitem>
393 </varlistentry>
394
395 <varlistentry id="svlc">
396 <term><command>svlc</command></term>
397 <listitem>
398 <para>
399 is a script to run <application>VLC</application> with the skins
400 interface.
401 </para>
402 <indexterm zone="vlc svlc">
403 <primary sortas="b-svlc">svlc</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407
408 <varlistentry id="vlc-prog">
409 <term><command>vlc</command></term>
410 <listitem>
411 <para>
412 is the <application>VLC</application> media player.
413 </para>
414 <indexterm zone="vlc vlc-prog">
415 <primary sortas="b-vlc">vlc</primary>
416 </indexterm>
417 </listitem>
418 </varlistentry>
419
420 <varlistentry id="vlc-wrapper">
421 <term><command>vlc-wrapper</command></term>
422 <listitem>
423 <para>
424 is a wrapper to drop privileges with <application>VLC</application>.
425 </para>
426 <indexterm zone="vlc vlc-wrapper">
427 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
428 </indexterm>
429 </listitem>
430 </varlistentry>
431
432 </variablelist>
433
434 </sect2>
435
436</sect1>
Note: See TracBrowser for help on using the repository browser.