source: multimedia/videoutils/mplayer.xml@ a4f37269

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 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 a4f37269 was a4f37269, checked in by DJ Lucas <dj@…>, 7 years ago

Update to OpenSSL-1.1.0f. Fixes #8214.
Update to OpenSSL Libraries 1.0.2l. Fixes #9282.
Remove Re-alpine and raplaced with Alpine-2.21.

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