source: multimedia/videoutils/mplayer.xml@ dff08f73

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 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 dff08f73 was dff08f73, checked in by Randy McMurchy <randy@…>, 17 years ago

Updated to FFmpeg-svn_20070606 (svn checkout)

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

  • Property mode set to 100644
File size: 25.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 "http://www.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
8 <!ENTITY mplayer-download-ftp "ftp://ftp1.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
9 <!ENTITY mplayer-md5sum "aaca4fd327176c1afb463f0f047ef6f4">
10 <!ENTITY mplayer-size "6.6 MB">
11 <!ENTITY mplayer-buildsize "97 MB (additional 22 MB for essential CODECs)">
12 <!ENTITY mplayer-time "2.0 SBU">
13
14 <!ENTITY mplayer-codec "essential-20061022.tar.bz2">
15 <!ENTITY mplayer-codec-md5sum "abcf4a3abc16cf88c9df7e0a77e9b941">
16 <!ENTITY mplayer-codec-size "10.0 MB">
17 <!ENTITY mplayer-alt-codec "all-20061022.tar.bz2">
18
19 <!ENTITY mplayer-skin "Blue-1.7.tar.bz2">
20 <!ENTITY mplayer-skin-md5sum "e4e2020d11b681aac898103b3ba723c4">
21 <!ENTITY mplayer-skin-size "222 KB">
22
23 <!ENTITY mplayer-font "font-arial-iso-8859-1">
24 <!ENTITY mplayer-font-md5sum "1ecd31d17b51f16332b1fcc7da36b312">
25 <!ENTITY mplayer-font-size "234 KB">
26]>
27
28<sect1 id="mplayer" xreflabel="MPlayer-&mplayer-version;">
29 <?dbhtml filename="mplayer.html"?>
30
31 <sect1info>
32 <othername>$LastChangedBy$</othername>
33 <date>$Date$</date>
34 </sect1info>
35
36 <title>MPlayer-&mplayer-version;</title>
37
38 <indexterm zone="mplayer">
39 <primary sortas="a-MPlayer">MPlayer</primary>
40 </indexterm>
41
42 <sect2 role="package">
43 <title>Introduction to MPlayer</title>
44
45 <para>The <application>MPlayer</application> package contains an audio/video
46 player controlled via the command line or a graphical interface which is able
47 to play almost every popular audio and video file format and CODEC
48 (COder/DECoder, also COmpressor/DECompressor). With supported video
49 hardware and additional drivers, <application>MPlayer</application> can play
50 video files without an <application>X Window System</application> installed.</para>
51
52 <para>For <application>MPlayer</application> general information and
53 available features, including a full list of file formats, CODECs and
54 output devices supported by <application>MPlayer</application>, visit the
55 <ulink url="http://www1.mplayerhq.hu/homepage/design7/info.html">
56 <application>MPlayer</application> web site</ulink>.</para>
57
58 <bridgehead renderas="sect3">Package Information</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>Download (HTTP): <ulink url="&mplayer-download-http;"/></para>
62 </listitem>
63 <listitem>
64 <para>Download (FTP): <ulink url="&mplayer-download-ftp;"/></para>
65 </listitem>
66 <listitem>
67 <para>Download MD5 sum: &mplayer-md5sum;</para>
68 </listitem>
69 <listitem>
70 <para>Download size: &mplayer-size;</para>
71 </listitem>
72 <listitem>
73 <para>Estimated disk space required: &mplayer-buildsize;</para>
74 </listitem>
75 <listitem>
76 <para>Estimated build time: &mplayer-time;</para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81
82 <itemizedlist spacing='compact'>
83 <title>Patches</title>
84 <listitem>
85 <para>Required Patch: <ulink
86 url="&patch-root;/MPlayer-&mplayer-version;-gcc4-1.patch"/></para>
87 </listitem>
88 <listitem>
89 <para>Required Patch: <ulink
90 url="&patch-root;/MPlayer-&mplayer-version;-round_function_fix-1.patch"/></para>
91 </listitem>
92 <listitem>
93 <para>Required Patch: <ulink
94 url="&patch-root;/MPlayer-&mplayer-version;-x264_fixes-1.patch"/></para>
95 </listitem>
96 <listitem>
97 <para>Required Patch: <ulink
98 url="&patch-root;/MPlayer-&mplayer-version;-jack_fixes-1.patch"/></para>
99 </listitem>
100 <listitem>
101 <para>Required Patch (for fbdev driver support): <ulink
102 url="&patch-root;/MPlayer-&mplayer-version;-kernel_2.6-1.patch"/></para>
103 </listitem>
104 </itemizedlist>
105
106 <itemizedlist spacing='compact'>
107 <title>CODECs</title>
108 <listitem>
109 <para>Proprietary CODECs: <ulink
110 url="http://www.mplayerhq.hu/MPlayer/releases/codecs/&mplayer-codec;"/></para>
111 </listitem>
112 <listitem>
113 <para>Download MD5 sum: &mplayer-codec-md5sum;</para>
114 </listitem>
115 <listitem>
116 <para>Download size: &mplayer-codec-size;</para>
117 </listitem>
118 <listitem>
119 <para>Alternate CODECs (provides additional functionality and is a
120 larger file): <ulink
121 url="http://www.mplayerhq.hu/MPlayer/releases/codecs/&mplayer-alt-codec;"/></para>
122 </listitem>
123 <listitem><para>Additional CODECs: <ulink
124 url="http://www.mplayerhq.hu/MPlayer/releases/codecs/"/></para>
125 </listitem>
126 </itemizedlist>
127
128 <itemizedlist spacing='compact'>
129 <title>Skins</title>
130 <listitem>
131 <para>Default GUI skin: <ulink
132 url="http://www.mplayerhq.hu/MPlayer/Skin/&mplayer-skin;"/></para>
133 </listitem>
134 <listitem>
135 <para>Download MD5 sum: &mplayer-skin-md5sum;</para>
136 </listitem>
137 <listitem>
138 <para>Download size: &mplayer-skin-size;</para>
139 </listitem>
140 <listitem>
141 <para>Additional skins: <ulink
142 url="http://www1.mplayerhq.hu/MPlayer/Skin/"/></para>
143 </listitem>
144 </itemizedlist>
145
146 <itemizedlist spacing='compact'>
147 <title>Fonts</title>
148 <listitem>
149 <para>Prerendered fonts: <ulink
150 url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/&mplayer-font;.tar.bz2"/></para>
151 </listitem>
152 <listitem>
153 <para>Download MD5 sum: &mplayer-font-md5sum;</para>
154 </listitem>
155 <listitem>
156 <para>Download size: &mplayer-font-size;</para>
157 </listitem>
158 <listitem>
159 <para>Additional fonts: <ulink
160 url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/"/></para>
161 </listitem>
162 </itemizedlist>
163
164 <note>
165 <para>The CODECs, skins and fonts are not required to
166 build and use <application>MPlayer</application>.</para>
167 </note>
168
169 <bridgehead renderas="sect3">MPlayer Dependencies</bridgehead>
170
171 <bridgehead renderas="sect4">Optional Input Drivers and Libraries</bridgehead>
172 <para role="optional"><xref linkend="cdparanoia"/>,
173 <xref linkend="libdv"/>,
174 <xref linkend="libdvdread"/> (must disable internal mpdvdkit support),
175 <xref linkend="samba3"/>,
176 <ulink url="http://www.live555.com/mplayer/">LIVE555 Streaming Media</ulink>,
177 <ulink url="http://armory.nicewarrior.org/projects/vstream-client/">TiVo vstream client</ulink>,
178 <!-- Disabling for now as only internal Matroska support is available
179 <ulink url="http://www.matroska.org/downloads/linux.html">libmatroska</ulink>
180 (requires
181 <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>), -->
182 <ulink url="http://www.linuxtv.org/">DVB drivers</ulink>, and
183 <ulink url="http://www.metzlerbros.org/dvb/">DVB</ulink></para>
184
185 <bridgehead renderas="sect4">Optional Audio Output Drivers and Libraries</bridgehead>
186 <para role="optional"><xref linkend="alsa"/>,
187 <xref linkend="arts"/>,
188 <xref linkend="esound"/>,
189 <xref linkend="nas"/>,
190 <xref linkend="sdl"/> (also used for video output),
191 <xref linkend="xmms"/>,
192 <!-- MPlayer is not yet converted from PolyPAudio
193 <ulink url="http://pulseaudio.org/">PulseAudio</ulink>,
194 -->
195 <ulink url="http://jackit.sourceforge.net/">JACK</ulink>,
196 <ulink url="http://openal.org/">OpenAL</ulink>, and
197 <ulink url="http://www.ladspa.org/">LADSPA</ulink></para>
198
199 <bridgehead renderas="sect4">Optional Video Output Drivers and Libraries</bridgehead>
200 <para role="optional"><xref linkend="x-window-system"/>,
201 <xref linkend="libpng"/>,
202 <xref linkend="libjpeg"/>,
203 <!-- <xref linkend="libungif"/> or -->
204 <xref linkend="giflib"/>,
205 <xref linkend="GTK"/>,
206 <xref linkend="gtk2"/>,
207 <xref linkend="freetype2"/>,
208 <xref linkend="fontconfig"/>,
209 <xref linkend="aalib"/>,
210 <xref linkend="fribidi"/>,
211 <ulink url="http://sourceforge.net/projects/unichrome/">XvMC Wrapper</ulink>
212 (only if you have XFree86 installed),
213 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
214 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
215 <ulink url="http://www.ggi-project.org/">GGI</ulink>,
216 <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>, and
217 <ulink url="http://trific.ath.cx/software/enca/">Enca</ulink></para>
218
219 <bridgehead renderas="sect4">Optional CODECs</bridgehead>
220 <para role="optional"><xref linkend="libvorbis"/>,
221 <xref linkend="xvid"/>,
222 <xref linkend="LZO"/> (requires <ulink
223 url="http://www.oberhumer.com/opensource/lzo/download/LZO-v1/lzo-1.08.tar.gz">
224 Version 1</ulink>),
225 <xref linkend="libmad"/>,
226 <xref linkend="lame"/>,
227 <xref linkend="libfame"/>,
228 <ulink url="http://www.theora.org/">Theora</ulink>,
229 <ulink url="http://www.xiph.org/vorbis/">Tremor</ulink> (requires
230 <xref linkend="libvorbis"/> and you must disable the internal version),
231 <ulink url="http://sourceforge.net/projects/faac">FAAD2</ulink>
232 (must disable internal version to use the system-installed version),
233 <ulink url="http://developers.videolan.org/x264.html">x264</ulink>,
234<!-- Dead link
235 <ulink url="http://www.divx.com/divx/linux/">DivX</ulink>,
236-->
237 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
238 <ulink url="http://www.3gpp.org/ftp/Specs/latest/Rel-5/26_series/26104-540.zip">
239 AMR narrowband (floating point)</ulink> or
240 <ulink url="http://www.3gpp.org/ftp/Specs/latest/Rel-5/26_series/26073-530.zip">
241 AMR naarrowband (fixed point)</ulink>,
242 <ulink url="http://www.3gpp.org/ftp/Specs/latest/Rel-5/26_series/26204-530.zip">
243 AMR wideband</ulink>,
244 <ulink
245 url="ftp://ftp.videolan.org/pub/videolan/vlc/0.8.2/contrib/toolame-02m-beta8.tar.bz2">
246 tooLAME</ulink>,
247 <ulink url="http://developers.videolan.org/libdca.html">libdca</ulink>,
248 <ulink url="http://www.dolda2000.cjb.net/~fredrik/lirccd/">lirccd</ulink>, and
249 <ulink url="http://www.lirc.org/">LIRC</ulink></para>
250
251 <bridgehead renderas="sect4">Optional Hardware Specific Options</bridgehead>
252 <para>There is hardware specific packages (or vendor supplied software) you
253 can install to improve the performance of your video card when using
254 <application>MPlayer</application>. Some of the packages and/or vendor
255 supplied software and the <application>MPlayer</application> specific
256 driver created if it is found is shown here.</para>
257
258 <itemizedlist spacing='compact'>
259 <listitem>
260 <para>mga: Matrox G200/G400/G450/G550 hardware YUV overlay via the
261 mga_vid device</para>
262 </listitem>
263 <listitem>
264 <para>xmga: Matrox G200/G400/G450/G550 overlay (mga_vid) in X11
265 window</para>
266 </listitem>
267 <listitem>
268 <para>syncfb: Matrox G400 YUV support on framebuffer</para>
269 </listitem>
270 <listitem>
271 <para>3dfx: Voodoo 3/Banshee hardware YUV support (/dev/3dfx)</para>
272 </listitem>
273 <listitem>
274 <para>tdfxfb: Voodoo 3/Banshee hardware YUV support on tdfx
275 framebuffer</para>
276 </listitem>
277 <listitem>
278 <para>mpegpes: support for Siemens DVB hardware MPEG-1/2 decoder boards
279 (or MPEG-PES file output)</para>
280 </listitem>
281 <listitem>
282 <para>dxr2: support for DXR2 hardware MPEG-1/2 decoder boards
283 <ulink url="http://dxr2.sourceforge.net/">Dxr2</ulink></para>
284 </listitem>
285 <listitem>
286 <para>dxr3: support for DXR3/Hollywood+ hardware MPEG-1/2 decoder
287 boards <ulink
288 url="http://dxr3.sourceforge.net/">libdxr3</ulink></para>
289 </listitem>
290 <listitem>
291 <para>zr: support for Zoran360[56]7 based hardware MJPEG cards</para>
292 </listitem>
293 </itemizedlist>
294
295 <para condition="html" role="usernotes">User Notes:
296 <ulink url="&blfs-wiki;/mplayer"/></para>
297
298 </sect2>
299
300 <sect2 role="installation">
301 <title>Installation of MPlayer</title>
302
303 <sect3>
304 <title>CODEC Installation (Optional)</title>
305
306 <para>If you downloaded any proprietary CODECs (which can provide support
307 for additional audio and video formats such as Real, Indeo and QuickTime),
308 extract them to <filename class="directory">/usr/lib/mplayer/codecs</filename>
309 using the following commands as the <systemitem
310 class="username">root</systemitem> user (substitute and/or add different
311 CODEC filenames, if necessary):</para>
312
313<screen role="root"><userinput>install -v -d -m755 /usr/lib/mplayer/codecs &amp;&amp;
314tar -xvf ../&mplayer-codec; \
315 -C /usr/lib/mplayer/codecs --strip-components=1 &amp;&amp;
316chown -v -R root:root /usr/lib/mplayer/codecs</userinput></screen>
317
318 <para>If you installed any CODECs, ensure you add
319 <option>--with-codecsdir=/usr/lib/mplayer/codecs</option>
320 to the <command>configure</command> script.</para>
321
322 </sect3>
323
324 <sect3>
325 <title>GUI Installation (Optional)</title>
326
327 <para>To enable building the GUI version of
328 <application>MPlayer</application> (requires <xref linkend="GTK"/>), add
329 <option>--enable-gui</option> to the <command>configure</command>
330 script. You'll also need to extract at least one skin. Extract the desired
331 skin and create the default location (as the <systemitem
332 class="username">root</systemitem> user):</para>
333
334<screen role="root"><userinput>install -v -d -m755 /usr/share/mplayer/Skin &amp;&amp;
335tar -xvf ../&mplayer-skin; \
336 -C /usr/share/mplayer/Skin &amp;&amp;
337chown -v -R root:root /usr/share/mplayer/Skin/Blue &amp;&amp;
338chmod -v 755 /usr/share/mplayer/Skin/Blue{,/icons} &amp;&amp;
339ln -sfv Blue /usr/share/mplayer/Skin/default</userinput></screen>
340
341 </sect3>
342
343 <sect3>
344 <title>Installing OSD and Subtitles Support (Optional)</title>
345
346 <para>To enable OSD (On Screen Display) and subtitles support, add
347 <option>--enable-menu</option> to the <command>configure</command>
348 script. You'll also need to set up at least one font (see font
349 installation instructions a little later).</para>
350
351 </sect3>
352
353 <sect3>
354 <title>Main MPlayer Installation</title>
355
356 <note>
357 <para>The package maintainers recommend building without any
358 optimizations.</para>
359 </note>
360
361 <para><application>MPlayer</application> can build a shared
362 post-processing library from the internal
363 <application>FFmpeg</application> package which
364 other packages can link to. This requires
365 <application>MPlayer</application>
366 to link dynamically to this library instead of the default statically
367 linked method. If you desire to build the shared library, add
368 <option>--enable-shared-pp</option> and
369 <option>--disable-fastmemcpy</option> to the <command>configure</command>
370 script. The <option>--disable-fastmemcpy</option> parameter is required to
371 avoid <computeroutput>undefined reference</computeroutput> errors when
372 other packages link to the shared library.</para>
373
374 <para>You may wish to examine the output from
375 <command>./configure --help</command> to find out what additional
376 parameters to <command>configure</command> are needed to include
377 the dependencies you have installed on your system.</para>
378
379 <para>Before beginning the installation, apply an upstream fix to avoid
380 a conflict with the getline() function name:</para>
381
382<screen><userinput>sed -i 's/getline/vobsub_&amp;/' vobsub.c</userinput></screen>
383
384 <para>Install <application>MPlayer</application> by running the following
385 commands:</para>
386
387<screen><userinput>patch -Np1 -i ../MPlayer-&mplayer-version;-kernel_2.6-1.patch &amp;&amp;
388patch -Np1 -i ../MPlayer-&mplayer-version;-gcc4-1.patch &amp;&amp;
389patch -Np1 -i ../MPlayer-&mplayer-version;-round_function_fix-1.patch &amp;&amp;
390patch -Np1 -i ../MPlayer-&mplayer-version;-jack_fixes-1.patch &amp;&amp;
391patch -Np1 -i ../MPlayer-&mplayer-version;-x264_fixes-1.patch &amp;&amp;
392
393./configure --prefix=/usr \
394 --confdir=/etc/mplayer \
395 --enable-largefiles &amp;&amp;
396make</userinput></screen>
397
398 <para>This package does not come with a test suite.</para>
399
400 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
401
402<screen role="root"><userinput>make install &amp;&amp;
403
404install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
405cp -v -R DOCS/* /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
406
407 <para>Passing certain parameters to <command>configure</command> may
408 result in the creation of
409 <filename class='libraryfile'>libdha.so.1.0</filename>. If so, you may
410 wish to create a symlink to this library in case other packages link to
411 <filename class='libraryfile'>libdha.so</filename>. Use the following
412 command as the <systemitem class="username">root</systemitem> user to
413 create the symbolic link:</para>
414
415<screen role="root"><userinput>ln -v -s libdha.so.1.0 /usr/lib/libdha.so</userinput></screen>
416
417 <para>You will need <filename>codecs.conf</filename> only if you want to
418 change its properties, as the main binary contains an internal copy of
419 it. Ensure any changes you make to <filename>codecs.conf</filename>
420 achieve the desired results, as incorrect entries in this file have been
421 known to cause errors and render the player unusable. If necessary,
422 create the file using the following command.</para>
423
424<screen role="root"><userinput>install -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
425
426 <para>You may also want to copy all the default configuration files to
427 <filename class='directory'>/etc/mplayer</filename> for future reference
428 or more customization ability.</para>
429
430<screen role="root"><userinput>install -m644 etc/*.conf /etc/mplayer</userinput></screen>
431
432 <para><application>MPlayer</application> requires that the RTC run at a
433 frequency of 1024 Hz. Make this setting change at boot-time by adding
434 a line to <filename>/etc/sysctl.conf</filename>:</para>
435
436<screen role="root"><userinput>echo "dev.rtc.max-user-freq=1024" >> /etc/sysctl.conf</userinput></screen>
437
438 </sect3>
439
440 <sect3>
441 <title>OSD and Subtitles Font Installation (Required if '--enable-menu' Was
442 Passed to 'configure')</title>
443
444 <para>The recommended method to set up a font for
445 <application>MPlayer</application> is to link a TTF file to
446 your <filename class="directory">~/.mplayer</filename> directory. A link
447 should be created in each user's home directory who may use
448 <application>MPlayer</application>. For example:</para>
449
450<screen><userinput>install -v -m750 -d ~/.mplayer &amp;&amp;
451ln -v -sf /usr/share/fonts/X11-TTF/luxisri.ttf \
452 ~/.mplayer/subfont.ttf</userinput></screen>
453
454 <para>There are several other ways to set up a font package. To use a
455 prerendered <application>MPlayer</application> font package, extract
456 and link one of the font tarballs using the following commands:</para>
457
458<screen role="root"><userinput>tar -xvf ../&mplayer-font;.tar.bz2 \
459 -C /usr/share/mplayer/font &amp;&amp;
460chown -v -R root:root /usr/share/mplayer/font &amp;&amp;
461cd /usr/share/mplayer/font &amp;&amp;
462ln -v -sf &mplayer-font;/font-arial-<replaceable>&lt;font size&gt;</replaceable>-iso-8859-1/* .</userinput></screen>
463
464 <para>Available font sizes are 14, 18, 24 or 28.</para>
465
466 <para>Additional information as well as additional methods to set up an
467 <application>MPlayer</application> font package can be found at <ulink
468 url="http://www.mplayerhq.hu/DOCS/HTML/en/subosd.html#mpsub-install"/>.</para>
469
470 </sect3>
471
472 <!--
473 Following section should be removed after BLFS-6.2.
474 Current Udev creates persistent cd/dvd links automatically
475 -->
476 <sect3>
477 <title>Installation for DVD Playback (Optional)</title>
478
479 <para>If you want DVD playback with <application>MPlayer</application>,
480 you need to ensure a link exists between your DVD drive and
481 <filename>/dev/dvd</filename>. This process is described in the
482 <ulink url="&lfs-root;/chapter07/symlinks.html">Creating custom
483 symlinks to devices</ulink> section in LFS. The user must be part
484 of the <systemitem class="groupname">cdrom</systemitem> group in
485 order to use the device.</para>
486
487 </sect3>
488
489 </sect2>
490
491 <sect2 role="configuration">
492 <title>Configuring MPlayer</title>
493
494 <sect3 id="mplayer-config">
495 <title>Config Files</title>
496
497 <para><filename>/etc/mplayer/*</filename> and
498 <filename>~/.mplayer/*</filename></para>
499
500 <indexterm zone="mplayer mplayer-config">
501 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
502 </indexterm>
503
504 <indexterm zone="mplayer mplayer-config">
505 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
506 </indexterm>
507
508 </sect3>
509
510 <sect3>
511 <title>Configuration Information</title>
512
513 <para>Typically, there's no configuration required for the system-wide
514 files in <filename class='directory'>/etc/mplayer</filename> (in fact,
515 this directory is empty unless you copied the default files as mentioned
516 above). Configuration can be accomplished by choosing the configuration
517 button located on the <application>MPlayer</application> GUI. Any
518 configuration changes made here will be copied to the user's
519 <filename class='directory'>~/.mplayer</filename> directory.</para>
520
521 </sect3>
522
523 </sect2>
524
525 <sect2 role="content">
526 <title>Contents</title>
527
528 <segmentedlist>
529 <segtitle>Installed Programs</segtitle>
530 <segtitle>Installed Libraries</segtitle>
531 <segtitle>Installed Directories</segtitle>
532
533 <seglistitem>
534 <seg>gmplayer, mplayer, and mencoder</seg>
535 <seg>libdha.so and optionally, libpostproc.so</seg>
536 <seg>~/.mplayer, /etc/mplayer, /usr/include/postproc, /usr/lib/mplayer,
537 /usr/share/mplayer, and /usr/share/doc/mplayer-&mplayer-version;</seg>
538 </seglistitem>
539 </segmentedlist>
540
541 <variablelist>
542 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
543 <?dbfo list-presentation="list"?>
544 <?dbhtml list-presentation="table"?>
545
546 <varlistentry id="gmplayer">
547 <term><command>gmplayer</command></term>
548 <listitem>
549 <para>is a symlink to <command>mplayer</command> which
550 brings up the graphical user interface component of
551 <application>MPlayer</application>.</para>
552 <indexterm zone="mplayer gmplayer">
553 <primary sortas="b-gmplayer">gmplayer</primary>
554 </indexterm>
555 </listitem>
556 </varlistentry>
557
558 <varlistentry id="mplayer-prog">
559 <term><command>mplayer</command></term>
560 <listitem>
561 <para> manages the input formats, the CODECs and
562 the output formats to play video files, DVDs,
563 (S)VCDs or network streams containing audio and/or video
564 information on your system.</para>
565
566 <para>Examples:</para>
567
568<screen><userinput>mplayer -fs blfs.avi
569mplayer -vo fbdev -fb /dev/fb0 dvd://1 \
570 -aid 128 -sub en -framedrop
571mplayer -fs vcd://1 # works both for VCDs and SVCDs
572mplayer http://fredrik.hubbe.net/plugger/test.mpg</userinput></screen>
573
574 <para>For further information, look at the very good documentation
575 included with the package in the source tree subdirectory
576 <filename class="directory">DOCS</filename> (also installed at
577 <filename class='directory'>/usr/share/doc/mplayer</filename>).</para>
578 <indexterm zone="mplayer mplayer-prog">
579 <primary sortas="b-mplayer">mplayer</primary>
580 </indexterm>
581 </listitem>
582 </varlistentry>
583
584 <varlistentry id="mencoder">
585 <term><command>mencoder</command></term>
586 <listitem>
587 <para>is used to encode any <application>MPlayer</application>
588 playable movie to DivX4, <application>XviD</application> or any
589 CODEC in <filename class='libraryfile'>libavcodec</filename> with
590 PCM/MP3/VBRMP3 audio.</para>
591
592 <para>Example:</para>
593
594<screen><userinput>rm frameno.avi
595mencoder -dvd 1 -aid 128 -ovc frameno -oac mp3lame \
596-lameopts vbr=3 -o frameno.avi
597
598<literal># mencoder should output bitrates for average encodings
599# now, choose one you like best! In the following lines,
600# replace &lt;bitrate&gt; and &lt;name.avi&gt; with statements of your
601# personal liking.</literal>
602
603mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
604 -lavcopts vcodec=mpeg4:vpass=1:vhq:vbitrate=&lt;bitrate&gt; \
605 -o &lt;name.avi&gt;
606mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
607 -lavcopts vcodec=mpeg4:vpass=2:vhq:vbitrate=&lt;bitrate&gt; \
608 -o &lt;name.avi&gt;
609mencoder -forceidx &lt;name.avi&gt;</userinput></screen>
610 <indexterm zone="mplayer mencoder">
611 <primary sortas="b-mencoder">mencoder</primary>
612 </indexterm>
613 </listitem>
614 </varlistentry>
615
616 <varlistentry id="libdha">
617 <term><filename class='libraryfile'>libdha.so</filename></term>
618 <listitem>
619 <para>contains functions used by the
620 <application>MPlayer</application> programs.</para>
621 <indexterm zone="mplayer libdha">
622 <primary sortas="c-libdha">libdha.so</primary>
623 </indexterm>
624 </listitem>
625 </varlistentry>
626
627 <varlistentry id="libpostproc">
628 <term><filename class='libraryfile'>libpostproc.so</filename></term>
629 <listitem>
630 <para>is a post-processing filter library used by the
631 <application>MPlayer</application> programs and other packages.</para>
632 <indexterm zone="mplayer libpostproc">
633 <primary sortas="c-libpostproc">libpostproc.so</primary>
634 </indexterm>
635 </listitem>
636 </varlistentry>
637
638 </variablelist>
639
640 </sect2>
641
642</sect1>
Note: See TracBrowser for help on using the repository browser.