source: multimedia/videoutils/mplayer.xml@ bccef10

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 bccef10 was bccef10, checked in by Andrew Benton <andy@…>, 12 years ago

added a note about ffmpeg to the mplayer page

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