source: multimedia/videoutils/mplayer.xml@ e5225d5

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 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/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since e5225d5 was e5225d5, checked in by Fernando de Oliveira <fernando@…>, 9 years ago
  • Update to mplayer-SVN-r37794.

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