Introduction to MPlayer

The MPlayer package contains an audio/video player controlled via the command line or a graphical interface which is able to play almost every popular audio and video file format and CODEC (COder/DECoder, also COmpressor/DECompressor). With supported video hardware and additional drivers, MPlayer can play video files without an X Window System installed.

For MPlayer general information and available features, including a full list of file formats, CODECs and output devices supported by MPlayer, visit the MPlayer web site.

Package Information

Additional Downloads






The CODECs, skins and fonts are not required to build and use MPlayer.

MPlayer Dependencies

Optional Input Drivers and Libraries

CDParanoia-III-9.8, libdv-0.104, libdvdread-0.9.6 (must disable internal mpdvdkit support), Samba-3.0.23d, LIVE555 Streaming Media, TiVo vstream client, DVB drivers, and DVB

Optional Audio Output Drivers and Libraries

ALSA-1.0.13, aRts-1.5.6, EsounD-0.2.36, NAS-1.7, SDL-1.2.11 (also used for video output), XMMS-1.2.10, PulseAudio, bio2jack (requires JACK), and LADSPA

Optional Video Output Drivers and Libraries

X Window System, libpng-1.2.12, libjpeg-6b, giflib-4.1.4, GTK+-1.2.10, FreeType-2.1.10, Fontconfig-2.3.2, AAlib-1.4rc5, FriBidi-0.10.7, XvMC Wrapper (only if you have XFree86 installed), DirectFB, SVGAlib, GGI, libcaca, and Enca

Optional CODECs

libvorbis-1.1.2, XviD-1.1.0, LZO-2.02 (requires Version 1), libmad-0.15.1b, LAME-3.96.1, libFAME-0.9.1, Theora, Tremor (requires libvorbis-1.1.2 and you must disable the internal version), FAAD2 (must disable internal version to use the system-installed version), x264, AMR narrowband (floating point) or AMR naarrowband (fixed point), AMR wideband, tooLAME, libdca, lirccd, and LIRC

Optional Hardware Specific Options

There is hardware specific packages (or vendor supplied software) you can install to improve the performance of your video card when using MPlayer. Some of the packages and/or vendor supplied software and the MPlayer specific driver created if it is found is shown here.

  • mga: Matrox G200/G400/G450/G550 hardware YUV overlay via the mga_vid device

  • xmga: Matrox G200/G400/G450/G550 overlay (mga_vid) in X11 window

  • syncfb: Matrox G400 YUV support on framebuffer

  • 3dfx: Voodoo 3/Banshee hardware YUV support (/dev/3dfx)

  • tdfxfb: Voodoo 3/Banshee hardware YUV support on tdfx framebuffer

  • mpegpes: support for Siemens DVB hardware MPEG-1/2 decoder boards (or MPEG-PES file output)

  • dxr2: support for DXR2 hardware MPEG-1/2 decoder boards Dxr2

  • dxr3: support for DXR3/Hollywood+ hardware MPEG-1/2 decoder boards libdxr3

  • zr: support for Zoran360[56]7 based hardware MJPEG cards

User Notes:

Installation of MPlayer

CODEC Installation (Optional)

If you downloaded any proprietary CODECs (which can provide support for additional audio and video formats such as Real, Indeo and QuickTime), extract them to /usr/lib/mplayer/codecs using the following commands as the root user (substitute and/or add different CODEC filenames, if necessary):

install -v -d -m755 /usr/lib/mplayer/codecs &&
tar -xvf ../essential-20061022.tar.bz2 \
    -C /usr/lib/mplayer/codecs --strip-components=1 &&
chown -v -R root:root /usr/lib/mplayer/codecs

If you installed any CODECs, ensure you add --with-codecsdir=/usr/lib/mplayer/codecs to the configure script.

GUI Installation (Optional)

To enable building the GUI version of MPlayer (requires GTK+-1.2.10), add --enable-gui to the configure script. You'll also need to extract at least one skin. Extract the desired skin and create the default location (as the root user):

install -v -d -m755 /usr/share/mplayer/Skin &&
tar -xvf ../Blue-1.7.tar.bz2 \
    -C /usr/share/mplayer/Skin &&
chown -v -R root:root /usr/share/mplayer/Skin/Blue &&
chmod -v 755 /usr/share/mplayer/Skin/Blue{,/icons} &&
ln -sfv Blue /usr/share/mplayer/Skin/default

Installing OSD and Subtitles Support (Optional)

To enable OSD (On Screen Display) and subtitles support, add --enable-menu to the configure script. You'll also need to set up at least one font (see font installation instructions a little later).

Main MPlayer Installation



The package maintainers recommend building without any optimizations.

MPlayer can build a shared post-processing library from the internal FFmpeg package which other packages can link to. This requires MPlayer to link dynamically to this library instead of the default statically linked method. If you desire to build the shared library, add --enable-shared-pp and --disable-fastmemcpy to the configure script. The --disable-fastmemcpy parameter is required to avoid undefined reference errors when other packages link to the shared library.

You may wish to examine the output from ./configure --help to find out what additional parameters to configure are needed to include the dependencies you have installed on your system.

Before beginning the installation, apply an upstream fix to avoid a conflict with the getline() function name:

sed -i 's/getline/vobsub_&/' vobsub.c

Install MPlayer by running the following commands:

patch -Np1 -i ../MPlayer-1.0pre7try2-kernel_2.6-1.patch &&
patch -Np1 -i ../MPlayer-1.0pre7try2-gcc4-1.patch &&
patch -Np1 -i ../MPlayer-1.0pre7try2-round_function_fix-1.patch &&
patch -Np1 -i ../MPlayer-1.0pre7try2-jack_fixes-1.patch &&
patch -Np1 -i ../MPlayer-1.0pre7try2-x264_fixes-1.patch &&

./configure --prefix=/usr \
            --confdir=/etc/mplayer \
            --enable-largefiles &&

This package does not come with a test suite.

Now, as the root user:

make install &&

install -v -m755 -d /usr/share/doc/mplayer-1.0pre7try2 &&
cp -v -R DOCS/*     /usr/share/doc/mplayer-1.0pre7try2

Passing certain parameters to configure may result in the creation of If so, you may wish to create a symlink to this library in case other packages link to Use the following command as the root user to create the symbolic link:

ln -v -s /usr/lib/

You will need codecs.conf only if you want to change its properties, as the main binary contains an internal copy of it. Ensure any changes you make to codecs.conf achieve the desired results, as incorrect entries in this file have been known to cause errors and render the player unusable. If necessary, create the file using the following command.

install -m644 etc/codecs.conf /etc/mplayer

You may also want to copy all the default configuration files to /etc/mplayer for future reference or more customization ability.

install -m644 etc/*.conf /etc/mplayer

MPlayer requires that the RTC run at a frequency of 1024 Hz. Make this setting change at boot-time by adding a line to /etc/sysctl.conf:

echo "dev.rtc.max-user-freq=1024" >> /etc/sysctl.conf

OSD and Subtitles Font Installation (Required if '--enable-menu' Was Passed to 'configure')

The recommended method to set up a font for MPlayer is to link a TTF file to your ~/.mplayer directory. A link should be created in each user's home directory who may use MPlayer. For example:

install -v -m750 -d ~/.mplayer &&
ln -v -sf /usr/share/fonts/X11-TTF/luxisri.ttf \

There are several other ways to set up a font package. To use a prerendered MPlayer font package, extract and link one of the font tarballs using the following commands:

tar -xvf ../font-arial-iso-8859-1.tar.bz2 \
    -C /usr/share/mplayer/font &&
chown -v -R root:root /usr/share/mplayer/font &&
cd /usr/share/mplayer/font &&
ln -v -sf font-arial-iso-8859-1/font-arial-<font size>-iso-8859-1/* .

Available font sizes are 14, 18, 24 or 28.

Additional information as well as additional methods to set up an MPlayer font package can be found at

Installation for DVD Playback (Optional)

If you want DVD playback with MPlayer, you need to ensure a link exists between your DVD drive and /dev/dvd. This process is described in the Creating custom symlinks to devices section in LFS. The user must be part of the cdrom group in order to use the device.

Configuring MPlayer

Config Files

/etc/mplayer/* and ~/.mplayer/*

Configuration Information

Typically, there's no configuration required for the system-wide files in /etc/mplayer (in fact, this directory is empty unless you copied the default files as mentioned above). Configuration can be accomplished by choosing the configuration button located on the MPlayer GUI. Any configuration changes made here will be copied to the user's ~/.mplayer directory.


Installed Programs: gmplayer, mplayer, and mencoder
Installed Libraries: and optionally,
Installed Directories: ~/.mplayer, /etc/mplayer, /usr/include/postproc, /usr/lib/mplayer, /usr/share/mplayer, and /usr/share/doc/mplayer-1.0pre7try2

Short Descriptions


is a symlink to mplayer which brings up the graphical user interface component of MPlayer.


manages the input formats, the CODECs and the output formats to play video files, DVDs, (S)VCDs or network streams containing audio and/or video information on your system.


mplayer -fs blfs.avi
mplayer -vo fbdev -fb /dev/fb0 dvd://1 \
    -aid 128 -sub en -framedrop
mplayer -fs vcd://1    # works both for VCDs and SVCDs
mplayer \

For further information, look at the very good documentation included with the package in the source tree subdirectory DOCS (also installed at /usr/share/doc/mplayer).


is used to encode any MPlayer playable movie to DivX4, XviD or any CODEC in libavcodec with PCM/MP3/VBRMP3 audio.


rm frameno.avi
mencoder -dvd 1 -aid 128 -ovc frameno -oac mp3lame \
-lameopts vbr=3 -o frameno.avi

# mencoder should output bitrates for average encodings
# now, choose one you like best! In the following lines,
# replace <bitrate> and <name.avi> with statements of your
# personal liking.

mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
    -lavcopts vcodec=mpeg4:vpass=1:vhq:vbitrate=<bitrate> \
    -o <name.avi>
mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
    -lavcopts vcodec=mpeg4:vpass=2:vhq:vbitrate=<bitrate> \
    -o <name.avi>
mencoder -forceidx <name.avi>

contains functions used by the MPlayer programs.

is a post-processing filter library used by the MPlayer programs and other packages.

Last updated on 2007-02-01 21:54:56 -0600