source: multimedia/videoutils/mplayer.xml@ 2415b944

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 2415b944 was 2415b944, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Fix mplayer-1.5 FTBFS with binutils-2.41

There are actually two patches for MPlayer-1.5 needed related to ffmpeg.
One is also related to binutils-2.41.
This fix adds those patches and fixes ticket #18381.
  • Property mode set to 100644
File size: 19.2 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 &lfs120_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-va-gl"/>
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://www.xmms.org/">XMMS</ulink>
163 </para>
164
165 <bridgehead renderas="sect4">Optional Audio Output Drivers and Libraries</bridgehead>
166 <para role="optional">
167 <xref linkend="alsa"/>,
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/sid/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://sourceforge.net/projects/opencore-amr/">OpenCore
215 Adaptive Multi Rate</ulink>,
216<!-- <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>,-->
217 <ulink url="https://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
218 <ulink url="https://wiki.xiph.org/Tremor">Tremor</ulink>, and
219 <ulink url="https://sourceforge.net/projects/twolame/">TwoLAME</ulink>
220 </para>
221
222 <bridgehead renderas="sect4">Optional Miscellaneous Dependencies</bridgehead>
223 <para role="optional">
224 <xref linkend="fontconfig"/>,
225 <xref linkend="freetype2"/>,
226 <xref linkend="fribidi"/>,
227 <xref linkend="gnutls"/>,
228 <!-- <xref linkend="openssl"/>, only valid for samba3 at this time -->
229 <xref linkend="opus"/>, and
230 <xref linkend="unrar"/>;
231 <xref linkend="libxslt"/>,
232 <xref linkend="DocBook"/> and
233 <xref linkend="docbook-xsl"/> (all three required to build the HTML documentation); and
234 <ulink url="https://cihar.com/software/enca/">Enca</ulink>,
235 <!--LADSPA plugins and other sites of the maintainer are down.
236 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,-->
237 <ulink url="https://sourceforge.net/projects/bs2b/">libbs2b</ulink>, and
238 <ulink url="https://www.lirc.org/">LIRC</ulink> (and
239 <ulink url="http://www.dolda2000.com/~fredrik/lirccd/">LIRC Client Daemon</ulink>)
240 </para>
241
242 </sect2>
243
244 <sect2 role="installation">
245 <title>Installation of MPlayer</title>
246
247 <sect3>
248 <title>Main MPlayer Installation</title>
249
250 <para>
251 There are two patches related to <xref linkend="ffmpeg"/>
252 that need to be applied. Do that now:
253 </para>
254
255<screen><userinput>patch -Np1 -i ../MPlayer-1.5-upstream_ffmpg6_fixes-1.patch &amp;&amp;
256patch -Np1 -d ffmpeg -i ../ffmpeg-6.0-binutils_2.41-1.patch</userinput></screen>
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 --enable-menu \
282 --enable-runtime-cpudetection \
283 --enable-gui &amp;&amp;
284make</userinput></screen>
285
286 <para>
287 If you wish to build the HTML documentation, issue the
288 following command:
289 </para>
290
291<screen><userinput>make doc</userinput></screen>
292
293 <para>
294 This package does not come with a test suite.
295 </para>
296
297 <para>
298 Now, as the <systemitem class="username">root</systemitem> user:
299 </para>
300
301<screen role="root"><userinput>make install &amp;&amp;
302ln -svf ../icons/hicolor/48x48/apps/mplayer.png \
303 /usr/share/pixmaps/mplayer.png</userinput></screen>
304
305 <para>
306 To install the HTML documentation, issue the following commands as the
307 <systemitem class="username">root</systemitem> user:
308 </para>
309
310<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
311install -v -m644 DOCS/HTML/en/* \
312 /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
313
314 <para>
315 You will only need <filename>codecs.conf</filename> if you want to
316 change its properties, as the main binary contains an internal copy of
317 it. Ensure any changes you make to <filename>codecs.conf</filename>
318 achieve the desired results, as incorrect entries in this file have been
319 known to cause errors and render the player unusable. If necessary,
320 create the file as the <systemitem class="username">root</systemitem>
321 user:
322 </para>
323
324<screen role="root"><userinput>install -v -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
325
326 <para>
327 You may alternatively want to copy all the default configuration files
328 to <filename class='directory'>/etc/mplayer</filename> for future
329 reference or more customization ability. As the
330 <systemitem class="username">root</systemitem> user:
331 </para>
332
333<screen role="root"><userinput>install -v -m644 etc/*.conf /etc/mplayer</userinput></screen>
334
335 </sect3>
336
337 <sect3>
338 <title>Skin Installation (Optional)</title>
339
340 <para>
341 To enable the Gtk+ 2 frontend of <application>MPlayer</application>,
342 you'll need to install at least one skin. Extract the desired skin and
343 create the default location (as the
344 <systemitem class="username">root</systemitem> user):
345 </para>
346
347<screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.bz2 \
348 -C /usr/share/mplayer/skins &amp;&amp;
349ln -sfvn Clearlooks /usr/share/mplayer/skins/default</userinput></screen>
350
351 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
352 href="../../xincludes/update-icons-and-desktop.xml"/>
353
354 </sect3>
355 </sect2>
356
357 <sect2 role="commands">
358 <title>Command Explanations</title>
359
360 <para>
361 <parameter>--enable-gui</parameter>: This option builds the GUI interface
362 into <command>mplayer</command>.
363 </para>
364
365 <para>
366 <parameter>--enable-menu</parameter>: This option is set to enable the
367 on-screen display.
368 </para>
369
370 <para>
371 <parameter>--enable-runtime-cpudetection</parameter>: This option makes
372 MPlayer run with a generic CPU type, preventing optimizations that may
373 cause runtime problems.
374 </para>
375
376 <para>
377 <option>--disable-ffmpeg_a</option>: You can use this option if you have
378 installed a version of ffmpeg prior to ffmpeg-6.0. This
379 version of MPlayer is incompatible with the latest version of ffmpeg.
380 MPlayer does include a copy of the FFmpeg
381 source and without this option it will statically compile the included
382 version of FFmpeg into itself. Dynamically linking to a system installed
383 FFmpeg makes MPlayer and Mencoder about 9MB smaller. <!--If MPlayer exhibits
384 unstable behavior linked to a system installed FFmpeg, try recompiling MPlayer
385 without this option (it is always more thoroughly tested with the included
386 FFmpeg).-->
387 </para>
388
389 <para>
390 <parameter>--disable-libmpeg2-internal</parameter>: This option makes
391 MPlayer run with a system version of libmpeg2.
392 </para>
393
394 <para>
395 <option>--language-doc="<replaceable>&lt;lang&gt;</replaceable>"</option>:
396 This switch sets the language used for the documentation. Use
397 <command>./configure --help</command> for more information.
398 </para>
399
400 <para>
401 <option>--language-man="<replaceable>&lt;lang&gt;</replaceable>"</option>:
402 This switch sets the language used for the man pages. Use
403 <command>./configure --help</command> for more information.
404 </para>
405
406 <para>
407 <option>--language-msg="<replaceable>&lt;lang&gt;</replaceable>"</option>:
408 This switch sets the language used for messages and the GUI. Use
409 <command>./configure --help</command> for more information
410 </para>
411
412 <para>
413 <option>--language="<replaceable>&lt;lang&gt;</replaceable>"</option>:
414 This switch sets the default language used. Use <command>./configure
415 --help</command> for more information.
416 </para>
417
418 <note>
419 <para>
420 Specific options override --language. You can pass a list of
421 languages separated by whitespace or commas instead of a single
422 language. Nonexisting translations will be dropped from each list.
423 All documentation and man page translations available in the list
424 will be installed, for the messages the first available translation
425 will be used. The value "all" will activate all translations. The
426 LINGUAS environment variable is honored. In all cases the fallback is
427 English. Values listed by <command>./configure --help</command> are
428 not all available, as would normally be expected. You need to build
429 test.
430 </para>
431 </note>
432
433 </sect2>
434
435 <sect2 role="configuration">
436 <title>Configuring MPlayer</title>
437
438 <sect3 id="mplayer-config">
439 <title>Config Files</title>
440
441 <para>
442 <filename>/etc/mplayer/*</filename> and
443 <filename>~/.mplayer/*</filename>
444 </para>
445
446 <note>
447 <para>
448 To play a DVD, it may be useful to ensure a /dev/dvd
449 device is created. You may need to set this up as described in
450 <xref linkend="dev-dvd"/>.
451 </para>
452 </note>
453
454 <indexterm zone="mplayer mplayer-config">
455 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
456 </indexterm>
457
458 <indexterm zone="mplayer mplayer-config">
459 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
460 </indexterm>
461 </sect3>
462
463 <sect3>
464 <title>Configuration Information</title>
465
466 <para>
467 Typically, there's no configuration required for the system-wide files
468 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
469 directory is empty unless you copied the default files as mentioned
470 above). Configuration can be accomplished by choosing the configuration
471 button located on the <application>MPlayer</application> GUI. Any
472 configuration changes made in the GUI will be saved in the user's
473 <filename class='directory'>~/.mplayer</filename> directory.
474 </para>
475
476 </sect3>
477
478 </sect2>
479
480 <sect2 role="content">
481 <title>Contents</title>
482
483 <segmentedlist>
484 <segtitle>Installed Programs</segtitle>
485 <segtitle>Installed Libraries</segtitle>
486 <segtitle>Installed Directories</segtitle>
487
488 <seglistitem>
489 <seg>
490 gmplayer, mplayer and mencoder
491 </seg>
492 <seg>
493 None
494 </seg>
495 <seg>
496 /etc/mplayer,
497 /usr/share/doc/mplayer-&mplayer-version; and
498 /usr/share/mplayer
499 </seg>
500 </seglistitem>
501 </segmentedlist>
502
503 <variablelist>
504 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
505 <?dbfo list-presentation="list"?>
506 <?dbhtml list-presentation="table"?>
507
508 <varlistentry id="gmplayer">
509 <term><command>gmplayer</command></term>
510 <listitem>
511 <para>
512 is a symlink to <command>mplayer</command> which brings up the
513 GTK+ 2 frontend of <application>MPlayer</application>
514 </para>
515 <indexterm zone="mplayer gmplayer">
516 <primary sortas="b-gmplayer">gmplayer</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="mplayer-prog">
522 <term><command>mplayer</command></term>
523 <listitem>
524 <para>
525 is the main MPlayer video player
526 </para>
527 <indexterm zone="mplayer mplayer-prog">
528 <primary sortas="b-mplayer">mplayer</primary>
529 </indexterm>
530 </listitem>
531 </varlistentry>
532
533 <varlistentry id="mencoder">
534 <term><command>mencoder</command></term>
535 <listitem>
536 <para>
537 is a powerful command line video decoding, encoding and filtering
538 tool that is useful for (amongst other things) ripping DVDs to files
539 on your hard disk (see
540 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
541 </para>
542 <indexterm zone="mplayer mencoder">
543 <primary sortas="b-mencoder">mencoder</primary>
544 </indexterm>
545 </listitem>
546 </varlistentry>
547
548 </variablelist>
549
550 </sect2>
551
552</sect1>
Note: See TracBrowser for help on using the repository browser.