source: multimedia/videoutils/mplayer.xml@ 7d4be40

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.4 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 7d4be40 was 7d4be40, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

More multimedia tags.
Disable incompatible libvpx in vlc.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21192 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 18.3 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 mplayer-download-http "http://www.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.xz">
8 <!ENTITY mplayer-download-ftp "ftp://ftp.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.xz">
9 <!ENTITY mplayer-md5sum "e8a4d77ad4f509e81dd5e13b51636c1d">
10 <!ENTITY mplayer-size "12.7 MB">
11 <!ENTITY mplayer-buildsize "204 MB">
12 <!ENTITY mplayer-time "1.4 SBU (Using parallelism=4)">
13
14 <!ENTITY mplayer-skin "Clearlooks-2.0">
15 <!ENTITY mplayer-skin-download-http "https://www.mplayerhq.hu/MPlayer/skins/&mplayer-skin;.tar.bz2">
16 <!ENTITY mplayer-skin-download-ftp "ftp://ftp.mplayerhq.hu/MPlayer/skins/&mplayer-skin;.tar.bz2">
17 <!ENTITY mplayer-skin-md5sum "c82d4dbd7f0c36dfecd63dff972807c5">
18 <!ENTITY mplayer-skin-size "34 KB">
19]>
20
21<sect1 id="mplayer" xreflabel="MPlayer-&mplayer-version;">
22 <?dbhtml filename="mplayer.html"?>
23
24 <sect1info>
25 <othername>$LastChangedBy$</othername>
26 <date>$Date$</date>
27 </sect1info>
28
29 <title>MPlayer-&mplayer-version;</title>
30
31 <indexterm zone="mplayer">
32 <primary sortas="a-MPlayer">MPlayer</primary>
33 </indexterm>
34
35 <sect2 role="package">
36 <title>Introduction to MPlayer</title>
37
38 <para>
39 <application>MPlayer</application> is a powerful audio/video player
40 controlled via the command line or a graphical interface that is able to
41 play almost every popular audio and video file format. With supported
42 video hardware and additional drivers, <application>MPlayer</application>
43 can play video files without an <application>X Window System</application>
44 installed.
45 </para>
46
47 &lfs84_checked;
48
49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
52 <para>
53 Download (HTTP): <ulink url="&mplayer-download-http;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download (FTP): <ulink url="&mplayer-download-ftp;"/>
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download MD5 sum: &mplayer-md5sum;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Download size: &mplayer-size;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated disk space required: &mplayer-buildsize;
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Estimated build time: &mplayer-time;
79 </para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
84 <itemizedlist spacing='compact'>
85 <title>Required Patch</title>
86 <listitem>
87 <para><ulink url="&patch-root;/MPlayer-1.3.0-x264_fix-1.patch"/></para>
88 </listitem>
89 </itemizedlist>
90
91 <itemizedlist spacing='compact'>
92 <title>Skins</title>
93 <listitem>
94 <para>
95 GUI skin (HTTP): <ulink url="&mplayer-skin-download-http;"/>
96 </para>
97 </listitem>
98 <listitem>
99 <para>
100 GUI skin (FTP): <ulink url="&mplayer-skin-download-ftp;"/>
101 </para>
102 </listitem>
103 <listitem>
104 <para>
105 Skin MD5 sum: &mplayer-skin-md5sum;
106 </para>
107 </listitem>
108 <listitem>
109 <para>
110 Skin size: &mplayer-skin-size;
111 </para>
112 </listitem>
113 <listitem>
114 <para>
115 Alternative skins:
116 <ulink url="https://www.mplayerhq.hu/MPlayer/skins/"/>
117 </para>
118 </listitem>
119 </itemizedlist>
120
121 <note>
122 <para>
123 Skins are only required in order to use the
124 <application>Gtk+ 2</application> user interface.
125 </para>
126 </note>
127
128 <bridgehead renderas="sect3">MPlayer Dependencies</bridgehead>
129
130 <bridgehead renderas="sect4">Required</bridgehead>
131 <para role="required">
132 <xref linkend="yasm"/>
133 </para>
134
135 <bridgehead renderas="sect4">Recommended</bridgehead>
136 <para role="recommended">
137 <xref linkend="gtk2"/> and
138 <xref linkend="libvdpau-va-gl"/>
139 </para>
140
141 <bridgehead renderas="sect4">Optional Input Drivers and Libraries</bridgehead>
142 <para role="optional">
143 <xref linkend="cdparanoia"/>,
144 <xref linkend="libcdio"/> (to identify and play CDs),
145 <xref linkend="libdvdread"/>,
146 <xref linkend="libdvdnav"/>,
147 <xref linkend="libdvdcss"/>,
148 <xref linkend="samba"/>,
149 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
150 <ulink url="http://www.live555.com/">LIVE555 Streaming Media</ulink>,
151 <ulink url="http://rtmpdump.mplayerhq.hu/">RTMPDump</ulink>,
152 <ulink url="http://tivo-mplayer.sourceforge.net/mythtivo.html">TiVo vstream client</ulink>, and
153 <ulink url="http://www.xmms.org/">XMMS</ulink>
154 </para>
155
156 <bridgehead renderas="sect4">Optional Audio Output Drivers and Libraries</bridgehead>
157 <para role="optional">
158 <xref linkend="alsa"/>,
159 <xref linkend="pulseaudio"/>,
160 <xref linkend="sdl"/>,
161 <ulink url="http://jackaudio.org/">JACK</ulink>,
162 <ulink url="http://www.radscan.com/nas.html">NAS</ulink>, and
163 <ulink url="http://kcat.strangesoft.net/openal-releases/">OpenAL</ulink>
164 </para>
165
166 <bridgehead renderas="sect4">Optional Video Output Drivers and Libraries</bridgehead>
167 <para role="optional">
168 <xref linkend="aalib"/>,
169 <xref linkend="giflib"/>,
170 <xref linkend="libjpeg"/>,
171 <xref linkend="libmng"/>,
172 <xref linkend="libpng"/>,
173 <ulink url="https://sourceforge.net/projects/openjpeg.mirror/files/">OpenJPEG1</ulink>
174 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
175 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/libcaca/">libcaca</ulink>, and
176 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>
177 </para>
178
179 <bridgehead renderas="sect4">Optional CODECs</bridgehead>
180 <para role="optional">
181 <!-- includes its own version of FFmpeg which is the recommended one by
182 the devs <xref linkend="ffmpeg"/>, -->
183 <xref linkend="faac"/>,
184 <xref linkend="faad2"/>,
185 <xref linkend="lame"/>,
186 <xref linkend="liba52"/>,
187 <xref linkend="libdv"/>,
188 <xref linkend="libmad"/>,
189 <xref linkend="libmpeg2"/>,
190 <xref linkend="libtheora"/>,
191 <xref linkend="libvpx"/>,
192 <xref linkend="lzo"/>,
193 <xref linkend="mpg123"/>,
194 <xref linkend="speex"/>,
195 <xref linkend="xvid"/>,
196 <xref linkend="x264"/>,
197 <ulink url="https://www.broadcom.com/support/crystal-hd">CrystalHD</ulink>,
198<!-- <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,-->
199 <ulink url="http://sourceforge.net/projects/dirac/">Dirac</ulink>,
200 <ulink url="http://www.quut.com/gsm/">GSM</ulink>,
201 <ulink url="http://www.ilbcfreeware.org/">iLBC</ulink>,
202 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
203 <ulink url="http://wiki.multimedia.cx/index.php?title=NUT">libnut</ulink>,
204 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
205 <ulink url="http://sourceforge.net/projects/opencore-amr/">OpenCore
206 Adaptive Multi Rate</ulink>,
207<!-- <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>,-->
208 <ulink url="http://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
209 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>, and
210 <ulink url="http://sourceforge.net/projects/twolame/">TwoLAME</ulink>
211 </para>
212
213 <bridgehead renderas="sect4">Optional Miscellaneous Dependencies</bridgehead>
214 <para role="optional">
215 <xref linkend="fontconfig"/>,
216 <xref linkend="freetype2"/>,
217 <xref linkend="fribidi"/>,
218 <xref linkend="gnutls"/>,
219 <!-- <xref linkend="openssl"/>, only valid for samba3 at this time -->
220 <xref linkend="opus"/>, and
221 <xref linkend="unrar"/>;
222 <xref linkend="libxslt"/>,
223 <xref linkend="DocBook"/> and
224 <xref linkend="docbook-xsl"/> (all three required to build the HTML documentation); and
225 <ulink url="http://cihar.com/software/enca/">Enca</ulink>,
226 <!--LADSPA plugins and other sites of the maintainer are down.
227 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,-->
228 <ulink url="http://sourceforge.net/projects/bs2b/">libbs2b</ulink>, and
229 <ulink url="http://www.lirc.org/">LIRC</ulink> (and
230 <ulink url="http://www.dolda2000.com/~fredrik/lirccd/">LIRC Client Daemon</ulink>)
231 </para>
232
233 <para condition="html" role="usernotes">
234 User Notes: <ulink url="&blfs-wiki;/mplayer"/>
235 </para>
236 </sect2>
237
238 <sect2 role="installation">
239 <title>Installation of MPlayer</title>
240
241 <sect3>
242 <title>Main MPlayer Installation</title>
243
244 <note>
245 <para>
246 The package maintainers recommend building without any
247 optimizations.
248 </para>
249 </note>
250
251 <para>
252 You may wish to examine the output from
253 <command>./configure --help</command> to find out what additional
254 parameters to <command>configure</command> are needed to include the
255 dependencies you have installed on your system.
256 </para>
257
258 <para>
259 Install <application>MPlayer</application> by running the following
260 commands:
261 </para>
262
263<screen><userinput>patch -Np0 -i ../MPlayer-1.3.0-x264_fix-1.patch &amp;&amp;
264
265./configure --prefix=/usr \
266 --confdir=/etc/mplayer \
267 --enable-dynamic-plugins \
268 --enable-menu \
269 --enable-gui &amp;&amp;
270make</userinput></screen>
271
272 <para>
273 If you wish to build the HTML documentation, issue the
274 following command:
275 </para>
276
277<screen><userinput>make doc</userinput></screen>
278
279 <para>
280 This package does not come with a test suite.
281 </para>
282
283 <para>
284 Now, as the <systemitem class="username">root</systemitem> user:
285 </para>
286
287<screen role="root"><userinput>make install &amp;&amp;
288ln -svf ../icons/hicolor/48x48/apps/mplayer.png \
289 /usr/share/pixmaps/mplayer.png</userinput></screen>
290
291 <para>
292 To install the HTML documentation, issue the following commands as the
293 <systemitem class="username">root</systemitem> user:
294 </para>
295
296<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
297install -v -m644 DOCS/HTML/en/* \
298 /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
299
300 <para>
301 You will only need <filename>codecs.conf</filename> if you want to
302 change its properties, as the main binary contains an internal copy of
303 it. Ensure any changes you make to <filename>codecs.conf</filename>
304 achieve the desired results, as incorrect entries in this file have been
305 known to cause errors and render the player unusable. If necessary,
306 create the file as the <systemitem class="username">root</systemitem>
307 user:
308 </para>
309
310<screen role="root"><userinput>install -v -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
311
312 <para>
313 You may alternatively want to copy all the default configuration files
314 to <filename class='directory'>/etc/mplayer</filename> for future
315 reference or more customization ability. As the
316 <systemitem class="username">root</systemitem> user:
317 </para>
318
319<screen role="root"><userinput>install -v -m644 etc/*.conf /etc/mplayer</userinput></screen>
320
321 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
322 href="../../xincludes/update-icons-and-desktop.xml"/>
323
324 </sect3>
325
326 <sect3>
327 <title>Skin Installation (Optional)</title>
328
329 <para>
330 To enable the Gtk+ 2 frontend of <application>MPlayer</application>,
331 you'll need to install at least one skin. Extract the desired skin and
332 create the default location (as the
333 <systemitem class="username">root</systemitem> user):
334 </para>
335
336<screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.bz2 \
337 -C /usr/share/mplayer/skins &amp;&amp;
338ln -sfvn Clearlooks /usr/share/mplayer/skins/default</userinput></screen>
339 </sect3>
340 </sect2>
341
342 <sect2 role="commands">
343 <title>Command Explanations</title>
344
345 <para>
346 <parameter>--enable-gui</parameter>: This option builds the GUI interface
347 into <command>mplayer</command>.
348 </para>
349
350 <para>
351 <parameter>--enable-menu</parameter>: This option is set to enable the
352 on-screen display.
353 </para>
354<!--Currently broken
355 <para>
356 <option>-\-disable-ffmpeg_a</option>: You can use this option if you have
357 installed <xref linkend="ffmpeg"/>. MPlayer includes a copy of the FFmpeg
358 source and without this option it will statically compile the included
359 version of FFmpeg into itself. Dynamically linking to a system installed
360 FFmpeg makes MPlayer and Mencoder about 9MB smaller. If MPlayer exhibits
361 unstable behavior linked to a system installed FFmpeg, try recompiling MPlayer
362 without this option (it is always more thoroughly tested with the included
363 FFmpeg).
364 </para>-->
365
366 <para>
367 <option>--language-doc="<replaceable>&lt;lang&gt;</replaceable>"</option>:
368 This switch enables the language used for the documentation. Use
369 <command>./configure --help</command> to find out what additional
370 information.
371 </para>
372
373 <para>
374 <option>--language-man="<replaceable>&lt;lang&gt;</replaceable>"</option>:
375 This switch enables the language used for the man pages. Use
376 <command>./configure --help</command> to find out what additional
377 information.
378 </para>
379
380 <para>
381 <option>--language-msg="<replaceable>&lt;lang&gt;</replaceable>"</option>:
382 This switch enables the language used for the messages and the GUI. Use
383 <command>./configure --help</command> to find out what additional
384 information.
385 </para>
386
387 <para>
388 <option>--language="<replaceable>&lt;lang&gt;</replaceable>"</option>:
389 This switch defines the default language used. Use <command>./configure
390 --help</command> to find out what additional information.
391 </para>
392
393 <note>
394 <para>
395 Specific options override --language. You can pass a list of
396 languages separated by whitespace or commas instead of a single
397 language. Nonexisting translations will be dropped from each list.
398 All documentation and man page translations available in the list
399 will be installed, for the messages the first available translation
400 will be used. The value "all" will activate all translations. The
401 LINGUAS environment variable is honored. In all cases the fallback is
402 English. Values listed by <command>./configure --help</command> are
403 not all available, as would normally be expected. You need to build
404 test.
405 </para>
406 </note>
407
408 </sect2>
409
410 <sect2 role="configuration">
411 <title>Configuring MPlayer</title>
412
413 <sect3 id="mplayer-config">
414 <title>Config Files</title>
415
416 <para>
417 <filename>/etc/mplayer/*</filename> and
418 <filename>~/.mplayer/*</filename>
419 </para>
420
421 <note><para>To play a DVD, it may be useful to ensure a /dev/dvd
422 device is created. You may need to set this up as described in
423 <xref linkend="dev-dvd"/>.</para></note>
424
425 <indexterm zone="mplayer mplayer-config">
426 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
427 </indexterm>
428
429 <indexterm zone="mplayer mplayer-config">
430 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
431 </indexterm>
432 </sect3>
433
434 <sect3>
435 <title>Configuration Information</title>
436
437 <para>
438 Typically, there's no configuration required for the system-wide files
439 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
440 directory is empty unless you copied the default files as mentioned
441 above). Configuration can be accomplished by choosing the configuration
442 button located on the <application>MPlayer</application> GUI. Any
443 configuration changes made in the GUI will be saved in the user's
444 <filename class='directory'>~/.mplayer</filename> directory.
445 </para>
446
447 </sect3>
448
449 </sect2>
450
451 <sect2 role="content">
452 <title>Contents</title>
453
454 <segmentedlist>
455 <segtitle>Installed Programs</segtitle>
456 <segtitle>Installed Libraries</segtitle>
457 <segtitle>Installed Directories</segtitle>
458
459 <seglistitem>
460 <seg>
461 gmplayer, mplayer and mencoder
462 </seg>
463 <seg>
464 None
465 </seg>
466 <seg>
467 /etc/mplayer,
468 /usr/share/doc/mplayer-&mplayer-version; and
469 /usr/share/mplayer
470 </seg>
471 </seglistitem>
472 </segmentedlist>
473
474 <variablelist>
475 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
476 <?dbfo list-presentation="list"?>
477 <?dbhtml list-presentation="table"?>
478
479 <varlistentry id="gmplayer">
480 <term><command>gmplayer</command></term>
481 <listitem>
482 <para>
483 is a symlink to <command>mplayer</command> which brings up the
484 GTK+ 2 frontend of <application>MPlayer</application>.
485 </para>
486 <indexterm zone="mplayer gmplayer">
487 <primary sortas="b-gmplayer">gmplayer</primary>
488 </indexterm>
489 </listitem>
490 </varlistentry>
491
492 <varlistentry id="mplayer-prog">
493 <term><command>mplayer</command></term>
494 <listitem>
495 <para> is the main MPlayer video player.</para>
496 <indexterm zone="mplayer mplayer-prog">
497 <primary sortas="b-mplayer">mplayer</primary>
498 </indexterm>
499 </listitem>
500 </varlistentry>
501
502 <varlistentry id="mencoder">
503 <term><command>mencoder</command></term>
504 <listitem>
505 <para>
506 is a powerful command line video decoding, encoding and filtering
507 tool that is useful for (amongst other things) ripping DVDs to files
508 on your hard disk (see
509 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
510 </para>
511 <indexterm zone="mplayer mencoder">
512 <primary sortas="b-mencoder">mencoder</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517 </variablelist>
518
519 </sect2>
520
521</sect1>
Note: See TracBrowser for help on using the repository browser.