source: multimedia/videoutils/mplayer.xml@ 50d88079

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 50d88079 was 50d88079, checked in by DJ Lucas <dj@…>, 16 years ago

Commented out more XFree86 references

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