source: multimedia/videoutils/mplayer.xml@ 8763a1da

10.0 10.1 11.0 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 8763a1da was 8763a1da, checked in by Fernando de Oliveira <fernando@…>, 6 years ago
  • Update to zsh-5.1.
  • Update to graphite2-1.3.1.
  • Update to tiff-4.0.5.
  • Update to links-2.11.
  • Update to midori_0.5.11.
  • xine-lib, mplayer, links, cairo: s|www.directfb.org|pkgs.fedoraproject.org/repo/pkgs/directfb|.

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

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