From Gentoo Wiki
Jump to: navigation, search
This page contains changes which are not marked for translation.


MPlayer is a powerful command-line media player.

MPlayer is not very actively maintained anymore, but still alive. However, its fork MPV is active and it comes with some extra features too.


USE flags

USE flags for media-video/mplayer Media Player for Linux

a52 Enable support for decoding ATSC A/52 streams used in DVD
aalib Add support for media-libs/aalib (ASCII-Graphics Library)
aqua Include support for the Mac OS X Aqua (Carbon/Cocoa) GUI
bidi Enable bidirectional language support
bl Blinkenlights video output
bluray Enable playback of Blu-ray filesystems
bs2b Enable Bauer stereophonic-to-binaural headphone filter
cddb Access cddb servers to retrieve and submit information about compact disks
cdio Use libcdio for CD support (instead of cdparanoia)
cdparanoia Enable cdparanoia (audio CD ripper) support
cpudetection Enables runtime CPU detection (useful for binpkgs, compatibility on other CPUs)
dga Add DGA (Direct Graphic Access) support for X
dts Enable DTS Coherent Acoustics decoder support
dv Enable support for a codec used by many camcorders
dvdnav Use forked libdvdnav, navigate menus in GUIs
enca Enables support for charset discovery and conversion
faac Use external faac library for AAC encoding
faad Use external faad library for AAC decoding
fbcon Add framebuffer support for the console, via the kernel
ftp Add FTP (File Transfer Protocol) support
ggi Add support for media-libs/libggi (non-X video api/drivers)
gif Add GIF image support
ladspa Enable the ability to support ladspa plugins
libass SRT/SSA/ASS (SubRip / SubStation Alpha) subtitle support
libcaca Add support for colored ASCII-art graphics
libmpeg2 Build support for mpeg2 over media-libs/libmpeg2 rather than using ffmpeg.
live Enables streaming media support
mad Add support for mad (high-quality mp3 decoder library and cli frontend)
md5sum Enables md5sum video output
mng MNG input support
mp3 Add support for reading mp3 files
nas Add support for network audio sound
network Enables network streaming support
nut Enables support for the NUT container format
openal Add support for the Open Audio Library
osdmenu Enables support for on-screen display (OSD) menus
pnm Add PNM video output option, to create PPM/PGM/PGMYUV images
pulseaudio Add support for PulseAudio sound server
pvr Enable Video4Linux2 MPEG PVR
radio Enable V4L2 radio interface and support
rar Enable Unique RAR File Library
rtc Enables usage of the linux real time clock. The alternative is software emulation of rtc
rtmp Enables RTMPDump Streaming Media support
samba Add support for SAMBA (Windows File and Printer sharing)
shm Enable support for shm
speex Add support for the speex audio codec (used for speech)
tga Enables Targa video output
theora Add support for the Theora Video Compression Codec
toolame Enable toolame MPEG-2 encoding
tremor Enable internal support for Vorbis
twolame Enable twolame MPEG-2 encoding
vcd Enables VCD support
vdpau Enable the Video Decode and Presentation API for Unix acceleration interface
vidix Support for vidix video output
vorbis Add support for the OggVorbis audio codec
x264 Enable h264 encoding using x264
xinerama Add support for querying multi-monitor screen geometry through the Xinerama API
xvid Add support for's open-source mpeg-4 codec
yuv4mpeg Enables yuv4mpeg video output
zoran Enables ZR360[56]7/ZR36060 video output


Install media-video/mplayer:

root #emerge --ask media-video/mplayer


GUI tools

There are a number of different GUI's for MPlayer with different levels of functionality. Some notable ones include:


Streaming videos from websites

MPlayer has the ability to stream videos from websites. As a prerequisite, media-video/ffmpeg must have the openssl and gnutls USE flags enabled. To do this, simply enter the command:

user $mplayer url

Where url is the URL of the video.


Disable screensaver while playing a video

Using qdbus (Qt/KDE):

FILE ~/.mplayer/config
heartbeat-cmd="qdbus org.freedesktop.ScreenSaver /ScreenSaver SimulateUserActivity"

For systems using xscreensaver alone:

FILE ~/.mplayer/config
heartbeat-cmd="xscreensaver-command -deactivate >&- 2>&- &"

See this FAQ entry for more informations.


My video won't play!

MPlayer uses USE flags to enable and disable support for various codecs. If a particular type of file will not play in MPlayer, first check which USE flags MPlayer was emerged with. Update the USE flags to support for the format you are trying to play and recompile.