source: multimedia/videoutils/mplayer.xml@ d78e102e

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since d78e102e was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 18 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.
  • Property mode set to 100644
File size: 19.3 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 &lfs112_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="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
164 <ulink url="http://www.live555.com/">LIVE555 Streaming Media</ulink>,
165 <ulink url="http://rtmpdump.mplayerhq.hu/">RTMPDump</ulink>,
166 <ulink url="http://tivo-mplayer.sourceforge.net/mythtivo.html">TiVo vstream client</ulink>, and
167 <ulink url="http://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="http://jackaudio.org/">JACK</ulink>,
176 <ulink url="http://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="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
189 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/libcaca/">libcaca</ulink>, and
190 <ulink url="http://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="http://www.quut.com/gsm/">GSM</ulink>,
215 <ulink url="https://webrtc.github.io/webrtc-org/license/ilbc-freeware/">iLBC</ulink>,
216 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
217 <ulink url="http://wiki.multimedia.cx/index.php?title=NUT">libnut</ulink>,
218 <ulink url="http://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="http://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="http://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="http://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 <xref linkend="ffmpeg"/>. <!--MPlayer includes a copy of the FFmpeg
380 source and without this option it will statically compile the included
381 version of FFmpeg into itself.--> Dynamically linking to a system installed
382 FFmpeg makes MPlayer and Mencoder about 9MB smaller. <!--If MPlayer exhibits
383 unstable behavior linked to a system installed FFmpeg, try recompiling MPlayer
384 without this option (it is always more thoroughly tested with the included
385 FFmpeg).-->
386 </para>
387
388 <para>
389 <parameter>--disable-libmpeg2-internal</parameter>: This option makes
390 MPlayer run with a system version of libmpeg2.
391 </para>
392
393 <para>
394 <option>--language-doc="<replaceable>&lt;lang&gt;</replaceable>"</option>:
395 This switch sets the language used for the documentation. Use
396 <command>./configure --help</command> for more information.
397 </para>
398
399 <para>
400 <option>--language-man="<replaceable>&lt;lang&gt;</replaceable>"</option>:
401 This switch sets the language used for the man pages. Use
402 <command>./configure --help</command> for more information.
403 </para>
404
405 <para>
406 <option>--language-msg="<replaceable>&lt;lang&gt;</replaceable>"</option>:
407 This switch sets the language used for messages and the GUI. Use
408 <command>./configure --help</command> for more information
409 </para>
410
411 <para>
412 <option>--language="<replaceable>&lt;lang&gt;</replaceable>"</option>:
413 This switch sets the default language used. Use <command>./configure
414 --help</command> for more information.
415 </para>
416
417 <note>
418 <para>
419 Specific options override --language. You can pass a list of
420 languages separated by whitespace or commas instead of a single
421 language. Nonexisting translations will be dropped from each list.
422 All documentation and man page translations available in the list
423 will be installed, for the messages the first available translation
424 will be used. The value "all" will activate all translations. The
425 LINGUAS environment variable is honored. In all cases the fallback is
426 English. Values listed by <command>./configure --help</command> are
427 not all available, as would normally be expected. You need to build
428 test.
429 </para>
430 </note>
431
432 </sect2>
433
434 <sect2 role="configuration">
435 <title>Configuring MPlayer</title>
436
437 <sect3 id="mplayer-config">
438 <title>Config Files</title>
439
440 <para>
441 <filename>/etc/mplayer/*</filename> and
442 <filename>~/.mplayer/*</filename>
443 </para>
444
445 <note>
446 <para>
447 To play a DVD, it may be useful to ensure a /dev/dvd
448 device is created. You may need to set this up as described in
449 <xref linkend="dev-dvd"/>.
450 </para>
451 </note>
452
453 <indexterm zone="mplayer mplayer-config">
454 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
455 </indexterm>
456
457 <indexterm zone="mplayer mplayer-config">
458 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
459 </indexterm>
460 </sect3>
461
462 <sect3>
463 <title>Configuration Information</title>
464
465 <para>
466 Typically, there's no configuration required for the system-wide files
467 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
468 directory is empty unless you copied the default files as mentioned
469 above). Configuration can be accomplished by choosing the configuration
470 button located on the <application>MPlayer</application> GUI. Any
471 configuration changes made in the GUI will be saved in the user's
472 <filename class='directory'>~/.mplayer</filename> directory.
473 </para>
474
475 </sect3>
476
477 </sect2>
478
479 <sect2 role="content">
480 <title>Contents</title>
481
482 <segmentedlist>
483 <segtitle>Installed Programs</segtitle>
484 <segtitle>Installed Libraries</segtitle>
485 <segtitle>Installed Directories</segtitle>
486
487 <seglistitem>
488 <seg>
489 gmplayer, mplayer and mencoder
490 </seg>
491 <seg>
492 None
493 </seg>
494 <seg>
495 /etc/mplayer,
496 /usr/share/doc/mplayer-&mplayer-version; and
497 /usr/share/mplayer
498 </seg>
499 </seglistitem>
500 </segmentedlist>
501
502 <variablelist>
503 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
504 <?dbfo list-presentation="list"?>
505 <?dbhtml list-presentation="table"?>
506
507 <varlistentry id="gmplayer">
508 <term><command>gmplayer</command></term>
509 <listitem>
510 <para>
511 is a symlink to <command>mplayer</command> which brings up the
512 GTK+ 2 frontend of <application>MPlayer</application>
513 </para>
514 <indexterm zone="mplayer gmplayer">
515 <primary sortas="b-gmplayer">gmplayer</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519
520 <varlistentry id="mplayer-prog">
521 <term><command>mplayer</command></term>
522 <listitem>
523 <para>
524 is the main MPlayer video player
525 </para>
526 <indexterm zone="mplayer mplayer-prog">
527 <primary sortas="b-mplayer">mplayer</primary>
528 </indexterm>
529 </listitem>
530 </varlistentry>
531
532 <varlistentry id="mencoder">
533 <term><command>mencoder</command></term>
534 <listitem>
535 <para>
536 is a powerful command line video decoding, encoding and filtering
537 tool that is useful for (amongst other things) ripping DVDs to files
538 on your hard disk (see
539 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
540 </para>
541 <indexterm zone="mplayer mencoder">
542 <primary sortas="b-mencoder">mencoder</primary>
543 </indexterm>
544 </listitem>
545 </varlistentry>
546
547 </variablelist>
548
549 </sect2>
550
551</sect1>
Note: See TracBrowser for help on using the repository browser.