source: multimedia/videoutils/mplayer.xml@ a263b755

11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since a263b755 was a263b755, checked in by Douglas R. Reno <renodr@…>, 15 months ago

Package update and some command explanation tweaking

Update to exiv2-0.27.5
Minor tweaking to command explanations in mplayer.

  • 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 "http://www.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 "887fa9fce21feecbe0f43388d49f4a93">
15 <!ENTITY mplayer-size "5.7 MB">
16 <!ENTITY mplayer-buildsize "207 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 "http://www.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 <sect1info>
30 <date>$Date$</date>
31 </sect1info>
32
33 <title>MPlayer-&mplayer-version;</title>
34
35 <indexterm zone="mplayer">
36 <primary sortas="a-MPlayer">MPlayer</primary>
37 </indexterm>
38
39 <sect2 role="package">
40 <title>Introduction to MPlayer</title>
41
42 <para>
43 <application>MPlayer</application> is a powerful audio/video player
44 controlled via the command line or a graphical interface that is able to
45 play almost every popular audio and video file format. With supported
46 video hardware and additional drivers, <application>MPlayer</application>
47 can play video files without an <application>X Window System</application>
48 installed.
49 </para>
50
51 <note>
52 <para>The latest <quote>stable</quote> version was released in April
53 2019. That version no longer builds properly with the latest build tools
54 and system libraries. The version below is a snapshot that may not be
55 available on the upstream server but was uploaded
56 to our file server. If you want to test a later version, check
57 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/"/>.
58 </para>
59 </note>
60
61 &lfs110a_checked;
62
63 <bridgehead renderas="sect3">Package Information</bridgehead>
64 <itemizedlist spacing="compact">
65 <listitem>
66 <para>
67 Download (HTTP): <ulink url="&mplayer-download-http;"/>
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Download (FTP): <ulink url="&mplayer-download-ftp;"/>
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Download MD5 sum: &mplayer-md5sum;
78 </para>
79 </listitem>
80 <listitem>
81 <para>
82 Download size: &mplayer-size;
83 </para>
84 </listitem>
85 <listitem>
86 <para>
87 Estimated disk space required: &mplayer-buildsize;
88 </para>
89 </listitem>
90 <listitem>
91 <para>
92 Estimated build time: &mplayer-time;
93 </para>
94 </listitem>
95 </itemizedlist>
96 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
97<!--
98 <itemizedlist spacing='compact'>
99 <title>Required Patch</title>
100 <listitem>
101 <para>
102 <ulink url="&patch-root;/MPlayer-1.3.0-x264_fix-1.patch"/>
103 </para>
104 </listitem>
105 </itemizedlist>
106-->
107 <itemizedlist spacing='compact'>
108 <title>Skins</title>
109 <listitem>
110 <para>
111 GUI skin (HTTP): <ulink url="&mplayer-skin-download-http;"/>
112 </para>
113 </listitem>
114 <listitem>
115 <para>
116 GUI skin (FTP): <ulink url="&mplayer-skin-download-ftp;"/>
117 </para>
118 </listitem>
119 <listitem>
120 <para>
121 Skin MD5 sum: &mplayer-skin-md5sum;
122 </para>
123 </listitem>
124 <listitem>
125 <para>
126 Skin size: &mplayer-skin-size;
127 </para>
128 </listitem>
129 <listitem>
130 <para>
131 Alternative skins:
132 <ulink url="https://www.mplayerhq.hu/MPlayer/skins/"/>
133 </para>
134 </listitem>
135 </itemizedlist>
136
137 <note>
138 <para>
139 Skins are only required in order to use the
140 <application>Gtk+ 2</application> user interface.
141 </para>
142 </note>
143
144 <bridgehead renderas="sect3">MPlayer Dependencies</bridgehead>
145
146 <bridgehead renderas="sect4">Required</bridgehead>
147 <para role="required">
148 <xref linkend="yasm"/>
149 </para>
150
151 <bridgehead renderas="sect4">Recommended</bridgehead>
152 <para role="recommended">
153 <xref linkend="ffmpeg"/>,
154 <xref linkend="gtk2"/>, and
155 <xref linkend="libvdpau-va-gl"/>
156 </para>
157
158 <bridgehead renderas="sect4">Optional Input Drivers and Libraries</bridgehead>
159 <para role="optional">
160 <xref linkend="cdparanoia"/>,
161 <xref linkend="libcdio"/> (to identify and play CDs),
162 <xref linkend="libdvdread"/>,
163 <xref linkend="libdvdnav"/>,
164 <xref linkend="libdvdcss"/>,
165 <xref linkend="samba"/>,
166 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
167 <ulink url="http://www.live555.com/">LIVE555 Streaming Media</ulink>,
168 <ulink url="http://rtmpdump.mplayerhq.hu/">RTMPDump</ulink>,
169 <ulink url="http://tivo-mplayer.sourceforge.net/mythtivo.html">TiVo vstream client</ulink>, and
170 <ulink url="http://www.xmms.org/">XMMS</ulink>
171 </para>
172
173 <bridgehead renderas="sect4">Optional Audio Output Drivers and Libraries</bridgehead>
174 <para role="optional">
175 <xref linkend="alsa"/>,
176 <xref linkend="pulseaudio"/>,
177 <xref linkend="sdl"/>,
178 <ulink url="http://jackaudio.org/">JACK</ulink>,
179 <ulink url="http://www.radscan.com/nas.html">NAS</ulink>, and
180 <ulink url="https://openal.org/">OpenAL</ulink>
181 </para>
182
183 <bridgehead renderas="sect4">Optional Video Output Drivers and Libraries</bridgehead>
184 <para role="optional">
185 <xref linkend="aalib"/>,
186 <xref linkend="giflib"/>,
187 <xref linkend="libjpeg"/>,
188 <xref linkend="libmng"/>,
189 <xref linkend="libpng"/>,
190 <ulink url="https://sourceforge.net/projects/openjpeg.mirror/files/">OpenJPEG1</ulink>
191 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
192 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/libcaca/">libcaca</ulink>, and
193 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>
194 </para>
195
196 <bridgehead renderas="sect4">Optional CODECs</bridgehead>
197 <para role="optional">
198 <!-- includes its own version of FFmpeg which is the recommended one by
199 the devs <xref linkend="ffmpeg"/>, -->
200 <xref linkend="faac"/>,
201 <xref linkend="faad2"/>,
202 <xref linkend="lame"/>,
203 <xref linkend="liba52"/>,
204 <xref linkend="libdv"/>,
205 <xref linkend="libmad"/>,
206 <xref linkend="libmpeg2"/>,
207 <xref linkend="libtheora"/>,
208 <xref linkend="libvpx"/>,
209 <xref linkend="lzo"/>,
210 <xref linkend="mpg123"/>,
211 <xref linkend="speex"/>,
212 <xref linkend="xvid"/>,
213 <xref linkend="x264"/>,
214 <ulink url="https://packages.debian.org/source/sid/crystalhd">CrystalHD</ulink>,
215<!-- <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,-->
216 <ulink url="https://sourceforge.net/projects/dirac/">Dirac</ulink>,
217 <ulink url="http://www.quut.com/gsm/">GSM</ulink>,
218 <ulink url="https://webrtc.github.io/webrtc-org/license/ilbc-freeware/">iLBC</ulink>,
219 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
220 <ulink url="http://wiki.multimedia.cx/index.php?title=NUT">libnut</ulink>,
221 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
222 <ulink url="https://sourceforge.net/projects/opencore-amr/">OpenCore
223 Adaptive Multi Rate</ulink>,
224<!-- <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>,-->
225 <ulink url="https://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
226 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>, and
227 <ulink url="https://sourceforge.net/projects/twolame/">TwoLAME</ulink>
228 </para>
229
230 <bridgehead renderas="sect4">Optional Miscellaneous Dependencies</bridgehead>
231 <para role="optional">
232 <xref linkend="fontconfig"/>,
233 <xref linkend="freetype2"/>,
234 <xref linkend="fribidi"/>,
235 <xref linkend="gnutls"/>,
236 <!-- <xref linkend="openssl"/>, only valid for samba3 at this time -->
237 <xref linkend="opus"/>, and
238 <xref linkend="unrar"/>;
239 <xref linkend="libxslt"/>,
240 <xref linkend="DocBook"/> and
241 <xref linkend="docbook-xsl"/> (all three required to build the HTML documentation); and
242 <ulink url="http://cihar.com/software/enca/">Enca</ulink>,
243 <!--LADSPA plugins and other sites of the maintainer are down.
244 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,-->
245 <ulink url="https://sourceforge.net/projects/bs2b/">libbs2b</ulink>, and
246 <ulink url="http://www.lirc.org/">LIRC</ulink> (and
247 <ulink url="http://www.dolda2000.com/~fredrik/lirccd/">LIRC Client Daemon</ulink>)
248 </para>
249
250 <para condition="html" role="usernotes">
251 User Notes: <ulink url="&blfs-wiki;/mplayer"/>
252 </para>
253 </sect2>
254
255 <sect2 role="installation">
256 <title>Installation of MPlayer</title>
257
258 <sect3>
259 <title>Main MPlayer Installation</title>
260
261 <note>
262 <para>
263 The package maintainers recommend building without any
264 optimizations.
265 </para>
266 </note>
267
268 <para>
269 You may wish to examine the output from
270 <command>./configure --help</command> to find out what additional
271 parameters to <command>configure</command> are needed to include the
272 dependencies you have installed on your system.
273 </para>
274
275 <para>
276 Install <application>MPlayer</application> by running the following
277 commands:
278 </para>
279
280<screen><userinput>./configure --prefix=/usr \
281 --confdir=/etc/mplayer \
282 --enable-dynamic-plugins \
283 --disable-libmpeg2-internal \
284 --disable-ffmpeg_a \
285 --enable-menu \
286 --enable-runtime-cpudetection \
287 --enable-gui &amp;&amp;
288make</userinput></screen>
289
290 <para>
291 If you wish to build the HTML documentation, issue the
292 following command:
293 </para>
294
295<screen><userinput>make doc</userinput></screen>
296
297 <para>
298 This package does not come with a test suite.
299 </para>
300
301 <para>
302 Now, as the <systemitem class="username">root</systemitem> user:
303 </para>
304
305<screen role="root"><userinput>make install &amp;&amp;
306ln -svf ../icons/hicolor/48x48/apps/mplayer.png \
307 /usr/share/pixmaps/mplayer.png</userinput></screen>
308
309 <para>
310 To install the HTML documentation, issue the following commands as the
311 <systemitem class="username">root</systemitem> user:
312 </para>
313
314<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
315install -v -m644 DOCS/HTML/en/* \
316 /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
317
318 <para>
319 You will only need <filename>codecs.conf</filename> if you want to
320 change its properties, as the main binary contains an internal copy of
321 it. Ensure any changes you make to <filename>codecs.conf</filename>
322 achieve the desired results, as incorrect entries in this file have been
323 known to cause errors and render the player unusable. If necessary,
324 create the file as the <systemitem class="username">root</systemitem>
325 user:
326 </para>
327
328<screen role="root"><userinput>install -v -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
329
330 <para>
331 You may alternatively want to copy all the default configuration files
332 to <filename class='directory'>/etc/mplayer</filename> for future
333 reference or more customization ability. As the
334 <systemitem class="username">root</systemitem> user:
335 </para>
336
337<screen role="root"><userinput>install -v -m644 etc/*.conf /etc/mplayer</userinput></screen>
338
339 </sect3>
340
341 <sect3>
342 <title>Skin Installation (Optional)</title>
343
344 <para>
345 To enable the Gtk+ 2 frontend of <application>MPlayer</application>,
346 you'll need to install at least one skin. Extract the desired skin and
347 create the default location (as the
348 <systemitem class="username">root</systemitem> user):
349 </para>
350
351<screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.bz2 \
352 -C /usr/share/mplayer/skins &amp;&amp;
353ln -sfvn Clearlooks /usr/share/mplayer/skins/default</userinput></screen>
354
355 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
356 href="../../xincludes/update-icons-and-desktop.xml"/>
357
358 </sect3>
359 </sect2>
360
361 <sect2 role="commands">
362 <title>Command Explanations</title>
363
364 <para>
365 <parameter>--enable-gui</parameter>: This option builds the GUI interface
366 into <command>mplayer</command>.
367 </para>
368
369 <para>
370 <parameter>--enable-menu</parameter>: This option is set to enable the
371 on-screen display.
372 </para>
373
374 <para>
375 <parameter>--enable-runtime-cpudetection</parameter>: This option makes
376 MPlayer run with a generic CPU type, preventing optimizations that may
377 cause runtime problems.
378 </para>
379
380 <para>
381 <option>--disable-ffmpeg_a</option>: You can use this option if you have
382 installed <xref linkend="ffmpeg"/>. <!--MPlayer includes 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.