source: multimedia/videoutils/mplayer.xml@ c7f6da36

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 c7f6da36 was e1e58be, checked in by Pierre Labastie <pierre.labastie@…>, 9 months ago

Remove all ftp urls

neither firefox nor epiphany can download them, and they are not
well maintained, because rarely tested.
This is WIP because the "(HTTP)" part of "Download (HTTP)" will
need to be removed too.
But let's see what users think first...
  • 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 " ">
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 &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<!-- if using "patch -d", the change of directory is done before
256 applying -i, so that the patch is not in "..". Use "<" in this case. -->
257<screen><userinput>patch -Np1 -i ../MPlayer-1.5-upstream_ffmpg6_fixes-1.patch &amp;&amp;
258patch -Np1 -d ffmpeg &lt; ../ffmpeg-6.0-binutils_2.41-1.patch</userinput></screen>
259
260 <note>
261 <para>
262 The package maintainers recommend building without any
263 optimizations.
264 </para>
265 </note>
266
267 <para>
268 You may wish to examine the output from
269 <command>./configure --help</command> to find out what additional
270 parameters to <command>configure</command> are needed to include the
271 dependencies you have installed on your system.
272 </para>
273
274 <para>
275 Install <application>MPlayer</application> by running the following
276 commands:
277 </para>
278
279<screen><userinput>./configure --prefix=/usr \
280 --confdir=/etc/mplayer \
281 --enable-dynamic-plugins \
282 --disable-libmpeg2-internal \
283 --enable-menu \
284 --enable-runtime-cpudetection \
285 --enable-gui &amp;&amp;
286make</userinput></screen>
287
288 <para>
289 If you wish to build the HTML documentation, issue the
290 following command:
291 </para>
292
293<screen><userinput>make doc</userinput></screen>
294
295 <para>
296 This package does not come with a test suite.
297 </para>
298
299 <para>
300 Now, as the <systemitem class="username">root</systemitem> user:
301 </para>
302
303<screen role="root"><userinput>make install &amp;&amp;
304ln -svf ../icons/hicolor/48x48/apps/mplayer.png \
305 /usr/share/pixmaps/mplayer.png</userinput></screen>
306
307 <para>
308 To install the HTML documentation, issue the following commands as the
309 <systemitem class="username">root</systemitem> user:
310 </para>
311
312<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
313install -v -m644 DOCS/HTML/en/* \
314 /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
315
316 <para>
317 You will only need <filename>codecs.conf</filename> if you want to
318 change its properties, as the main binary contains an internal copy of
319 it. Ensure any changes you make to <filename>codecs.conf</filename>
320 achieve the desired results, as incorrect entries in this file have been
321 known to cause errors and render the player unusable. If necessary,
322 create the file as the <systemitem class="username">root</systemitem>
323 user:
324 </para>
325
326<screen role="root"><userinput>install -v -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
327
328 <para>
329 You may alternatively want to copy all the default configuration files
330 to <filename class='directory'>/etc/mplayer</filename> for future
331 reference or more customization ability. As the
332 <systemitem class="username">root</systemitem> user:
333 </para>
334
335<screen role="root"><userinput>install -v -m644 etc/*.conf /etc/mplayer</userinput></screen>
336
337 </sect3>
338
339 <sect3>
340 <title>Skin Installation (Optional)</title>
341
342 <para>
343 To enable the Gtk+ 2 frontend of <application>MPlayer</application>,
344 you'll need to install at least one skin. Extract the desired skin and
345 create the default location (as the
346 <systemitem class="username">root</systemitem> user):
347 </para>
348
349<screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.bz2 \
350 -C /usr/share/mplayer/skins &amp;&amp;
351ln -sfvn Clearlooks /usr/share/mplayer/skins/default</userinput></screen>
352
353 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
354 href="../../xincludes/update-icons-and-desktop.xml"/>
355
356 </sect3>
357 </sect2>
358
359 <sect2 role="commands">
360 <title>Command Explanations</title>
361
362 <para>
363 <parameter>--enable-gui</parameter>: This option builds the GUI interface
364 into <command>mplayer</command>.
365 </para>
366
367 <para>
368 <parameter>--enable-menu</parameter>: This option is set to enable the
369 on-screen display.
370 </para>
371
372 <para>
373 <parameter>--enable-runtime-cpudetection</parameter>: This option makes
374 MPlayer run with a generic CPU type, preventing optimizations that may
375 cause runtime problems.
376 </para>
377
378 <para>
379 <option>--disable-ffmpeg_a</option>: You can use this option if you have
380 installed a version of ffmpeg prior to ffmpeg-6.0. This
381 version of MPlayer is incompatible with the latest version of ffmpeg.
382 MPlayer does include a copy of the FFmpeg
383 source and without this option it will statically compile the included
384 version of FFmpeg into itself. Dynamically linking to a system installed
385 FFmpeg makes MPlayer and Mencoder about 9MB smaller. <!--If MPlayer exhibits
386 unstable behavior linked to a system installed FFmpeg, try recompiling MPlayer
387 without this option (it is always more thoroughly tested with the included
388 FFmpeg).-->
389 </para>
390
391 <para>
392 <parameter>--disable-libmpeg2-internal</parameter>: This option makes
393 MPlayer run with a system version of libmpeg2.
394 </para>
395
396 <para>
397 <option>--language-doc="<replaceable>&lt;lang&gt;</replaceable>"</option>:
398 This switch sets the language used for the documentation. Use
399 <command>./configure --help</command> for more information.
400 </para>
401
402 <para>
403 <option>--language-man="<replaceable>&lt;lang&gt;</replaceable>"</option>:
404 This switch sets the language used for the man pages. Use
405 <command>./configure --help</command> for more information.
406 </para>
407
408 <para>
409 <option>--language-msg="<replaceable>&lt;lang&gt;</replaceable>"</option>:
410 This switch sets the language used for messages and the GUI. Use
411 <command>./configure --help</command> for more information
412 </para>
413
414 <para>
415 <option>--language="<replaceable>&lt;lang&gt;</replaceable>"</option>:
416 This switch sets the default language used. Use <command>./configure
417 --help</command> for more information.
418 </para>
419
420 <note>
421 <para>
422 Specific options override --language. You can pass a list of
423 languages separated by whitespace or commas instead of a single
424 language. Nonexisting translations will be dropped from each list.
425 All documentation and man page translations available in the list
426 will be installed, for the messages the first available translation
427 will be used. The value "all" will activate all translations. The
428 LINGUAS environment variable is honored. In all cases the fallback is
429 English. Values listed by <command>./configure --help</command> are
430 not all available, as would normally be expected. You need to build
431 test.
432 </para>
433 </note>
434
435 </sect2>
436
437 <sect2 role="configuration">
438 <title>Configuring MPlayer</title>
439
440 <sect3 id="mplayer-config">
441 <title>Config Files</title>
442
443 <para>
444 <filename>/etc/mplayer/*</filename> and
445 <filename>~/.mplayer/*</filename>
446 </para>
447
448 <note>
449 <para>
450 To play a DVD, it may be useful to ensure a /dev/dvd
451 device is created. You may need to set this up as described in
452 <xref linkend="dev-dvd"/>.
453 </para>
454 </note>
455
456 <indexterm zone="mplayer mplayer-config">
457 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
458 </indexterm>
459
460 <indexterm zone="mplayer mplayer-config">
461 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
462 </indexterm>
463 </sect3>
464
465 <sect3>
466 <title>Configuration Information</title>
467
468 <para>
469 Typically, there's no configuration required for the system-wide files
470 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
471 directory is empty unless you copied the default files as mentioned
472 above). Configuration can be accomplished by choosing the configuration
473 button located on the <application>MPlayer</application> GUI. Any
474 configuration changes made in the GUI will be saved in the user's
475 <filename class='directory'>~/.mplayer</filename> directory.
476 </para>
477
478 </sect3>
479
480 </sect2>
481
482 <sect2 role="content">
483 <title>Contents</title>
484
485 <segmentedlist>
486 <segtitle>Installed Programs</segtitle>
487 <segtitle>Installed Libraries</segtitle>
488 <segtitle>Installed Directories</segtitle>
489
490 <seglistitem>
491 <seg>
492 gmplayer, mplayer and mencoder
493 </seg>
494 <seg>
495 None
496 </seg>
497 <seg>
498 /etc/mplayer,
499 /usr/share/doc/mplayer-&mplayer-version; and
500 /usr/share/mplayer
501 </seg>
502 </seglistitem>
503 </segmentedlist>
504
505 <variablelist>
506 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
507 <?dbfo list-presentation="list"?>
508 <?dbhtml list-presentation="table"?>
509
510 <varlistentry id="gmplayer">
511 <term><command>gmplayer</command></term>
512 <listitem>
513 <para>
514 is a symlink to <command>mplayer</command> which brings up the
515 GTK+ 2 frontend of <application>MPlayer</application>
516 </para>
517 <indexterm zone="mplayer gmplayer">
518 <primary sortas="b-gmplayer">gmplayer</primary>
519 </indexterm>
520 </listitem>
521 </varlistentry>
522
523 <varlistentry id="mplayer-prog">
524 <term><command>mplayer</command></term>
525 <listitem>
526 <para>
527 is the main MPlayer video player
528 </para>
529 <indexterm zone="mplayer mplayer-prog">
530 <primary sortas="b-mplayer">mplayer</primary>
531 </indexterm>
532 </listitem>
533 </varlistentry>
534
535 <varlistentry id="mencoder">
536 <term><command>mencoder</command></term>
537 <listitem>
538 <para>
539 is a powerful command line video decoding, encoding and filtering
540 tool that is useful for (amongst other things) ripping DVDs to files
541 on your hard disk (see
542 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
543 </para>
544 <indexterm zone="mplayer mencoder">
545 <primary sortas="b-mencoder">mencoder</primary>
546 </indexterm>
547 </listitem>
548 </varlistentry>
549
550 </variablelist>
551
552 </sect2>
553
554</sect1>
Note: See TracBrowser for help on using the repository browser.