source: multimedia/videoutils/mplayer.xml@ 7f2dfa0

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 7f2dfa0 was 7f2dfa0, checked in by Igor Živković <igor@…>, 11 years ago

added x264-20131007-2245

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11941 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 16.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
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.5">
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 "6b046a78fb15b243dc1eb5884276a750">
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 &lfs74_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="samba"/>,
158 <xref linkend="libdvdread"/>,
159 <xref linkend="libdvdnav"/>,
160 <xref linkend="libdvdcss"/>,
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="esound"/>,
173 <xref linkend="pulseaudio"/>,
174 <xref linkend="sdl"/>,
175 <ulink url="http://jackaudio.org/">JACK</ulink>,
176 <ulink url="http://kcat.strangesoft.net/openal-releases/">OpenAL</ulink>, and
177 <ulink url="http://www.radscan.com/nas.html">NAS</ulink>
178 </para>
179
180 <bridgehead renderas="sect4">Optional Video Output Drivers and Libraries</bridgehead>
181 <para role="optional">
182 <xref linkend="aalib"/>,
183 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
184 <xref linkend="giflib"/>,
185 <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>,
186 <xref linkend="libjpeg"/>,
187 <xref linkend="libmng"/>,
188 <xref linkend="libpng"/>,
189 <xref linkend="openjpeg"/>, and
190 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>
191 </para>
192
193 <bridgehead renderas="sect4">Optional CODECs</bridgehead>
194 <para role="optional">
195 <!-- includes its own version of FFmpeg which is the recommended one by
196 the devs <xref linkend="ffmpeg"/>, -->
197 <xref linkend="libmad"/>,
198 <xref linkend="LZO"/>,
199 <xref linkend="speex"/>,
200 <xref linkend="libtheora"/>,
201 <xref linkend="mpg123"/>,
202 <xref linkend="liba52"/>,
203 <xref linkend="faac"/>,
204 <xref linkend="faad2"/>,
205 <xref linkend="libdv"/>,
206 <xref linkend="xvid"/>,
207 <xref linkend="libvpx"/>,
208 <xref linkend="lame"/>,
209 <ulink url="http://sourceforge.net/projects/twolame/">TwoLAME</ulink>,
210 <ulink url="http://www.quut.com/gsm/">GSM</ulink>,
211 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
212 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
213 <ulink url="http://sourceforge.net/projects/opencore-amr/">OpenCore
214 Adaptive Multi Rate</ulink>,
215 <ulink url="http://www.broadcom.com/support/crystal_hd/">CrystalHD</ulink>,
216 <xref linkend="x264"/>,
217 <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,
218 <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>, and
219 <ulink url="http://wiki.multimedia.cx/index.php?title=NUT">libnut</ulink>
220 </para>
221
222 <bridgehead renderas="sect4">Optional Miscellaneous Dependencies</bridgehead>
223 <para role="optional">
224 <ulink url="http://cihar.com/software/enca/">Enca</ulink>,
225 <xref linkend="fontconfig"/>,
226 <xref linkend="freetype2"/>,
227 <xref linkend="fribidi"/>,
228 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
229 <ulink url="http://sourceforge.net/projects/bs2b/">libbs2b</ulink>,
230 <ulink url="http://www.lirc.org/">LIRC</ulink> (and
231 <ulink url="http://www.dolda2000.com/~fredrik/lirccd/">LIRC Client Daemon</ulink>),
232 <xref linkend="unrar"/>, and
233 <xref linkend="libxslt"/>,
234 <xref linkend="DocBook"/> and
235 <xref linkend="docbook-xsl"/> (all three required to build the HTML documentation)
236 </para>
237
238 <para condition="html" role="usernotes">
239 User Notes: <ulink url="&blfs-wiki;/mplayer"/>
240 </para>
241 </sect2>
242
243 <sect2 role="installation">
244 <title>Installation of MPlayer</title>
245
246 <sect3>
247 <title>Main MPlayer Installation</title>
248
249 <note>
250 <para>
251 The package maintainers recommend building without any
252 optimizations.
253 </para>
254 </note>
255
256 <para>
257 You may wish to examine the output from
258 <command>./configure --help</command> to find out what additional
259 parameters to <command>configure</command> are needed to include the
260 dependencies you have installed on your system.
261 </para>
262
263 <para>
264 Install <application>MPlayer</application> by running the following
265 commands:
266 </para>
267
268<screen><userinput>patch -Np1 -i ../MPlayer-&mplayer-version;-giflib_fixes-1.patch &amp;&amp;
269patch -Np1 -i ../MPlayer-&mplayer-version;-live_fixes-1.patch &amp;&amp;
270sed -i 's:libsmbclient.h:samba-4.0/&amp;:' configure stream/stream_smb.c &amp;&amp;
271
272./configure --prefix=/usr \
273 --confdir=/etc/mplayer \
274 --enable-dynamic-plugins \
275 --enable-menu \
276 --enable-gui &amp;&amp;
277make</userinput></screen>
278
279 <para>
280 If you wish to rebuild the chunked HTML documentation and build
281 a non-chunked HTML version of the docs, issue the following command:
282 </para>
283
284<screen><userinput>make doc</userinput></screen>
285
286 <para>
287 This package does not come with a test suite.
288 </para>
289
290 <para>
291 Now, as the <systemitem class="username">root</systemitem> user:
292 </para>
293
294<screen role="root"><userinput>make install</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 -sfv 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
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 </sect2>
372
373 <sect2 role="configuration">
374 <title>Configuring MPlayer</title>
375
376 <sect3 id="mplayer-config">
377 <title>Config Files</title>
378
379 <para>
380 <filename>/etc/mplayer/*</filename> and
381 <filename>~/.mplayer/*</filename>
382 </para>
383
384 <indexterm zone="mplayer mplayer-config">
385 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
386 </indexterm>
387
388 <indexterm zone="mplayer mplayer-config">
389 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
390 </indexterm>
391 </sect3>
392
393 <sect3>
394 <title>Configuration Information</title>
395
396 <para>
397 Typically, there's no configuration required for the system-wide files
398 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
399 directory is empty unless you copied the default files as mentioned
400 above). Configuration can be accomplished by choosing the configuration
401 button located on the <application>MPlayer</application> GUI. Any
402 configuration changes made in the GUI will be saved in the user's
403 <filename class='directory'>~/.mplayer</filename> directory.
404 </para>
405
406 </sect3>
407
408 </sect2>
409
410 <sect2 role="content">
411 <title>Contents</title>
412
413 <segmentedlist>
414 <segtitle>Installed Programs</segtitle>
415 <segtitle>Installed Libraries</segtitle>
416 <segtitle>Installed Directories</segtitle>
417
418 <seglistitem>
419 <seg>
420 gmplayer, mplayer and mencoder
421 </seg>
422 <seg>
423 None
424 </seg>
425 <seg>
426 /etc/mplayer,
427 /usr/lib/mplayer,
428 /usr/share/mplayer and
429 /usr/share/doc/mplayer
430 </seg>
431 </seglistitem>
432 </segmentedlist>
433
434 <variablelist>
435 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
436 <?dbfo list-presentation="list"?>
437 <?dbhtml list-presentation="table"?>
438
439 <varlistentry id="gmplayer">
440 <term><command>gmplayer</command></term>
441 <listitem>
442 <para>
443 is a symlink to <command>mplayer</command> which brings up the
444 GTK+ 2 frontend of <application>MPlayer</application>.
445 </para>
446 <indexterm zone="mplayer gmplayer">
447 <primary sortas="b-gmplayer">gmplayer</primary>
448 </indexterm>
449 </listitem>
450 </varlistentry>
451
452 <varlistentry id="mplayer-prog">
453 <term><command>mplayer</command></term>
454 <listitem>
455 <para> is the main MPlayer video player.</para>
456 <indexterm zone="mplayer mplayer-prog">
457 <primary sortas="b-mplayer">mplayer</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="mencoder">
463 <term><command>mencoder</command></term>
464 <listitem>
465 <para>
466 is a powerful command line video decoding, encoding and filtering
467 tool that is useful for (amongst other things) ripping DVDs to files
468 on your hard disk (see
469 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
470 </para>
471 <indexterm zone="mplayer mencoder">
472 <primary sortas="b-mencoder">mencoder</primary>
473 </indexterm>
474 </listitem>
475 </varlistentry>
476
477 </variablelist>
478
479 </sect2>
480
481</sect1>
Note: See TracBrowser for help on using the repository browser.