source: multimedia/videoutils/mplayer.xml@ f82ac3f

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 f82ac3f was f82ac3f, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Archive unneeded packages

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@12016 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="pulseaudio"/>,
173 <xref linkend="sdl"/>,
174 <ulink url="http://jackaudio.org/">JACK</ulink>,
175 <ulink url="http://kcat.strangesoft.net/openal-releases/">OpenAL</ulink>, and
176 <ulink url="http://www.radscan.com/nas.html">NAS</ulink>
177 </para>
178
179 <bridgehead renderas="sect4">Optional Video Output Drivers and Libraries</bridgehead>
180 <para role="optional">
181 <xref linkend="aalib"/>,
182 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
183 <xref linkend="giflib"/>,
184 <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>,
185 <xref linkend="libjpeg"/>,
186 <xref linkend="libmng"/>,
187 <xref linkend="libpng"/>,
188 <xref linkend="openjpeg"/>, 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="libmad"/>,
197 <xref linkend="LZO"/>,
198 <xref linkend="speex"/>,
199 <xref linkend="libtheora"/>,
200 <xref linkend="mpg123"/>,
201 <xref linkend="liba52"/>,
202 <xref linkend="faac"/>,
203 <xref linkend="faad2"/>,
204 <xref linkend="libdv"/>,
205 <xref linkend="xvid"/>,
206 <xref linkend="libvpx"/>,
207 <xref linkend="lame"/>,
208 <ulink url="http://sourceforge.net/projects/twolame/">TwoLAME</ulink>,
209 <ulink url="http://www.quut.com/gsm/">GSM</ulink>,
210 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
211 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
212 <ulink url="http://sourceforge.net/projects/opencore-amr/">OpenCore
213 Adaptive Multi Rate</ulink>,
214 <ulink url="http://www.broadcom.com/support/crystal_hd/">CrystalHD</ulink>,
215 <xref linkend="x264"/>,
216 <ulink url="http://diracvideo.org/download/dirac-research/">Dirac</ulink>,
217 <ulink url="http://diracvideo.org/download/schroedinger/">Schroedinger</ulink>, and
218 <ulink url="http://wiki.multimedia.cx/index.php?title=NUT">libnut</ulink>
219 </para>
220
221 <bridgehead renderas="sect4">Optional Miscellaneous Dependencies</bridgehead>
222 <para role="optional">
223 <ulink url="http://cihar.com/software/enca/">Enca</ulink>,
224 <xref linkend="fontconfig"/>,
225 <xref linkend="freetype2"/>,
226 <xref linkend="fribidi"/>,
227 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
228 <ulink url="http://sourceforge.net/projects/bs2b/">libbs2b</ulink>,
229 <ulink url="http://www.lirc.org/">LIRC</ulink> (and
230 <ulink url="http://www.dolda2000.com/~fredrik/lirccd/">LIRC Client Daemon</ulink>),
231 <xref linkend="unrar"/>, and
232 <xref linkend="libxslt"/>,
233 <xref linkend="DocBook"/> and
234 <xref linkend="docbook-xsl"/> (all three required to build the HTML documentation)
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;
270
271./configure --prefix=/usr \
272 --confdir=/etc/mplayer \
273 --enable-dynamic-plugins \
274 --enable-menu \
275 --enable-gui &amp;&amp;
276make</userinput></screen>
277
278 <para>
279 If you wish to rebuild the chunked HTML documentation and build
280 a non-chunked HTML version of the docs, issue the following command:
281 </para>
282
283<screen><userinput>make doc</userinput></screen>
284
285 <para>
286 This package does not come with a test suite.
287 </para>
288
289 <para>
290 Now, as the <systemitem class="username">root</systemitem> user:
291 </para>
292
293<screen role="root"><userinput>make install</userinput></screen>
294
295 <para>
296 To install the HTML documentation, issue the following commands as the
297 <systemitem class="username">root</systemitem> user:
298 </para>
299
300<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
301install -v -m644 DOCS/HTML/en/* \
302 /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
303
304 <para>
305 You will only need <filename>codecs.conf</filename> if you want to
306 change its properties, as the main binary contains an internal copy of
307 it. Ensure any changes you make to <filename>codecs.conf</filename>
308 achieve the desired results, as incorrect entries in this file have been
309 known to cause errors and render the player unusable. If necessary,
310 create the file as the <systemitem class="username">root</systemitem>
311 user:
312 </para>
313
314<screen role="root"><userinput>install -v -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
315
316 <para>
317 You may alternatively want to copy all the default configuration files
318 to <filename class='directory'>/etc/mplayer</filename> for future
319 reference or more customization ability. As the
320 <systemitem class="username">root</systemitem> user:
321 </para>
322
323<screen role="root"><userinput>install -v -m644 etc/*.conf /etc/mplayer</userinput></screen>
324
325 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
326 href="../../xincludes/update-icons-and-desktop.xml"/>
327
328 </sect3>
329
330 <sect3>
331 <title>Skin Installation (Optional)</title>
332
333 <para>
334 To enable the Gtk+ 2 frontend of <application>MPlayer</application>,
335 you'll need to install at least one skin. Extract the desired skin and
336 create the default location (as the
337 <systemitem class="username">root</systemitem> user):
338 </para>
339
340<screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.bz2 \
341 -C /usr/share/mplayer/skins &amp;&amp;
342ln -sfv Clearlooks /usr/share/mplayer/skins/default</userinput></screen>
343 </sect3>
344 </sect2>
345
346 <sect2 role="commands">
347 <title>Command Explanations</title>
348
349 <para>
350 <parameter>--enable-gui</parameter>: This option builds the GUI interface
351 into <command>mplayer</command>.
352 </para>
353
354 <para>
355 <parameter>--enable-menu</parameter>: This option is set to enable the
356 on-screen display.
357 </para>
358
359 <para>
360 <option>--disable-ffmpeg_a</option>: You can use this option if you have
361 installed <xref linkend="ffmpeg"/>. MPlayer includes a copy of the FFmpeg
362 source and without this option it will statically compile the included
363 version of FFmpeg into itself. Dynamically linking to a system installed
364 FFmpeg makes MPlayer and Mencoder about 9MB smaller. If MPlayer exhibits
365 unstable behavior linked to a system installed FFmpeg, try recompiling MPlayer
366 without this option (it is always more thoroughly tested with the included
367 FFmpeg).
368 </para>
369
370 </sect2>
371
372 <sect2 role="configuration">
373 <title>Configuring MPlayer</title>
374
375 <sect3 id="mplayer-config">
376 <title>Config Files</title>
377
378 <para>
379 <filename>/etc/mplayer/*</filename> and
380 <filename>~/.mplayer/*</filename>
381 </para>
382
383 <indexterm zone="mplayer mplayer-config">
384 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
385 </indexterm>
386
387 <indexterm zone="mplayer mplayer-config">
388 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
389 </indexterm>
390 </sect3>
391
392 <sect3>
393 <title>Configuration Information</title>
394
395 <para>
396 Typically, there's no configuration required for the system-wide files
397 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
398 directory is empty unless you copied the default files as mentioned
399 above). Configuration can be accomplished by choosing the configuration
400 button located on the <application>MPlayer</application> GUI. Any
401 configuration changes made in the GUI will be saved in the user's
402 <filename class='directory'>~/.mplayer</filename> directory.
403 </para>
404
405 </sect3>
406
407 </sect2>
408
409 <sect2 role="content">
410 <title>Contents</title>
411
412 <segmentedlist>
413 <segtitle>Installed Programs</segtitle>
414 <segtitle>Installed Libraries</segtitle>
415 <segtitle>Installed Directories</segtitle>
416
417 <seglistitem>
418 <seg>
419 gmplayer, mplayer and mencoder
420 </seg>
421 <seg>
422 None
423 </seg>
424 <seg>
425 /etc/mplayer,
426 /usr/lib/mplayer,
427 /usr/share/mplayer and
428 /usr/share/doc/mplayer
429 </seg>
430 </seglistitem>
431 </segmentedlist>
432
433 <variablelist>
434 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
435 <?dbfo list-presentation="list"?>
436 <?dbhtml list-presentation="table"?>
437
438 <varlistentry id="gmplayer">
439 <term><command>gmplayer</command></term>
440 <listitem>
441 <para>
442 is a symlink to <command>mplayer</command> which brings up the
443 GTK+ 2 frontend of <application>MPlayer</application>.
444 </para>
445 <indexterm zone="mplayer gmplayer">
446 <primary sortas="b-gmplayer">gmplayer</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="mplayer-prog">
452 <term><command>mplayer</command></term>
453 <listitem>
454 <para> is the main MPlayer video player.</para>
455 <indexterm zone="mplayer mplayer-prog">
456 <primary sortas="b-mplayer">mplayer</primary>
457 </indexterm>
458 </listitem>
459 </varlistentry>
460
461 <varlistentry id="mencoder">
462 <term><command>mencoder</command></term>
463 <listitem>
464 <para>
465 is a powerful command line video decoding, encoding and filtering
466 tool that is useful for (amongst other things) ripping DVDs to files
467 on your hard disk (see
468 /usr/share/doc/mplayer-&mplayer-version;/mencoder.html)
469 </para>
470 <indexterm zone="mplayer mencoder">
471 <primary sortas="b-mencoder">mencoder</primary>
472 </indexterm>
473 </listitem>
474 </varlistentry>
475
476 </variablelist>
477
478 </sect2>
479
480</sect1>
Note: See TracBrowser for help on using the repository browser.