source: multimedia/videoutils/mplayer.xml@ 9414365d

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 9414365d was 14891a90, checked in by Xi Ruoyao <xry111@…>, 12 months ago

treewide: More "User Notes" clean up

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