source: multimedia/videoutils/mplayer.xml@ 95719ab

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 95719ab was 95719ab, checked in by Fernando de Oliveira <fernando@…>, 9 years ago

mplayer-2014-12-19: typo.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@15271 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 "cc32f19f7859dbec0d09134bffc95c85">
12 <!ENTITY mplayer-size "12 MB">
13 <!ENTITY mplayer-buildsize "205 MB<!-- (120 MB using system-installed FFMpeg)-->">
14 <!ENTITY mplayer-time "3.5 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 &lfs76_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="libdvdread"/>,
168 <xref linkend="libdvdnav"/>,
169 <xref linkend="libdvdcss"/>,
170 <xref linkend="samba"/>,
171 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
172 <ulink url="http://www.gnu.org/software/libcdio/">libcdio</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://www.directfb.org/">DirectFB</ulink>,
198<!-- <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>, and-->
199 <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/libcaca/">libcaca</ulink>, and
200 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>
201 </para>
202
203 <bridgehead renderas="sect4">Optional CODECs</bridgehead>
204 <para role="optional">
205 <!-- includes its own version of FFmpeg which is the recommended one by
206 the devs <xref linkend="ffmpeg"/>, -->
207 <xref linkend="faac"/>,
208 <xref linkend="faad2"/>,
209 <xref linkend="lame"/>,
210 <xref linkend="liba52"/>,
211 <xref linkend="libdv"/>,
212 <xref linkend="libmad"/>,
213 <xref linkend="libmpeg2"/>,
214 <xref linkend="libtheora"/>,
215 <xref linkend="libvpx"/>,
216 <xref linkend="lzo"/>,
217 <xref linkend="mpg123"/>,
218 <xref linkend="speex"/>,
219 <xref linkend="xvid"/>,
220 <xref linkend="x264"/>,
221 <ulink url="http://www.broadcom.com/support/crystal_hd/">CrystalHD</ulink>,
222<!-- <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,-->
223 <ulink url="http://sourceforge.net/projects/dirac/">Dirac</ulink>,
224 <ulink url="http://www.quut.com/gsm/">GSM</ulink>,
225 <ulink url="http://www.ilbcfreeware.org/">iLBC</ulink>,
226 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
227 <ulink url="http://wiki.multimedia.cx/index.php?title=NUT">libnut</ulink>,
228 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
229 <ulink url="http://sourceforge.net/projects/opencore-amr/">OpenCore
230 Adaptive Multi Rate</ulink>,
231<!-- <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>,-->
232 <ulink url="http://sourceforge.net/projects/schrodinger/">Schroedinger</ulink>,
233 <ulink url="http://wiki.xiph.org/Tremor">Tremor</ulink>, and
234 <ulink url="http://sourceforge.net/projects/twolame/">TwoLAME</ulink>
235 </para>
236
237 <bridgehead renderas="sect4">Optional Miscellaneous Dependencies</bridgehead>
238 <para role="optional">
239 <xref linkend="fontconfig"/>,
240 <xref linkend="freetype2"/>,
241 <xref linkend="fribidi"/>,
242 <xref linkend="gnutls"/>,
243 <xref linkend="openssl"/>,
244 <xref linkend="opus"/>, and
245 <xref linkend="unrar"/>;
246 <xref linkend="libxslt"/>,
247 <xref linkend="DocBook"/> and
248 <xref linkend="docbook-xsl"/> (all three required to build the HTML documentation); and
249 <ulink url="http://cihar.com/software/enca/">Enca</ulink>,
250 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
251 <ulink url="http://sourceforge.net/projects/bs2b/">libbs2b</ulink>, and
252 <ulink url="http://www.lirc.org/">LIRC</ulink> (and
253 <ulink url="http://www.dolda2000.com/~fredrik/lirccd/">LIRC Client Daemon</ulink>)
254 </para>
255
256 <para condition="html" role="usernotes">
257 User Notes: <ulink url="&blfs-wiki;/mplayer"/>
258 </para>
259 </sect2>
260
261 <sect2 role="installation">
262 <title>Installation of MPlayer</title>
263
264 <sect3>
265 <title>Main MPlayer Installation</title>
266
267 <note>
268 <para>
269 The package maintainers recommend building without any
270 optimizations.
271 </para>
272 </note>
273
274 <para>
275 You may wish to examine the output from
276 <command>./configure --help</command> to find out what additional
277 parameters to <command>configure</command> are needed to include the
278 dependencies you have installed on your system.
279 </para>
280
281 <para>
282 Install <application>MPlayer</application> by running the following
283 commands:
284 </para>
285
286<screen><userinput>sed -i 's:libsmbclient.h:samba-4.0/&amp;:' configure stream/stream_smb.c &amp;&amp;
287
288./configure --prefix=/usr \
289 --confdir=/etc/mplayer \
290 --enable-dynamic-plugins \
291 --enable-menu \
292 --enable-gui &amp;&amp;
293make</userinput></screen>
294
295 <para>
296 If you wish to build the HTML documentation, issue the
297 following command:
298 </para>
299
300<screen><userinput>make doc</userinput></screen>
301
302 <para>
303 This package does not come with a test suite.
304 </para>
305
306 <para>
307 Now, as the <systemitem class="username">root</systemitem> user:
308 </para>
309
310<screen role="root"><userinput>make install &amp;&amp;
311ln -svf ../icons/hicolor/48x48/apps/mplayer.png \
312 /usr/share/pixmaps/mplayer.png</userinput></screen>
313
314 <para>
315 To install the HTML documentation, issue the following commands as the
316 <systemitem class="username">root</systemitem> user:
317 </para>
318
319<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
320install -v -m644 DOCS/HTML/en/* \
321 /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
322
323 <para>
324 You will only need <filename>codecs.conf</filename> if you want to
325 change its properties, as the main binary contains an internal copy of
326 it. Ensure any changes you make to <filename>codecs.conf</filename>
327 achieve the desired results, as incorrect entries in this file have been
328 known to cause errors and render the player unusable. If necessary,
329 create the file as the <systemitem class="username">root</systemitem>
330 user:
331 </para>
332
333<screen role="root"><userinput>install -v -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
334
335 <para>
336 You may alternatively want to copy all the default configuration files
337 to <filename class='directory'>/etc/mplayer</filename> for future
338 reference or more customization ability. As the
339 <systemitem class="username">root</systemitem> user:
340 </para>
341
342<screen role="root"><userinput>install -v -m644 etc/*.conf /etc/mplayer</userinput></screen>
343
344 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
345 href="../../xincludes/update-icons-and-desktop.xml"/>
346
347 </sect3>
348
349 <sect3>
350 <title>Skin Installation (Optional)</title>
351
352 <para>
353 To enable the Gtk+ 2 frontend of <application>MPlayer</application>,
354 you'll need to install at least one skin. Extract the desired skin and
355 create the default location (as the
356 <systemitem class="username">root</systemitem> user):
357 </para>
358
359<screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.bz2 \
360 -C /usr/share/mplayer/skins &amp;&amp;
361ln -sfvn Clearlooks /usr/share/mplayer/skins/default</userinput></screen>
362 </sect3>
363 </sect2>
364
365 <sect2 role="commands">
366 <title>Command Explanations</title>
367
368 <para>
369 <command>sed -i 's:libsmbclient.h:samba-4.0 ...</command>: Include
370 support for Samba 4.
371 </para>
372
373 <para>
374 <parameter>--enable-gui</parameter>: This option builds the GUI interface
375 into <command>mplayer</command>.
376 </para>
377
378 <para>
379 <parameter>--enable-menu</parameter>: This option is set to enable the
380 on-screen display.
381 </para>
382<!--Currently broken
383 <para>
384 <option>-\-disable-ffmpeg_a</option>: You can use this option if you have
385 installed <xref linkend="ffmpeg"/>. MPlayer includes a copy of the FFmpeg
386 source and without this option it will statically compile the included
387 version of FFmpeg into itself. Dynamically linking to a system installed
388 FFmpeg makes MPlayer and Mencoder about 9MB smaller. If MPlayer exhibits
389 unstable behavior linked to a system installed FFmpeg, try recompiling MPlayer
390 without this option (it is always more thoroughly tested with the included
391 FFmpeg).
392 </para>-->
393
394 <para>
395 <option>--language-doc="<replaceable>&lt;lang&gt;</replaceable>"</option>:
396 This switch enables the language used for the documentation. Use
397 <command>./configure --help</command> to find out what additional
398 information.
399 </para>
400
401 <para>
402 <option>--language-man="<replaceable>&lt;lang&gt;</replaceable>"</option>:
403 This switch enables the language used for the man pages. Use
404 <command>./configure --help</command> to find out what additional
405 information.
406 </para>
407
408 <para>
409 <option>--language-msg="<replaceable>&lt;lang&gt;</replaceable>"</option>:
410 This switch enables the language used for the messages and the GUI. Use
411 <command>./configure --help</command> to find out what additional
412 information.
413 </para>
414
415 <para>
416 <option>--language="<replaceable>&lt;lang&gt;</replaceable>"</option>:
417 This switch defines the default language used. Use <command>./configure
418 --help</command> to find out what additional information.
419 </para>
420
421 <note>
422 <para>
423 Specific options override --language. You can pass a list of
424 languages separated by whitespace or commas instead of a single
425 language. Nonexisting translations will be dropped from each list.
426 All documentation and man page translations available in the list
427 will be installed, for the messages the first available translation
428 will be used. The value "all" will activate all translations. The
429 LINGUAS environment variable is honored. In all cases the fallback is
430 English. Values listed by <command>./configure --help</command> are
431 not all available, as would normally be expected. You need to build
432 test.
433 </para>
434 </note>
435
436 </sect2>
437
438 <sect2 role="configuration">
439 <title>Configuring MPlayer</title>
440
441 <sect3 id="mplayer-config">
442 <title>Config Files</title>
443
444 <para>
445 <filename>/etc/mplayer/*</filename> and
446 <filename>~/.mplayer/*</filename>
447 </para>
448
449 <indexterm zone="mplayer mplayer-config">
450 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
451 </indexterm>
452
453 <indexterm zone="mplayer mplayer-config">
454 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
455 </indexterm>
456 </sect3>
457
458 <sect3>
459 <title>Configuration Information</title>
460
461 <para>
462 Typically, there's no configuration required for the system-wide files
463 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
464 directory is empty unless you copied the default files as mentioned
465 above). Configuration can be accomplished by choosing the configuration
466 button located on the <application>MPlayer</application> GUI. Any
467 configuration changes made in the GUI will be saved in the user's
468 <filename class='directory'>~/.mplayer</filename> directory.
469 </para>
470
471 </sect3>
472
473 </sect2>
474
475 <sect2 role="content">
476 <title>Contents</title>
477
478 <segmentedlist>
479 <segtitle>Installed Programs</segtitle>
480 <segtitle>Installed Libraries</segtitle>
481 <segtitle>Installed Directories</segtitle>
482
483 <seglistitem>
484 <seg>
485 gmplayer, mplayer and mencoder
486 </seg>
487 <seg>
488 None
489 </seg>
490 <seg>
491 /etc/mplayer,
492 /usr/share/mplayer and
493 /usr/share/doc/mplayer-&mplayer-version;
494 </seg>
495 </seglistitem>
496 </segmentedlist>
497
498 <variablelist>
499 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
500 <?dbfo list-presentation="list"?>
501 <?dbhtml list-presentation="table"?>
502
503 <varlistentry id="gmplayer">
504 <term><command>gmplayer</command></term>
505 <listitem>
506 <para>
507 is a symlink to <command>mplayer</command> which brings up the
508 GTK+ 2 frontend of <application>MPlayer</application>.
509 </para>
510 <indexterm zone="mplayer gmplayer">
511 <primary sortas="b-gmplayer">gmplayer</primary>
512 </indexterm>
513 </listitem>
514 </varlistentry>
515
516 <varlistentry id="mplayer-prog">
517 <term><command>mplayer</command></term>
518 <listitem>
519 <para> is the main MPlayer video player.</para>
520 <indexterm zone="mplayer mplayer-prog">
521 <primary sortas="b-mplayer">mplayer</primary>
522 </indexterm>
523 </listitem>
524 </varlistentry>
525
526 <varlistentry id="mencoder">
527 <term><command>mencoder</command></term>
528 <listitem>
529 <para>
530 is a powerful command line video decoding, encoding and filtering
531 tool that is useful for (amongst other things) ripping DVDs to files
532 on your hard disk (see
533 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
534 </para>
535 <indexterm zone="mplayer mencoder">
536 <primary sortas="b-mencoder">mencoder</primary>
537 </indexterm>
538 </listitem>
539 </varlistentry>
540
541 </variablelist>
542
543 </sect2>
544
545</sect1>
Note: See TracBrowser for help on using the repository browser.