source: multimedia/videoutils/mplayer.xml@ d0151ee

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 d0151ee was d0151ee, checked in by Randy McMurchy <randy@…>, 16 years ago

Fixed broken download URLs in various package instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7445 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/skins/&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/skins/"/></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
214 url="http://www.3gpp.org/ftp/Specs/latest/Rel-7/26_series/26104-700.zip">AMR
215 narrowband (floating point)</ulink> or
216 <ulink url="http://www.3gpp.org/ftp/Specs/latest/Rel-7/26_series/26073-700.zip">AMR
217 naarrowband (fixed point)</ulink>,
218 <ulink url="http://www.3gpp.org/ftp/Specs/latest/Rel-7/26_series/26204-710.zip">
219 AMR wideband</ulink>,
220 <!-- Dead link <ulink url="http://www.divx.com/divx/linux/">DivX</ulink>, i-->
221 <xref linkend="faac"/>,
222 <xref linkend="faad2"/> (must disable the internal version),
223 <xref linkend="ffmpeg"/>,
224 <xref linkend="lame"/>,
225 <ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
226 <xref linkend="libfame"/>,
227 <xref linkend="libmad"/>,
228 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
229 <ulink url="http://svn.mplayerhq.hu/nut/src/trunk/">libnut</ulink> (SVN checkout),
230 <xref linkend="libvorbis"/>,
231 <ulink url="http://www.lirc.org/">LIRC</ulink>,
232 <ulink url="http://www.dolda2000.cjb.net/~fredrik/lirccd/">lirccd</ulink>,
233 <xref linkend="LZO"/> (requires
234 <ulink url="http://www.oberhumer.com/opensource/lzo/download/LZO-v1/lzo-1.08.tar.gz">Version 1</ulink>),
235 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
236 <ulink url="http://www.theora.org/">Theora</ulink>,
237 <ulink url="ftp://ftp.videolan.org/pub/videolan/vlc/0.8.2/contrib/toolame-02m-beta8.tar.bz2">tooLAME</ulink>,
238 <ulink url="http://sourceforge.net/projects/twolame/">TwoLAME</ulink>,
239 <ulink url="http://www.xiph.org/vorbis/">Tremor</ulink> (requires
240 <xref linkend="libvorbis"/> and you must disable the internal version),
241 <ulink url="http://www.videolan.org/developers/x264.html">x264</ulink>, and
242 <xref linkend="xvid"/></para>
243
244 <bridgehead renderas="sect4">Optional Hardware Specific Options</bridgehead>
245 <para>There is hardware specific packages (or vendor supplied software) you
246 can install to improve the performance of your video card when using
247 <application>MPlayer</application>. Some of the packages and/or vendor
248 supplied software and the <application>MPlayer</application> specific
249 driver created if it is found is shown here.</para>
250
251 <itemizedlist spacing='compact'>
252 <listitem>
253 <para>mga: Matrox G200/G400/G450/G550 hardware YUV overlay via the
254 mga_vid device</para>
255 </listitem>
256 <listitem>
257 <para>xmga: Matrox G200/G400/G450/G550 overlay (mga_vid) in X11
258 window</para>
259 </listitem>
260 <listitem>
261 <para>syncfb: Matrox G400 YUV support on framebuffer</para>
262 </listitem>
263 <listitem>
264 <para>3dfx: Voodoo 3/Banshee hardware YUV support (/dev/3dfx)</para>
265 </listitem>
266 <listitem>
267 <para>tdfxfb: Voodoo 3/Banshee hardware YUV support on tdfx
268 framebuffer</para>
269 </listitem>
270 <listitem>
271 <para>mpegpes: support for Siemens DVB hardware MPEG-1/2 decoder boards
272 (or MPEG-PES file output)</para>
273 </listitem>
274 <listitem>
275 <para>dxr2: support for DXR2 hardware MPEG-1/2 decoder boards
276 <ulink url="http://dxr2.sourceforge.net/">Dxr2</ulink></para>
277 </listitem>
278 <listitem>
279 <para>dxr3: support for DXR3/Hollywood+ hardware MPEG-1/2 decoder
280 boards <ulink
281 url="http://dxr3.sourceforge.net/">libdxr3</ulink></para>
282 </listitem>
283 <listitem>
284 <para>zr: support for Zoran360[56]7 based hardware MJPEG cards</para>
285 </listitem>
286 </itemizedlist>
287
288 <para condition="html" role="usernotes">User Notes:
289 <ulink url="&blfs-wiki;/mplayer"/></para>
290
291 </sect2>
292
293 <sect2 role="installation">
294 <title>Installation of MPlayer</title>
295
296 <sect3>
297 <title>CODEC Installation (Optional)</title>
298
299 <para>If you downloaded any proprietary CODECs (which can provide support
300 for additional audio and video formats such as Real, Indeo and QuickTime),
301 extract them to <filename class="directory">/usr/lib/mplayer/codecs</filename>
302 using the following commands as the <systemitem
303 class="username">root</systemitem> user (substitute and/or add different
304 CODEC filenames, if necessary):</para>
305
306<screen role="root"><userinput>install -v -d -m755 /usr/lib/mplayer/codecs &amp;&amp;
307tar -xvf ../&mplayer-codec; \
308 -C /usr/lib/mplayer/codecs --strip-components=1 &amp;&amp;
309chown -v -R root:root /usr/lib/mplayer/codecs</userinput></screen>
310
311 <para>If you installed any CODECs, ensure you add
312 <option>--with-codecsdir=/usr/lib/mplayer/codecs</option>
313 to the <command>configure</command> script.</para>
314
315 </sect3>
316
317 <sect3>
318 <title>GUI Installation (Optional)</title>
319
320 <para>To enable building the GUI version of
321 <application>MPlayer</application> (requires <xref linkend="gtk2"/> or
322 <xref linkend="GTK"/>), add <option>--enable-gui</option> to the
323 <command>configure</command> script. You'll also need to extract at least
324 one skin. Extract the desired skin and create the default location (as
325 the <systemitem class="username">root</systemitem> user):</para>
326
327<screen role="root"><userinput>install -v -d -m755 /usr/share/mplayer/Skin &amp;&amp;
328tar -xvf ../&mplayer-skin; \
329 -C /usr/share/mplayer/Skin &amp;&amp;
330chown -v -R root:root /usr/share/mplayer/Skin/Blue &amp;&amp;
331chmod -v 755 /usr/share/mplayer/Skin/Blue{,/icons} &amp;&amp;
332ln -sfv Blue /usr/share/mplayer/Skin/default</userinput></screen>
333
334 </sect3>
335
336 <sect3>
337 <title>Installing OSD and Subtitles Support (Optional)</title>
338
339 <para>To enable OSD (On Screen Display) and subtitles support, add
340 <option>--enable-menu</option> to the <command>configure</command>
341 script. You'll also need to set up at least one font (see font
342 installation instructions a little later).</para>
343
344 </sect3>
345
346 <sect3>
347 <title>Main MPlayer Installation</title>
348
349 <note>
350 <para>The package maintainers recommend building without any
351 optimizations.</para>
352 </note>
353
354 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
355 href="../../xincludes/X11R6_symlink.xml"/>
356
357 <para><application>MPlayer</application> can build a shared
358 post-processing library from the internal
359 <application>FFmpeg</application> package which
360 other packages can link to. This requires
361 <application>MPlayer</application>
362 to link dynamically to this library instead of the default statically
363 linked method. If you desire to build the shared library, add
364 <option>--enable-shared-pp</option> to the <command>configure</command>
365 script. Note that the <application>FFmpeg</application> package can also
366 build this library (which <application>MPlayer</application> can link to
367 instead of building it), ensure you don't overwrite an existing one.</para>
368
369 <para>You may wish to examine the output from
370 <command>./configure --help</command> to find out what additional
371 parameters to <command>configure</command> are needed to include
372 the dependencies you have installed on your system. To link in existing
373 <application>FFmpeg</application> libraries (and
374 <application>MPlayer</application> won't have to build them), you must
375 pass a total of nine additional options to the
376 <command>configure</command> script. Four to disable building the static
377 <application>FFmpeg</application> libraries, four to enable using the
378 system-installed shared libraries and
379 <option>--with-extraincdir=/usr/include/ffmpeg</option> so the build can
380 locate the <application>FFmpeg</application> interface headers.</para>
381
382 <para>Install <application>MPlayer</application> by running the following
383 commands:</para>
384
385<screen><userinput>patch -Np0 -i ../asmrules_fix_20061231.diff &amp;&amp;
386patch -Np0 -i ../cddb_fix_20070605.diff &amp;&amp;
387patch -Np1 -i ../MPlayer-&mplayer-version;-ext_ffmpeg-1.patch &amp;&amp;
388
389./configure --prefix=/usr \
390 --confdir=/etc/mplayer \
391 --enable-largefiles \
392 --enable-dynamic-plugins &amp;&amp;
393make</userinput></screen>
394
395 <para>This package does not come with a test suite.</para>
396
397 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
398
399<screen role="root"><userinput>make install &amp;&amp;
400
401install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
402cp -v -R DOCS/* /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
403
404 <para>Passing certain parameters to <command>configure</command> may
405 result in the creation of
406 <filename class='libraryfile'>libdha.so.1.0</filename>. If so, you may
407 wish to create a symlink to this library in case other packages link to
408 <filename class='libraryfile'>libdha.so</filename>. Use the following
409 command as the <systemitem class="username">root</systemitem> user to
410 create the symbolic link:</para>
411
412<screen role="root"><userinput>ln -v -s libdha.so.1.0 /usr/lib/libdha.so</userinput></screen>
413
414 <para>You will need <filename>codecs.conf</filename> only if you want to
415 change its properties, as the main binary contains an internal copy of
416 it. Ensure any changes you make to <filename>codecs.conf</filename>
417 achieve the desired results, as incorrect entries in this file have been
418 known to cause errors and render the player unusable. If necessary,
419 create the file using the following command.</para>
420
421<screen role="root"><userinput>install -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
422
423 <para>You may also want to copy all the default configuration files to
424 <filename class='directory'>/etc/mplayer</filename> for future reference
425 or more customization ability.</para>
426
427<screen role="root"><userinput>install -m644 etc/*.conf /etc/mplayer</userinput></screen>
428
429 <para><application>MPlayer</application> requires that the RTC run at a
430 frequency of 1024 Hz. Make this setting change at boot-time by adding
431 a line to <filename>/etc/sysctl.conf</filename>:</para>
432
433<screen role="root"><userinput>echo "dev.rtc.max-user-freq=1024" >> /etc/sysctl.conf</userinput></screen>
434
435 </sect3>
436
437 <sect3>
438 <title>OSD and Subtitles Font Installation (Required if '--enable-menu' Was
439 Passed to 'configure')</title>
440
441 <para>The recommended method to set up a font for
442 <application>MPlayer</application> is to link a TTF file to
443 your <filename class="directory">~/.mplayer</filename> directory. A link
444 should be created in each user's home directory who may use
445 <application>MPlayer</application>. For example:</para>
446
447<screen><userinput>install -v -m750 -d ~/.mplayer &amp;&amp;
448ln -v -sf /usr/share/fonts/X11-TTF/luxisri.ttf \
449 ~/.mplayer/subfont.ttf</userinput></screen>
450
451 <para>There are several other ways to set up a font package. To use a
452 prerendered <application>MPlayer</application> font package, extract
453 and link one of the font tarballs using the following commands:</para>
454
455<screen role="root"><userinput>tar -xvf ../&mplayer-font;.tar.bz2 \
456 -C /usr/share/mplayer/font &amp;&amp;
457chown -v -R root:root /usr/share/mplayer/font &amp;&amp;
458cd /usr/share/mplayer/font &amp;&amp;
459ln -v -sf &mplayer-font;/font-arial-<replaceable>&lt;font size&gt;</replaceable>-iso-8859-1/* .</userinput></screen>
460
461 <para>Available font sizes are 14, 18, 24 or 28.</para>
462
463 <para>Additional information as well as additional methods to set up an
464 <application>MPlayer</application> font package can be found at <ulink
465 url="http://www.mplayerhq.hu/DOCS/HTML/en/subosd.html#mpsub-install"/>.</para>
466
467 </sect3>
468
469 <!--
470 Following section should be removed after BLFS-6.2.
471 Current Udev creates persistent cd/dvd links automatically
472 <sect3>
473 <title>Installation for DVD Playback (Optional)</title>
474
475 <para>If you want DVD playback with <application>MPlayer</application>,
476 you need to ensure a link exists between your DVD drive and
477 <filename>/dev/dvd</filename>. This process is described in the
478 <ulink url="&lfs-root;/chapter07/symlinks.html">Creating custom
479 symlinks to devices</ulink> section in LFS. The user must be part
480 of the <systemitem class="groupname">cdrom</systemitem> group in
481 order to use the device.</para>
482
483 </sect3>
484 -->
485
486 </sect2>
487
488 <sect2 role="configuration">
489 <title>Configuring MPlayer</title>
490
491 <sect3 id="mplayer-config">
492 <title>Config Files</title>
493
494 <para><filename>/etc/mplayer/*</filename> and
495 <filename>~/.mplayer/*</filename></para>
496
497 <indexterm zone="mplayer mplayer-config">
498 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
499 </indexterm>
500
501 <indexterm zone="mplayer mplayer-config">
502 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
503 </indexterm>
504
505 </sect3>
506
507 <sect3>
508 <title>Configuration Information</title>
509
510 <para>Typically, there's no configuration required for the system-wide
511 files in <filename class='directory'>/etc/mplayer</filename> (in fact,
512 this directory is empty unless you copied the default files as mentioned
513 above). Configuration can be accomplished by choosing the configuration
514 button located on the <application>MPlayer</application> GUI. Any
515 configuration changes made here will be copied to the user's
516 <filename class='directory'>~/.mplayer</filename> directory.</para>
517
518 </sect3>
519
520 </sect2>
521
522 <sect2 role="content">
523 <title>Contents</title>
524
525 <segmentedlist>
526 <segtitle>Installed Programs</segtitle>
527 <segtitle>Installed Libraries</segtitle>
528 <segtitle>Installed Directories</segtitle>
529
530 <seglistitem>
531 <seg>gmplayer, mplayer, and mencoder</seg>
532 <seg>libdha.so and optionally, libpostproc.so</seg>
533 <seg>~/.mplayer, /etc/mplayer, /usr/include/postproc, /usr/lib/mplayer,
534 /usr/share/mplayer, and /usr/share/doc/mplayer-&mplayer-version;</seg>
535 </seglistitem>
536 </segmentedlist>
537
538 <variablelist>
539 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
540 <?dbfo list-presentation="list"?>
541 <?dbhtml list-presentation="table"?>
542
543 <varlistentry id="gmplayer">
544 <term><command>gmplayer</command></term>
545 <listitem>
546 <para>is a symlink to <command>mplayer</command> which
547 brings up the graphical user interface component of
548 <application>MPlayer</application>.</para>
549 <indexterm zone="mplayer gmplayer">
550 <primary sortas="b-gmplayer">gmplayer</primary>
551 </indexterm>
552 </listitem>
553 </varlistentry>
554
555 <varlistentry id="mplayer-prog">
556 <term><command>mplayer</command></term>
557 <listitem>
558 <para> manages the input formats, the CODECs and
559 the output formats to play video files, DVDs,
560 (S)VCDs or network streams containing audio and/or video
561 information on your system.</para>
562
563 <para>Examples:</para>
564
565<screen><userinput>mplayer -fs blfs.avi
566mplayer -vo fbdev -fb /dev/fb0 dvd://1 \
567 -aid 128 -sub en -framedrop
568mplayer -fs vcd://1 # works both for VCDs and SVCDs
569mplayer http://fredrik.hubbe.net/plugger/test.mpg</userinput></screen>
570
571 <para>For further information, look at the very good documentation
572 included with the package in the source tree subdirectory
573 <filename class="directory">DOCS</filename> (also installed at
574 <filename class='directory'>/usr/share/doc/mplayer-&mplayer-version;</filename>).</para>
575
576 <indexterm zone="mplayer mplayer-prog">
577 <primary sortas="b-mplayer">mplayer</primary>
578 </indexterm>
579 </listitem>
580 </varlistentry>
581
582 <varlistentry id="mencoder">
583 <term><command>mencoder</command></term>
584 <listitem>
585 <para>is used to encode any <application>MPlayer</application>
586 playable movie to DivX4, <application>XviD</application> or any
587 CODEC in <filename class='libraryfile'>libavcodec</filename> with
588 PCM/MP3/VBRMP3 audio.</para>
589
590 <para>Example:</para>
591
592<screen><userinput>rm frameno.avi
593mencoder -dvd 1 -aid 128 -ovc frameno -oac mp3lame \
594-lameopts vbr=3 -o frameno.avi
595
596<literal># mencoder should output bitrates for average encodings
597# now, choose one you like best! In the following lines,
598# replace &lt;bitrate&gt; and &lt;name.avi&gt; with statements of your
599# personal liking.</literal>
600
601mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
602 -lavcopts vcodec=mpeg4:vpass=1:vhq:vbitrate=&lt;bitrate&gt; \
603 -o &lt;name.avi&gt;
604mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
605 -lavcopts vcodec=mpeg4:vpass=2:vhq:vbitrate=&lt;bitrate&gt; \
606 -o &lt;name.avi&gt;
607mencoder -forceidx &lt;name.avi&gt;</userinput></screen>
608 <indexterm zone="mplayer mencoder">
609 <primary sortas="b-mencoder">mencoder</primary>
610 </indexterm>
611 </listitem>
612 </varlistentry>
613
614 <varlistentry id="libdha">
615 <term><filename class='libraryfile'>libdha.so</filename></term>
616 <listitem>
617 <para>contains functions used by the
618 <application>MPlayer</application> programs.</para>
619 <indexterm zone="mplayer libdha">
620 <primary sortas="c-libdha">libdha.so</primary>
621 </indexterm>
622 </listitem>
623 </varlistentry>
624
625 <varlistentry id="libpostproc">
626 <term><filename class='libraryfile'>libpostproc.so</filename></term>
627 <listitem>
628 <para>is a post-processing filter library used by the
629 <application>MPlayer</application> programs and other packages.</para>
630 <indexterm zone="mplayer libpostproc">
631 <primary sortas="c-libpostproc">libpostproc.so</primary>
632 </indexterm>
633 </listitem>
634 </varlistentry>
635
636 </variablelist>
637
638 </sect2>
639
640</sect1>
Note: See TracBrowser for help on using the repository browser.