source: multimedia/videoutils/mplayer.xml@ 475a5da6

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

Update to List-MoreUtils-0.426 (Perl Module) .
Update to Clearlooks-1.8 (mplayer skin).

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