source: multimedia/videoutils/mplayer.xml@ 2425885

10.0 10.1 11.0 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 2425885 was 2425885, checked in by Igor Živković <igor@…>, 17 years ago

Removed obsolete SCSI information on MPlayer page, reported by Alexander

  1. Patrakov.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2935 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 13.9 KB
Line 
1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
2 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
3 <!ENTITY % general-entities SYSTEM "../../general.ent">
4 %general-entities;
5
6 <!ENTITY mplayer-download-http "http://www1.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
7 <!ENTITY mplayer-download-ftp "ftp://ftp1.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
8 <!ENTITY mplayer-size "5.1 MB">
9 <!ENTITY mplayer-buildsize "74 MB (additional 19 MB for CODECs)">
10 <!ENTITY mplayer-time "1.80 SBU">
11 <!ENTITY mplayer-default-codec "essential-20040809.tar.bz2">
12 <!ENTITY mplayer-default-skin "Blue-1.4.tar.bz2">
13 <!ENTITY mplayer-default-font "font-arial-iso-8859-1">
14]>
15
16<sect1 id="mplayer" xreflabel="MPlayer-&mplayer-version;">
17<sect1info>
18<othername>$LastChangedBy$</othername>
19<date>$Date$</date>
20</sect1info>
21<?dbhtml filename="mplayer.html"?>
22<title>MPlayer-&mplayer-version;</title>
23
24<sect2>
25<title>Introduction to <application>MPlayer</application></title>
26
27<para>The <application>MPlayer</application> package contains an audio/video
28player controlled via the command line or a graphical interface which is
29able to play almost every popular audio and video file format
30and <acronym>CODEC</acronym> (COder/DECoder, also COmpressor/DECompressor).
31With supported video hardware and additional drivers,
32<application>MPlayer</application> can play video files without an
33<application>X</application> window system installed.</para>
34
35<para>For a full list of file formats, <acronym>CODEC</acronym>s and
36output devices supported by <application>MPlayer</application>, visit the
37<ulink url="http://www.mplayerhq.hu/DOCS/HTML/en/features.html">
38<application>MPlayer</application> web site</ulink>.</para>
39
40<sect3><title>Package information</title>
41<itemizedlist spacing='compact'>
42<listitem><para>Download (HTTP): <ulink url="&mplayer-download-http;"/></para></listitem>
43<listitem><para>Download (FTP): <ulink url="&mplayer-download-ftp;"/></para></listitem>
44<listitem><para>Download size: &mplayer-size;</para></listitem>
45<listitem><para>Estimated Disk space required: &mplayer-buildsize;</para></listitem>
46<listitem><para>Estimated build time: &mplayer-time;</para></listitem></itemizedlist>
47</sect3>
48
49<sect3><title>Additional downloads</title>
50<para><emphasis>Patches</emphasis></para>
51<itemizedlist spacing='compact'>
52<listitem><para>Required Patch (for fbdev driver support): <ulink
53url="&patch-root;/MPlayer-&mplayer-version;-kernel_2.6-1.patch"/></para>
54</listitem></itemizedlist>
55
56<para><emphasis><acronym>CODEC</acronym>s</emphasis></para>
57<itemizedlist spacing='compact'>
58<listitem><para>Proprietary <acronym>CODEC</acronym>s: <ulink
59url="http://www.mplayerhq.hu/MPlayer/releases/codecs/&mplayer-default-codec;"/></para>
60</listitem>
61<listitem><para>Additional <acronym>CODEC</acronym>s: <ulink
62url="http://www.mplayerhq.hu/MPlayer/releases/codecs/"/></para>
63</listitem></itemizedlist>
64
65<para><emphasis>Skins</emphasis></para>
66<itemizedlist spacing='compact'>
67<listitem><para>Default <acronym>GUI</acronym> skin: <ulink
68url="http://www1.mplayerhq.hu/MPlayer/Skin/&mplayer-default-skin;"/></para>
69</listitem>
70<listitem><para>Additional skins: <ulink
71url="http://www1.mplayerhq.hu/MPlayer/Skin/"/></para>
72</listitem></itemizedlist>
73
74<para><emphasis>Fonts</emphasis></para>
75<itemizedlist spacing='compact'>
76<listitem><para>Prerendered fonts: <ulink
77url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/&mplayer-default-font;.tar.bz2"/></para>
78</listitem>
79<listitem><para>Additional fonts: <ulink
80url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/"/></para>
81</listitem></itemizedlist>
82
83<note><para>The <acronym>CODEC</acronym>s, skins and fonts are not required to
84build and use <application>MPlayer</application>.</para></note>
85</sect3>
86
87<sect3><title><application>MPlayer</application> dependencies</title>
88<sect4><title>Optional</title>
89<para>
90X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
91<xref linkend="libpng"/>,
92<xref linkend="libjpeg"/>,
93<xref linkend="GTK"/>,
94<ulink url="http://www.directfb.org/">DirectFB</ulink>,
95<ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
96<xref linkend="freetype2"/>,
97<xref linkend="fontconfig"/>,
98<xref linkend="libungif"/> or <xref linkend="giflib"/>,
99<xref linkend="libogg"/>
100<xref linkend="libvorbis"/>,
101<xref linkend="aalib"/>,
102<xref linkend="SDL"/>,
103<xref linkend="xvid"/>,
104<xref linkend="arts"/>,
105<xref linkend="alsa"/>,
106<xref linkend="esound"/>,
107<xref linkend="LZO"/>,
108<xref linkend="libmad"/>,
109<xref linkend="CDParanoia"/>,
110<xref linkend="libdv"/>,
111<xref linkend="libdvdread"/>,
112<xref linkend="nas"/>,
113<xref linkend="samba3"/>,
114<xref linkend="lame"/>,
115<xref linkend="xmms"/>,
116<xref linkend="flac"/>,
117<xref linkend="libfame"/>,
118<ulink url="http://www.theora.org/">Theora</ulink>,
119<ulink url="http://prdownloads.sourceforge.net/zapping/mp1e-1.9.3.tar.bz2">MP1E</ulink>,
120<ulink url="http://faac.sourceforge.net/">FAAD2</ulink>,
121<ulink url="http://www.ggi-project.org/">GGI</ulink>,
122<ulink url="http://fribidi.sourceforge.net/">FriBidi</ulink>,
123<ulink url="http://www.unrarlib.org/">unrarlib</ulink>,
124<ulink url="http://www.lirc.org/">LIRC</ulink>,
125<ulink url="http://www.dolda2000.cjb.net/~fredrik/lirccd/">lirccd</ulink>,
126<ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>,
127<ulink url="http://www.matroska.org/downloads/linux.html">libmatroska</ulink>,
128<ulink url="http://www.live.com/mplayer/">LIVE.COM Streaming Media</ulink>,
129<ulink url="http://bio2jack.sourceforge.net/">bio2jack</ulink>,
130<ulink url="http://dxr2.sourceforge.net/">Dxr2</ulink>,
131<ulink url="http://dxr3.sourceforge.net/">libdxr3</ulink> and
132<ulink url="http://trific.ath.cx/software/enca/">Enca</ulink>
133</para></sect4>
134</sect3>
135
136</sect2>
137
138<sect2>
139<title>Installation of <application>MPlayer</application></title>
140
141<sect3>
142<title><acronym>CODEC</acronym> installation (optional)</title>
143
144<para>If you downloaded any proprietary <acronym>CODEC</acronym>s
145(which can provide support for additional audio and video formats such as
146Real, Indeo and QuickTime), extract them to
147<filename class="directory">/usr/lib/mplayer/codecs</filename>
148using the following commands (substitute and/or add different
149<acronym>CODEC</acronym> filenames, if necessary):</para>
150
151<screen><userinput><command>install -d -m755 /usr/lib/mplayer/codecs &amp;&amp;
152tar xjfv ../&mplayer-default-codec; \
153 -C /usr/lib/mplayer/codecs --strip-path=1 &amp;&amp;
154chown -R root:root /usr/lib/mplayer/codecs</command></userinput></screen>
155
156<para>If you installed any <acronym>CODEC</acronym>s, ensure you add
157<parameter>--with-codecsdir=/usr/lib/mplayer/codecs</parameter>
158to the <command>configure</command> script.</para>
159</sect3>
160
161<sect3>
162<title><acronym>GUI</acronym> installation (optional)</title>
163
164<para>To enable building the <acronym>GUI</acronym> version of
165<application>MPlayer</application> (requires <xref linkend="GTK"/>), add
166<parameter>--enable-gui</parameter> to the <command>configure</command>
167script. You'll also need to extract at least one skin. Extract the desired
168skin to the default location:</para>
169
170<screen><userinput><command>install -d -m755 /usr/share/mplayer/Skin/default &amp;&amp;
171tar xjvf ../&mplayer-default-skin; \
172 -C /usr/share/mplayer/Skin/default --strip-path=1 &amp;&amp;
173chown -R root:root /usr/share/mplayer/Skin/default</command></userinput></screen>
174</sect3>
175
176<sect3>
177<title>Installing <acronym>OSD</acronym> and subtitles support
178(optional)</title>
179
180<para>To enable <acronym>OSD</acronym> (On Screen Display) and subtitles
181support, add <parameter>--enable-menu</parameter> to the
182<command>configure</command> script. You'll also need to set up at least one
183font (see font installation instructions a little later).</para>
184</sect3>
185
186<sect3>
187<title>Main <application>MPlayer</application> installation</title>
188
189<note><para>The package maintainers recommend building without any
190optimizations.</para></note>
191
192<para>Install <application>MPlayer</application> by running the following
193commands:</para>
194
195<screen><userinput><command>patch -Np1 -i ../MPlayer-&mplayer-version;-kernel_2.6-1.patch &amp;&amp;
196./configure --prefix=/usr --confdir=/etc/mplayer \
197 --enable-largefiles --enable-shared-pp &amp;&amp;
198make &amp;&amp;
199make install &amp;&amp;
200make -C libavcodec/libpostproc install &amp;&amp;
201install -d -m755 /usr/share/doc/mplayer &amp;&amp;
202cp -R DOCS/* /usr/share/doc/mplayer &amp;&amp;
203chown -R root:root /usr/share/doc/mplayer</command></userinput></screen>
204
205<para>You will need <filename>codecs.conf</filename> only if you want to
206change its properties, as the main binary contains an internal copy of
207it. Ensure any changes you make to <filename>codecs.conf</filename> achieve
208the desired results, as incorrect entries in this file have been known to
209cause errors. If necessary, create the file using the following command.</para>
210
211<screen><userinput><command>cp etc/codecs.conf /etc/mplayer</command></userinput></screen>
212</sect3>
213
214<sect3>
215<title><acronym>OSD</acronym> and subtitles font installation
216(required if <parameter>--enable-menu</parameter> was passed to
217<command>configure</command>)</title>
218
219<para>The recommended method to set up a font for
220<application>MPlayer</application> is to link a <acronym>TTF</acronym> file to
221your <filename class="directory">~/.mplayer</filename> directory. A link
222should be created in each user's home directory who may use
223<application>MPlayer</application>. For example:
224</para>
225
226<screen><userinput><command>mkdir ~/.mplayer &amp;&amp;
227ln -sf /usr/X11R6/lib/X11/fonts/TTF/luxisri.ttf \
228 ~/.mplayer/subfont.ttf</command></userinput></screen>
229
230<para>There are several other ways to set up a font package. To use a
231prerendered <application>MPlayer</application> font package, extract and link
232one of the font tarballs using the following commands:</para>
233
234<screen><userinput><command>tar xjvf ../&mplayer-default-font;.tar.bz2 \
235 -C /usr/share/mplayer/font &amp;&amp;
236chown -R root:root /usr/share/mplayer/font &amp;&amp;
237cd /usr/share/mplayer/font &amp;&amp;
238ln -sf &mplayer-default-font;/font-arial-<replaceable>[font size]</replaceable>-iso-8859-1/* .</command></userinput></screen>
239
240<para>Available font sizes are 14, 18, 24 or 28.</para>
241
242<para>Additional information as well as additional methods to set up an
243<application>MPlayer</application> font package can be found at <ulink
244url="http://www.mplayerhq.hu/DOCS/HTML/en/subosd.html#mpsub-install"/>.</para>
245</sect3>
246
247<sect3>
248<title>Installation for <acronym>DVD</acronym> playback (optional)</title>
249
250<para>If you want <acronym>DVD</acronym> playback with
251<application>MPlayer</application>, you need to ensure a link exists
252from your <acronym>DVD</acronym> drive to <filename>/dev/dvd</filename>. If
253necessary, create the link using the following command:</para>
254
255<screen><userinput><command>ln -s /dev/<replaceable>[dvd drive]</replaceable> /dev/dvd</command></userinput></screen>
256
257<para>Replace <replaceable>[dvd drive]</replaceable> with whatever
258device is appropriate, for example <filename>/dev/hdc</filename>. If
259you don't know which device to choose, type:</para>
260
261<screen><userinput><command>dmesg | grep DVD</command></userinput></screen>
262
263<para>It should result in an output like:</para>
264
265<screen><userinput>hdc: Pioneer DVD-ROM ATAPIModel DVD-114 0110,
266ATAPI CD/DVD-ROM drive</userinput></screen>
267
268</sect3>
269
270</sect2>
271
272<sect2>
273<title>Command explanations</title>
274<para><parameter>--enable-shared-pp</parameter>: This enables building the
275shared <filename class="libraryfile">libpostproc</filename> library (for
276post processing) which features filters such as sharpen.</para>
277
278</sect2>
279
280<sect2>
281<title>Configuring MPlayer</title>
282
283<sect3><title>Config files</title>
284<para><filename>/etc/mplayer/*</filename>,
285<filename>~/.mplayer/*</filename></para>
286</sect3>
287
288</sect2>
289
290<sect2>
291<title>Contents</title>
292
293<para>The <application>MPlayer</application> package contains
294<command>mplayer</command>,
295<command>gmplayer</command> and
296<command>mencoder</command>.</para>
297
298</sect2>
299
300<sect2><title>Description</title>
301
302<sect3><title>mplayer</title>
303<para><command>mplayer</command> manages the input formats, the
304<acronym>CODEC</acronym>s and the output formats to play video files,
305<acronym>DVD</acronym>s, (S)<acronym>VCD</acronym>s or network streams
306containing audio and/or video information on your system.</para>
307
308<para>Examples:</para>
309
310<screen><command>mplayer -fs blfs.avi
311mplayer -vo fbdev -fb /dev/fb0 dvd://1 -aid 128 -sub en -framedrop
312mplayer -fs vcd://1 # works both for VCDs and SVCDs
313mplayer http://www.students.uni-marburg.de/~Klossa/hapkidofight_lo.mpg</command></screen>
314
315<para>For further information, look at the very good documentation included
316with the package in the source tree subdirectory
317<filename class="directory">DOCS</filename> (also installed at
318<filename class='directory'>/usr/share/doc/mplayer</filename>).</para>
319</sect3>
320
321<sect3><title>gmplayer</title>
322<para><command>gmplayer</command> is <application>MPlayer</application> with a
323graphical user interface.</para></sect3>
324
325<sect3><title>mencoder</title>
326<para><command>mencoder</command> is used to encode any
327<application>MPlayer</application> playable movie to DivX4,
328<application>XviD</application> or any <acronym>CODEC</acronym> in
329<filename class='libraryfile'>libavcodec</filename> with
330<acronym>PCM</acronym>/MP3/VBRMP3 audio.</para>
331
332<para>Example:</para>
333
334<screen><userinput><command>rm frameno.avi
335mencoder -dvd 1 -aid 128 -ovc frameno -oac mp3lame \
336-lameopts vbr=3 -o frameno.avi</command>
337
338# mencoder should output bitrates for average encodings
339# now, choose one you like best! In the following lines,
340# replace &lt;bitrate&gt; and &lt;name.avi&gt; with statements of your
341# personal liking.
342
343<command>mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
344-lavcopts vcodec=mpeg4:vpass=1:vhq:vbitrate=&lt;bitrate&gt; -o &lt;name.avi&gt;
345mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
346-lavcopts vcodec=mpeg4:vpass=2:vhq:vbitrate=&lt;bitrate&gt; -o &lt;name.avi&gt;
347mencoder -forceidx &lt;name.avi&gt;</command></userinput></screen>
348</sect3>
349
350</sect2>
351
352</sect1>
353
Note: See TracBrowser for help on using the repository browser.