source: multimedia/videoutils/mplayer.xml@ c6b192c

11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since c6b192c was c6b192c, checked in by Xi Ruoyao <xry111@…>, 6 months ago

secure package download URLs

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24436 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 18.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 <!ENTITY mplayer-download-http "http://www.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.xz">
8 <!ENTITY mplayer-download-ftp "ftp://ftp.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.xz">
9 <!ENTITY mplayer-md5sum "58d39f72bf7f3ddaa9e019224bffcb74">
10 <!ENTITY mplayer-size "14 MB">
11 <!ENTITY mplayer-buildsize "207 MB">
12 <!ENTITY mplayer-time "1.4 SBU (Using parallelism=4)">
13
14 <!ENTITY mplayer-skin "Clearlooks-2.0">
15 <!ENTITY mplayer-skin-download-http "https://www.mplayerhq.hu/MPlayer/skins/&mplayer-skin;.tar.bz2">
16 <!ENTITY mplayer-skin-download-ftp "ftp://ftp.mplayerhq.hu/MPlayer/skins/&mplayer-skin;.tar.bz2">
17 <!ENTITY mplayer-skin-md5sum "c82d4dbd7f0c36dfecd63dff972807c5">
18 <!ENTITY mplayer-skin-size "34 KB">
19]>
20
21<sect1 id="mplayer" xreflabel="MPlayer-&mplayer-version;">
22 <?dbhtml filename="mplayer.html"?>
23
24 <sect1info>
25 <othername>$LastChangedBy$</othername>
26 <date>$Date$</date>
27 </sect1info>
28
29 <title>MPlayer-&mplayer-version;</title>
30
31 <indexterm zone="mplayer">
32 <primary sortas="a-MPlayer">MPlayer</primary>
33 </indexterm>
34
35 <sect2 role="package">
36 <title>Introduction to MPlayer</title>
37
38 <para>
39 <application>MPlayer</application> is a powerful audio/video player
40 controlled via the command line or a graphical interface that is able to
41 play almost every popular audio and video file format. With supported
42 video hardware and additional drivers, <application>MPlayer</application>
43 can play video files without an <application>X Window System</application>
44 installed.
45 </para>
46
47 &lfs101_checked;
48
49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
52 <para>
53 Download (HTTP): <ulink url="&mplayer-download-http;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download (FTP): <ulink url="&mplayer-download-ftp;"/>
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download MD5 sum: &mplayer-md5sum;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Download size: &mplayer-size;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated disk space required: &mplayer-buildsize;
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Estimated build time: &mplayer-time;
79 </para>
80 </listitem>
81 </itemizedlist>
82 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
83<!--
84 <itemizedlist spacing='compact'>
85 <title>Required Patch</title>
86 <listitem>
87 <para>
88 <ulink url="&patch-root;/MPlayer-1.3.0-x264_fix-1.patch"/>
89 </para>
90 </listitem>
91 </itemizedlist>
92-->
93 <itemizedlist spacing='compact'>
94 <title>Skins</title>
95 <listitem>
96 <para>
97 GUI skin (HTTP): <ulink url="&mplayer-skin-download-http;"/>
98 </para>
99 </listitem>
100 <listitem>
101 <para>
102 GUI skin (FTP): <ulink url="&mplayer-skin-download-ftp;"/>
103 </para>
104 </listitem>
105 <listitem>
106 <para>
107 Skin MD5 sum: &mplayer-skin-md5sum;
108 </para>
109 </listitem>
110 <listitem>
111 <para>
112 Skin size: &mplayer-skin-size;
113 </para>
114 </listitem>
115 <listitem>
116 <para>
117 Alternative skins:
118 <ulink url="https://www.mplayerhq.hu/MPlayer/skins/"/>
119 </para>
120 </listitem>
121 </itemizedlist>
122
123 <note>
124 <para>
125 Skins are only required in order to use the
126 <application>Gtk+ 2</application> user interface.
127 </para>
128 </note>
129
130 <bridgehead renderas="sect3">MPlayer Dependencies</bridgehead>
131
132 <bridgehead renderas="sect4">Required</bridgehead>
133 <para role="required">
134 <xref linkend="yasm"/>
135 </para>
136
137 <bridgehead renderas="sect4">Recommended</bridgehead>
138 <para role="recommended">
139 <xref linkend="gtk2"/> and
140 <xref linkend="libvdpau-va-gl"/>
141 </para>
142
143 <bridgehead renderas="sect4">Optional Input Drivers and Libraries</bridgehead>
144 <para role="optional">
145 <xref linkend="cdparanoia"/>,
146 <xref linkend="libcdio"/> (to identify and play CDs),
147 <xref linkend="libdvdread"/>,
148 <xref linkend="libdvdnav"/>,
149 <xref linkend="libdvdcss"/>,
150 <xref linkend="samba"/>,
151 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
152 <ulink url="http://www.live555.com/">LIVE555 Streaming Media</ulink>,
153 <ulink url="http://rtmpdump.mplayerhq.hu/">RTMPDump</ulink>,
154 <ulink url="http://tivo-mplayer.sourceforge.net/mythtivo.html">TiVo vstream client</ulink>, and
155 <ulink url="http://www.xmms.org/">XMMS</ulink>
156 </para>
157
158 <bridgehead renderas="sect4">Optional Audio Output Drivers and Libraries</bridgehead>
159 <para role="optional">
160 <xref linkend="alsa"/>,
161 <xref linkend="pulseaudio"/>,
162 <xref linkend="sdl"/>,
163 <ulink url="http://jackaudio.org/">JACK</ulink>,
164 <ulink url="http://www.radscan.com/nas.html">NAS</ulink>, and
165 <ulink url="http://kcat.strangesoft.net/openal-releases/">OpenAL</ulink>
166 </para>
167
168 <bridgehead renderas="sect4">Optional Video Output Drivers and Libraries</bridgehead>
169 <para role="optional">
170 <xref linkend="aalib"/>,
171 <xref linkend="giflib"/>,
172 <xref linkend="libjpeg"/>,
173 <xref linkend="libmng"/>,
174 <xref linkend="libpng"/>,
175 <ulink url="https://sourceforge.net/projects/openjpeg.mirror/files/">OpenJPEG1</ulink>
176 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
177 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/libcaca/">libcaca</ulink>, and
178 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>
179 </para>
180
181 <bridgehead renderas="sect4">Optional CODECs</bridgehead>
182 <para role="optional">
183 <!-- includes its own version of FFmpeg which is the recommended one by
184 the devs <xref linkend="ffmpeg"/>, -->
185 <xref linkend="faac"/>,
186 <xref linkend="faad2"/>,
187 <xref linkend="lame"/>,
188 <xref linkend="liba52"/>,
189 <xref linkend="libdv"/>,
190 <xref linkend="libmad"/>,
191 <xref linkend="libmpeg2"/>,
192 <xref linkend="libtheora"/>,
193 <xref linkend="libvpx"/>,
194 <xref linkend="lzo"/>,
195 <xref linkend="mpg123"/>,
196 <xref linkend="speex"/>,
197 <xref linkend="xvid"/>,
198 <xref linkend="x264"/>,
199 <ulink url="https://www.broadcom.com/support/crystal-hd">CrystalHD</ulink>,
200<!-- <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,-->
201 <ulink url="https://sourceforge.net/projects/dirac/">Dirac</ulink>,
202 <ulink url="http://www.quut.com/gsm/">GSM</ulink>,
203 <ulink url="http://www.ilbcfreeware.org/">iLBC</ulink>,
204 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
205 <ulink url="http://wiki.multimedia.cx/index.php?title=NUT">libnut</ulink>,
206 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
207 <ulink url="https://sourceforge.net/projects/opencore-amr/">OpenCore
208 Adaptive Multi Rate</ulink>,
209<!-- <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>,-->
210 <ulink url="https://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
211 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>, and
212 <ulink url="https://sourceforge.net/projects/twolame/">TwoLAME</ulink>
213 </para>
214
215 <bridgehead renderas="sect4">Optional Miscellaneous Dependencies</bridgehead>
216 <para role="optional">
217 <xref linkend="fontconfig"/>,
218 <xref linkend="freetype2"/>,
219 <xref linkend="fribidi"/>,
220 <xref linkend="gnutls"/>,
221 <!-- <xref linkend="openssl"/>, only valid for samba3 at this time -->
222 <xref linkend="opus"/>, and
223 <xref linkend="unrar"/>;
224 <xref linkend="libxslt"/>,
225 <xref linkend="DocBook"/> and
226 <xref linkend="docbook-xsl"/> (all three required to build the HTML documentation); and
227 <ulink url="http://cihar.com/software/enca/">Enca</ulink>,
228 <!--LADSPA plugins and other sites of the maintainer are down.
229 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,-->
230 <ulink url="https://sourceforge.net/projects/bs2b/">libbs2b</ulink>, and
231 <ulink url="http://www.lirc.org/">LIRC</ulink> (and
232 <ulink url="http://www.dolda2000.com/~fredrik/lirccd/">LIRC Client Daemon</ulink>)
233 </para>
234
235 <para condition="html" role="usernotes">
236 User Notes: <ulink url="&blfs-wiki;/mplayer"/>
237 </para>
238 </sect2>
239
240 <sect2 role="installation">
241 <title>Installation of MPlayer</title>
242
243 <sect3>
244 <title>Main MPlayer Installation</title>
245
246 <note>
247 <para>
248 The package maintainers recommend building without any
249 optimizations.
250 </para>
251 </note>
252
253 <para>
254 You may wish to examine the output from
255 <command>./configure --help</command> to find out what additional
256 parameters to <command>configure</command> are needed to include the
257 dependencies you have installed on your system.
258 </para>
259
260 <para>
261 Install <application>MPlayer</application> by running the following
262 commands:
263 </para>
264
265<screen><userinput>./configure --prefix=/usr \
266 --confdir=/etc/mplayer \
267 --enable-dynamic-plugins \
268 --enable-menu \
269 --enable-gui &amp;&amp;
270make</userinput></screen>
271
272 <para>
273 If you wish to build the HTML documentation, issue the
274 following command:
275 </para>
276
277<screen><userinput>make doc</userinput></screen>
278
279 <para>
280 This package does not come with a test suite.
281 </para>
282
283 <para>
284 Now, as the <systemitem class="username">root</systemitem> user:
285 </para>
286
287<screen role="root"><userinput>make install &amp;&amp;
288ln -svf ../icons/hicolor/48x48/apps/mplayer.png \
289 /usr/share/pixmaps/mplayer.png</userinput></screen>
290
291 <para>
292 To install the HTML documentation, issue the following commands as the
293 <systemitem class="username">root</systemitem> user:
294 </para>
295
296<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
297install -v -m644 DOCS/HTML/en/* \
298 /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
299
300 <para>
301 You will only need <filename>codecs.conf</filename> if you want to
302 change its properties, as the main binary contains an internal copy of
303 it. Ensure any changes you make to <filename>codecs.conf</filename>
304 achieve the desired results, as incorrect entries in this file have been
305 known to cause errors and render the player unusable. If necessary,
306 create the file as the <systemitem class="username">root</systemitem>
307 user:
308 </para>
309
310<screen role="root"><userinput>install -v -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
311
312 <para>
313 You may alternatively want to copy all the default configuration files
314 to <filename class='directory'>/etc/mplayer</filename> for future
315 reference or more customization ability. As the
316 <systemitem class="username">root</systemitem> user:
317 </para>
318
319<screen role="root"><userinput>install -v -m644 etc/*.conf /etc/mplayer</userinput></screen>
320
321 </sect3>
322
323 <sect3>
324 <title>Skin Installation (Optional)</title>
325
326 <para>
327 To enable the Gtk+ 2 frontend of <application>MPlayer</application>,
328 you'll need to install at least one skin. Extract the desired skin and
329 create the default location (as the
330 <systemitem class="username">root</systemitem> user):
331 </para>
332
333<screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.bz2 \
334 -C /usr/share/mplayer/skins &amp;&amp;
335ln -sfvn Clearlooks /usr/share/mplayer/skins/default</userinput></screen>
336
337 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
338 href="../../xincludes/update-icons-and-desktop.xml"/>
339
340 </sect3>
341 </sect2>
342
343 <sect2 role="commands">
344 <title>Command Explanations</title>
345
346 <para>
347 <parameter>--enable-gui</parameter>: This option builds the GUI interface
348 into <command>mplayer</command>.
349 </para>
350
351 <para>
352 <parameter>--enable-menu</parameter>: This option is set to enable the
353 on-screen display.
354 </para>
355<!--Currently broken
356 <para>
357 <option>-\-disable-ffmpeg_a</option>: You can use this option if you have
358 installed <xref linkend="ffmpeg"/>. MPlayer includes a copy of the FFmpeg
359 source and without this option it will statically compile the included
360 version of FFmpeg into itself. Dynamically linking to a system installed
361 FFmpeg makes MPlayer and Mencoder about 9MB smaller. If MPlayer exhibits
362 unstable behavior linked to a system installed FFmpeg, try recompiling MPlayer
363 without this option (it is always more thoroughly tested with the included
364 FFmpeg).
365 </para>-->
366
367 <para>
368 <option>--language-doc="<replaceable>&lt;lang&gt;</replaceable>"</option>:
369 This switch enables the language used for the documentation. Use
370 <command>./configure --help</command> to find out what additional
371 information.
372 </para>
373
374 <para>
375 <option>--language-man="<replaceable>&lt;lang&gt;</replaceable>"</option>:
376 This switch enables the language used for the man pages. Use
377 <command>./configure --help</command> to find out what additional
378 information.
379 </para>
380
381 <para>
382 <option>--language-msg="<replaceable>&lt;lang&gt;</replaceable>"</option>:
383 This switch enables the language used for the messages and the GUI. Use
384 <command>./configure --help</command> to find out what additional
385 information.
386 </para>
387
388 <para>
389 <option>--language="<replaceable>&lt;lang&gt;</replaceable>"</option>:
390 This switch defines the default language used. Use <command>./configure
391 --help</command> to find out what additional information.
392 </para>
393
394 <note>
395 <para>
396 Specific options override --language. You can pass a list of
397 languages separated by whitespace or commas instead of a single
398 language. Nonexisting translations will be dropped from each list.
399 All documentation and man page translations available in the list
400 will be installed, for the messages the first available translation
401 will be used. The value "all" will activate all translations. The
402 LINGUAS environment variable is honored. In all cases the fallback is
403 English. Values listed by <command>./configure --help</command> are
404 not all available, as would normally be expected. You need to build
405 test.
406 </para>
407 </note>
408
409 </sect2>
410
411 <sect2 role="configuration">
412 <title>Configuring MPlayer</title>
413
414 <sect3 id="mplayer-config">
415 <title>Config Files</title>
416
417 <para>
418 <filename>/etc/mplayer/*</filename> and
419 <filename>~/.mplayer/*</filename>
420 </para>
421
422 <note>
423 <para>
424 To play a DVD, it may be useful to ensure a /dev/dvd
425 device is created. You may need to set this up as described in
426 <xref linkend="dev-dvd"/>.
427 </para>
428 </note>
429
430 <indexterm zone="mplayer mplayer-config">
431 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
432 </indexterm>
433
434 <indexterm zone="mplayer mplayer-config">
435 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
436 </indexterm>
437 </sect3>
438
439 <sect3>
440 <title>Configuration Information</title>
441
442 <para>
443 Typically, there's no configuration required for the system-wide files
444 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
445 directory is empty unless you copied the default files as mentioned
446 above). Configuration can be accomplished by choosing the configuration
447 button located on the <application>MPlayer</application> GUI. Any
448 configuration changes made in the GUI will be saved in the user's
449 <filename class='directory'>~/.mplayer</filename> directory.
450 </para>
451
452 </sect3>
453
454 </sect2>
455
456 <sect2 role="content">
457 <title>Contents</title>
458
459 <segmentedlist>
460 <segtitle>Installed Programs</segtitle>
461 <segtitle>Installed Libraries</segtitle>
462 <segtitle>Installed Directories</segtitle>
463
464 <seglistitem>
465 <seg>
466 gmplayer, mplayer and mencoder
467 </seg>
468 <seg>
469 None
470 </seg>
471 <seg>
472 /etc/mplayer,
473 /usr/share/doc/mplayer-&mplayer-version; and
474 /usr/share/mplayer
475 </seg>
476 </seglistitem>
477 </segmentedlist>
478
479 <variablelist>
480 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
481 <?dbfo list-presentation="list"?>
482 <?dbhtml list-presentation="table"?>
483
484 <varlistentry id="gmplayer">
485 <term><command>gmplayer</command></term>
486 <listitem>
487 <para>
488 is a symlink to <command>mplayer</command> which brings up the
489 GTK+ 2 frontend of <application>MPlayer</application>
490 </para>
491 <indexterm zone="mplayer gmplayer">
492 <primary sortas="b-gmplayer">gmplayer</primary>
493 </indexterm>
494 </listitem>
495 </varlistentry>
496
497 <varlistentry id="mplayer-prog">
498 <term><command>mplayer</command></term>
499 <listitem>
500 <para>
501 is the main MPlayer video player
502 </para>
503 <indexterm zone="mplayer mplayer-prog">
504 <primary sortas="b-mplayer">mplayer</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508
509 <varlistentry id="mencoder">
510 <term><command>mencoder</command></term>
511 <listitem>
512 <para>
513 is a powerful command line video decoding, encoding and filtering
514 tool that is useful for (amongst other things) ripping DVDs to files
515 on your hard disk (see
516 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
517 </para>
518 <indexterm zone="mplayer mencoder">
519 <primary sortas="b-mencoder">mencoder</primary>
520 </indexterm>
521 </listitem>
522 </varlistentry>
523
524 </variablelist>
525
526 </sect2>
527
528</sect1>
Note: See TracBrowser for help on using the repository browser.