source: multimedia/videoutils/mplayer.xml@ 1ef28cd2

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 1ef28cd2 was 050c538, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

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