mpv is a free (as in freedom) media player for the command line. It supports a wide variety of media file formats, audio and video codecs, and subtitle types.


Powerful scripting capabilities can make the player do almost anything. There is a large selection of user scripts on the wiki.

 On Screen Controller

While mpv strives for minimalism and provides no real GUI, it has a small controller on top of the video for basic control.

 High quality video output

mpv has an OpenGL, Vulkan, and D3D11 based video output that is capable of many features loved by videophiles, such as video scaling with popular high quality algorithms, color management, frame timing, interpolation, HDR, and more.

 GPU video decoding

mpv can leverage most hardware decoding APIs on all platforms. Hardware decoding can be enabled at runtime on demand.


A straightforward C API was designed from the ground up to make mpv usable as a library and facilitate easy integration into other applications.

 Active development

mpv is under active development, focusing on code refactoring and cleanups as well as adding features. Want a feature? Post a patch or request it!



Using git master is recommended.


All binary packages are unofficial third-party builds.

Windows builds by shinchiro (releases and git)
Scoop (git)
Compilation instructions
MSYS2 source package


Unofficial third-party builds.

macOS builds by stolendata
macOS nightly builds by jnozsc
Homebrew (without macOS application bundles)

 Source code

If you want bleeding edge functionality, link against git versions of FFmpeg or if a package for your platform is not available or updated, you can build mpv from source code. The helper build scripts are recommended for most users since they perform a static build of FFmpeg and libass as well as mpv.

git repository
Latest stable release tarball
Release changelog
Helper build scripts for *nix systems

 Linux packages

Distributions usually package outdated, unmaintained, and unsupported versions of mpv. This is especially true for popular distros like Debian and Ubuntu. You are recommended to use mpv-build or third-party packages instead. All of these packages are unofficial.

Arch (aur, git package)
Arch (aur, mpv-build package)
Debian multimedia (unofficial)
Gentoo (official package)
Ubuntu (PPA)
Ubuntu and Debian (apt repository)

 Mobile platforms


Other platforms

FreeBSD (Freshports)