source: multimedia/videoutils/mplayer.xml@ 6122386

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 6122386 was 6122386, checked in by DJ Lucas <dj@…>, 13 years ago

Removed NAS and RMan from the book.

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