source: multimedia/videoutils/mplayer.xml@ 2fcac83

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 2fcac83 was 2fcac83, checked in by Fernando de Oliveira <fernando@…>, 9 years ago

Update o mplayer-2014-12-19.
Use of snapshot suggested by Armin.

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