From ArchWiki
Revision as of 08:45, 3 October 2013 by Flu (talk | contribs) (Page created.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

From the project home page:

Movie player based on MPlayer and mplayer2. It supports a wide variety of video file formats, audio and video codecs, and subtitle types. If you are wondering what's different from mplayer2 and MPlayer you can read more about the changes.


Install mpv-gitAUR from the AUR. Alternatively install cmplayerAUR Qt5 frontend which provides its own mpv.


System-wide configuration is located in /etc/mpv/mpv.conf, whereas the user-local settings are stored in ~/.mpv/config. The complete list of options is located here.

Tip: If you prefer a custom location for configurations, set the MPV_HOME variable as you like in your shell configuration file. A predictable choice is MPV_HOME=$XDG_CONFIG_HOME/mpv.

An example configuration:

# default configuration that applies to every file

# use X11 for video output, use a wayland and framebuffer as fallbacks

# use alsa for audio output, choose oss4 as fallback

# multithreaded decoding of H264/MPEG-1/2 (valid: 0-16)

# prefer using six channels audio

# scale the subtitles to the 3% of the screen size

# set the window title using the media filename, when not set with --title.

# add black borders so the movies have the same aspect ratio of the monitor
# for wide screen monitors

# for non wide screen traditional monitors, alternative to the above item

# disable screensaver

# execute a command every 30 seconds
# useful to disable a non-standard-compliant screensavers and to work around buggy behaviours
# BE WARNED: to avoid dangerous commands is your responsibility
#heartbeat-cmd="xscreensaver-command -deactivate &" # stop xscreensaver

# custom heartbeat frequency in seconds

# correct pitch when speed is faster or slower than 1.0

# allow to seek in a file which is still downloading whilst watching it

# allow to increase the maximal volume to 600%

# skip displaying some frames to maintain A/V sync on slow systems

# more intense frame dropping (breaks decoding)

# profile for up-mixing two channels audio to six channels
# use -profile 2chto6ch to activate

# profile to down-mixing six channels audio to two channels
# use -profile 6chto2ch to activate

See another example at

Enable VDPAU

You can speed up the player using the GPU VDPAU API. The procedure is the same of MPlayer.

Key bindings

System key bindings are configured via /etc/mpv/input.conf. Personal key bindings are stored in ~/.mpv/input.conf. Available keybinds and configuration are explained in the manual pages.

Automatic resuming from where you left off

The default key to quit saving the video advance state is Q. This behaviour is controlled by the quit_watch_later string in the key bindings configuration file.

Quick aspect ratio change

Append to your input.conf:

F1 set aspect 1.3333
F2 set aspect 1.6
F3 set aspect 1.7777
F4 set aspect 1.85
F5 set aspect 0

Now you are able to change the aspect ratio with F1 to F5 keys.