source: multimedia/videoutils/mplayer.xml

trunk
Last change on this file was 0c848d7, checked in by Xi Ruoyao <xry111@…>, 3 weeks ago

bookwide: Replace most references to "alsa" with "alsa-lib"

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