source: multimedia/videoutils/vlc.xml@ 6b3a3fe4

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules 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 6b3a3fe4 was 6b3a3fe4, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Update to kf5-5.49.0. Includes oxygen-icons5, extra-cmake-modules, and breeze-icons.
More tags.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@20349 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 14.6 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 "cf01d4755c719fe1c8605ceb40d8f1d2">
10 <!ENTITY vlc-size "24 MB">
11 <!ENTITY vlc-buildsize "709 MB (add 13 MB for tests)">
12 <!ENTITY vlc-time "2.0 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 &lfs83_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;
215sed -i '/#include &lt;QString&gt;/i#include &lt;QButtonGroup&gt;' \
216 modules/gui/qt/components/simple_preferences.cpp &amp;&amp;
217sed -i '/118/s/$/\&amp;\&amp; X264_BUILD &lt; 153/' modules/codec/x264.c &amp;&amp;
218
219BUILDCC=gcc ./configure --prefix=/usr --disable-opencv &amp;&amp;
220
221make</userinput></screen>
222
223 <para>
224 To test the results, issue: <command>make check</command>.
225 </para>
226
227 <para>
228 Now, as the <systemitem class="username">root</systemitem> user:
229 </para>
230<!--
231 <note>
232 <para>
233 If the XORG_PREFIX is not /usr, make sure the LIBRARY_PATH
234 environment variable is set properly for the root user when
235 doing the install, For example:
236 <command>sudo make LIBRARY_PATH=$XORG_PREFIX/lib ... install</command>.
237 </para>
238 </note>
239-->
240<screen role="root"><userinput>make docdir=/usr/share/doc/vlc-&vlc-version; install</userinput></screen>
241
242 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
243 href="../../xincludes/update-icons-and-desktop.xml"/>
244
245 </sect2>
246
247 <sect2 role="commands">
248 <title>Command Explanations</title>
249
250 <para>
251 <command>sed ... modules/lua/...</command>: This command allows
252 building with the current version of <xref linkend="lua"/>.
253 </para>
254
255 <para>
256 <command>sed ... text_layout.c</command>: This command allows
257 building with the current version of <xref linkend="freetype2"/>.
258 </para>
259
260 <para>
261 <command>sed ... modules/codec/x264.c</command> This command allows
262 building with the current version of <xref linkend="x264"/>.
263 </para>
264
265 <para>
266 <command>sed -i '/#include &lt;QString&gt;/ ...</command> This
267 command allows building with the current version of
268 <xref linkend="qt5"/>.
269 </para>
270
271 <para>
272 <option>--disable-opencv</option>: This switch is required to disable
273 <application>opencv</application> which is not compatible with this
274 version of <application>vlc</application>.
275 </para>
276
277 <para>
278 <option>--disable-lua</option>: Use this switch if you don't have
279 <application>Lua</application> installed.
280 </para>
281
282 <para>
283 <option>--disable-mad</option>: Use this switch if you don't
284 have <application>libmad</application> installed.
285 </para>
286
287 <para>
288 <option>--disable-avcodec --disable-swscale</option>: Use these switches
289 if you don't have <application>FFmpeg</application> installed.
290 </para>
291
292 <para>
293 <option>--disable-a52</option>: Use this switch if you don't have
294 <application>liba52</application> installed.
295 </para>
296
297 <para>
298 <option>--disable-xcb</option>: Use this switch if you don't have
299 <application>X Window System</application> installed.
300 </para>
301
302 <para>
303 <option>--disable-alsa</option>: Use this switch if you don't have
304 <application>ALSA</application> installed.
305 </para>
306
307 <para>
308 <option>--disable-libgcrypt</option>: Use this switch if you don't
309 have <application>libgcrypt</application> installed.
310 </para>
311
312 <note>
313 <para>
314 There are many options to <application>VLC</application>'s
315 <command>configure</command> command. Check the
316 <command>configure --help</command> output for a complete list.
317 </para>
318 </note>
319
320 </sect2>
321
322 <sect2 role="content">
323 <title>Contents</title>
324
325 <segmentedlist>
326 <segtitle>Installed Programs</segtitle>
327 <segtitle>Installed Libraries</segtitle>
328 <segtitle>Installed Directories</segtitle>
329
330 <seglistitem>
331 <seg>
332 cvlc, nvlc, qvlc, rvlc, svlc, vlc and vlc-wrapper
333 </seg>
334 <seg>
335 libvlccore.so, libvlc.so, and many plugins in
336 /usr/lib/vlc/plugins
337 </seg>
338 <seg>
339 /usr/{include,lib,share}/vlc and
340 /usr/share/doc/vlc-&vlc-version;
341 </seg>
342 </seglistitem>
343 </segmentedlist>
344
345 <variablelist>
346 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
347 <?dbfo list-presentation="list"?>
348 <?dbhtml list-presentation="table"?>
349
350 <varlistentry id="cvlc">
351 <term><command>cvlc</command></term>
352 <listitem>
353 <para>
354 is a script to run VLC with the dummy interface.
355 </para>
356 <indexterm zone="vlc cvlc">
357 <primary sortas="b-cvlc">cvlc</primary>
358 </indexterm>
359 </listitem>
360 </varlistentry>
361
362 <varlistentry id="nvlc">
363 <term><command>nvlc</command></term>
364 <listitem>
365 <para>
366 is a script to run VLC with the ncurses interface.
367 </para>
368 <indexterm zone="vlc nvlc">
369 <primary sortas="b-nvlc">nvlc</primary>
370 </indexterm>
371 </listitem>
372 </varlistentry>
373
374 <varlistentry id="qvlc">
375 <term><command>qvlc</command></term>
376 <listitem>
377 <para>
378 is a script to run <application>VLC</application> with the
379 <application>Qt</application> interface.
380 </para>
381 <indexterm zone="vlc qvlc">
382 <primary sortas="b-qvlc">qvlc</primary>
383 </indexterm>
384 </listitem>
385 </varlistentry>
386
387 <varlistentry id="rvlc">
388 <term><command>rvlc</command></term>
389 <listitem>
390 <para>
391 is a script to run <application>VLC</application> with a command
392 line interface.
393 </para>
394 <indexterm zone="vlc rvlc">
395 <primary sortas="b-rvlc">rvlc</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 <varlistentry id="svlc">
401 <term><command>svlc</command></term>
402 <listitem>
403 <para>
404 is a script to run <application>VLC</application> with the skins
405 interface.
406 </para>
407 <indexterm zone="vlc svlc">
408 <primary sortas="b-svlc">svlc</primary>
409 </indexterm>
410 </listitem>
411 </varlistentry>
412
413 <varlistentry id="vlc-prog">
414 <term><command>vlc</command></term>
415 <listitem>
416 <para>
417 is the <application>VLC</application> media player.
418 </para>
419 <indexterm zone="vlc vlc-prog">
420 <primary sortas="b-vlc">vlc</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="vlc-wrapper">
426 <term><command>vlc-wrapper</command></term>
427 <listitem>
428 <para>
429 is a wrapper to drop privileges with <application>VLC</application>.
430 </para>
431 <indexterm zone="vlc vlc-wrapper">
432 <primary sortas="b-vlc-wrapper">vlc-wrapper</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 </variablelist>
438
439 </sect2>
440
441</sect1>
Note: See TracBrowser for help on using the repository browser.