source: multimedia/videoutils/mplayer.xml@ 63630f8

7.6-blfs 7.6-systemd kde5-14269 kde5-14686 systemd-13485
Last change on this file since 63630f8 was 63630f8, checked in by Krejzi <krejzi@…>, 10 years ago

More package checks, fixes, bump clearlooks skin to latest version for mplayer.

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