source: multimedia/videoutils/mplayer.xml@ 222787b9

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 222787b9 was 222787b9, checked in by Alexander E. Patrakov <alexander@…>, 16 years ago

Added FAAC

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