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.


USE flags

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

X Add support for X11 global
a52 Enable support for decoding ATSC A/52 streams used in DVD global
aalib Add support for media-libs/aalib (ASCII-Graphics Library) global
alsa Add support for media-libs/alsa-lib (Advanced Linux Sound Architecture) global
altivec Add support for optimizations for G4 and G5/ppc970 processors global
aqua Include support for the Mac OS X Aqua (Carbon/Cocoa) GUI global
bidi Enable bidirectional language support global
bl Blinkenlights video output local
bluray Enable playback of Blu-ray filesystems local
bs2b Enable Bauer stereophonic-to-binaural headphone filter local
cddb Access cddb servers to retrieve and submit information about compact disks global
cdio Use libcdio for CD support (instead of cdparanoia) local
cdparanoia Enable cdparanoia (audio CD ripper) support global
cpudetection Enables runtime CPU detection (useful for binpkgs, compatibility on other CPUs) local
debug Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see global
dga Add DGA (Direct Graphic Access) support for X global
directfb Add support for DirectFB layer (library for FB devices) global
doc Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally global
dts Enable DTS Coherent Acoustics decoder support global
dv Enable support for a codec used by many camcorders global
dvb Add support for DVB (Digital Video Broadcasting) global
dvd Add support for DVDs global
dvdnav Use forked libdvdnav, navigate menus in GUIs local
enca Enables support for charset discovery and conversion local
encode Add support for encoding of audio or video files global
faac Use external faac library for AAC encoding local
faad Use external faad library for AAC decoding local
fbcon Add framebuffer support for the console, via the kernel global
ftp Add FTP (File Transfer Protocol) support global
ggi Add support for media-libs/libggi (non-X video api/drivers) global
gif Add GIF image support global
gsm Add support for the gsm lossy speech compression codec global
iconv Enable support for the iconv character set conversion library global
ipv6 Add support for IP version 6 global
jack Add support for the JACK Audio Connection Kit global
joystick Add support for joysticks in all packages global
jpeg Add JPEG image support global
ladspa Enable the ability to support ladspa plugins global
libass SRT/SSA/ASS (SubRip / SubStation Alpha) subtitle support global
libcaca Add support for colored ASCII-art graphics global
libmpeg2 Build support for mpeg2 over media-libs/libmpeg2 rather than using ffmpeg. local
lirc Add support for lirc (Linux's Infra-Red Remote Control) global
live Enables streaming media support local
lzo Enable support for lzo compression global
mad Add support for mad (high-quality mp3 decoder library and cli frontend) global
md5sum Enables md5sum video output local
mng MNG input support local
mp3 Add support for reading mp3 files global
nas Add support for network audio sound global
network Enables network streaming support local
nut Enables support for the NUT container format local
openal Add support for the Open Audio Library global
opengl Add support for OpenGL (3D graphics) global
osdmenu Enables support for on-screen display (OSD) menus local
oss Add support for OSS (Open Sound System) global
png Add support for libpng (PNG images) global
pnm Add PNM video output option, to create PPM/PGM/PGMYUV images local
pulseaudio Add support for PulseAudio sound server global
pvr Enable Video4Linux2 MPEG PVR local
radio Enable V4L2 radio interface and support local
rar Enable Unique RAR File Library local
rtc Enables usage of the linux real time clock. The alternative is software emulation of rtc local
rtmp Enables RTMPDump Streaming Media support local
samba Add support for SAMBA (Windows File and Printer sharing) global
sdl Add support for Simple Direct Layer (media library) global
selinux !!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur global
shm Enable support for shm local
speex Add support for the speex audio codec (used for speech) global
tga Enables Targa video output local
theora Add support for the Theora Video Compression Codec global
toolame Enable toolame MPEG-2 encoding local
tremor Enable internal support for Vorbis local
truetype Add support for FreeType and/or FreeType2 fonts global
twolame Enable twolame MPEG-2 encoding local
unicode Add support for Unicode global
v4l Enable support for video4linux (using linux-headers or userspace libv4l libraries) global
vcd Enables VCD support local
vdpau Enable the Video Decode and Presentation API for Unix acceleration interface global
vidix Support for vidix video output local
vorbis Add support for the OggVorbis audio codec global
x264 Enable h264 encoding using x264 global
xinerama Add support for the xinerama X11 extension, which is mandatory if you work in multiple monitors setup global
xscreensaver Add support for XScreenSaver extension global
xv Add in optional support for the Xvideo extension (an X API for video playback) global
xvid Add support for's open-source mpeg-4 codec global
xvmc Enables X-Video Motion Compensation support local
yuv4mpeg Enables yuv4mpeg video output local
zoran Enables ZR360[56]7/ZR36060 video output local


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:


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.