source: multimedia/videoutils/mplayer.xml@ 4f746dd

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 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 4f746dd was 5a94000c, checked in by Krejzi <krejzi@…>, 11 years ago

vlc update and fixes, mplayer samba fix.

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