source: multimedia/videoutils/mplayer.xml@ 68c8cba

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

First cut at adding instructions to create an /usr/X11R6 compatibility symlink

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