source: multimedia/videoutils/mplayer.xml@ e127158

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.0 9.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt 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 e127158 was e127158, checked in by Pierre Labastie <pieere@…>, 5 years ago

mplayer: put the skins as "Additional downloads", and group install
instructions. This makes jhalfs happy, and should not change the the update
workload

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