source: multimedia/videoutils/mplayer.xml@ edb16ce

11.0 qt5new trunk
Last change on this file since edb16ce was edb16ce, checked in by Douglas R. Reno <renodr@…>, 5 months ago

Fix the MPlayer instructions. This includes several URL updates, minor
tweaks to text, and the addition of the --enable-runtime-cpudetection
option to prevent runtime issues.

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