source: multimedia/videoutils/mplayer.xml@ e104a36

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 e104a36 was e104a36, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to mplayer-1.3.0

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