What is mpv?
mpv is a free, open-source media player for the command line, based on MPlayer and mplayer2. It has no official GUI — only a small on-screen controller over the video — and is driven by keyboard, mouse and a configuration file rather than menus, which is why it works both as a player people run directly and as an engine other players embed (IINA on macOS is built on it). It is licensed GPLv2 or later by default, or LGPLv2.1 or later when built with -Dgpl=false. On macOS the project supports 10.15 or later but publishes no official binary, pointing users to third-party packages instead. It suits anyone who wants precise control over playback and video output rather than a conventional application.
Verified product facts
- Type
- media playerEditorially reviewed
- Platform
- macOS
- Pricing
- Open sourceDeveloper-stated
- Open source
- Yes
- Developer
- The mpv projectDeveloper-stated
- Relationship to Nuanyue
- Third-party product — not published by NuanyueEditorially reviewed
- Licence
- GPL-2.0-or-later
- Current version
- 0.41.0Developer-stated
- Official website
- www.mpv.io/
Last updated . Facts marked developer-stated come from the developer and are not independently confirmed; editorially reviewed marks a Nuanyue judgement.
Key features
What mpv does at a glance.
Command-line player
With no official GUI, only an on-screen controller
Wide format, codec and subtitle support
Through FFmpeg
GPU video output (OpenGL, Vulkan, D3D11)
With scaling, colour management and HDR
Runtime hardware video decoding
Lua and JavaScript scripting
Plus a large collection of user scripts
Embeddable C API (libmpv) used
By other players
What you can use mpv for
- Playing media files from the command line
- Playing video across the formats and codecs FFmpeg supports
- Scripting playback behaviour with Lua or JavaScript
- Embedding playback in another application through libmpv
- Tuning video output for scaling, colour management or HDR
Who is mpv for?
- People who want precise control over playback and video output rather than a conventional application
- Users comfortable with the command line and configuration files
- Developers embedding a playback engine through libmpv
Who is mpv not for?
- Anyone who wants a menu-driven graphical player — mpv has no official GUI beyond the on-screen controller
- Mac users who want an official download — the project publishes no official macOS binary and points to third-party packages
- People who expect the player to register itself as the default media app — associations are set manually through Finder
- Macs running macOS 10.14 or earlier — mpv supports macOS 10.15 or later
Limitations
- Hardware decoding is not enabled by default and must be turned on with --hwdec
- Apple Silicon support is not stated in the sources Nuanyue tracks
Strengths and trade-offs
What mpv does well, and what to weigh before choosing it. Points marked developer-stated come from the developer’s own material and have not been independently confirmed.
Strengths
- Free and open source under GPLv2 or later, with an LGPLv2.1-or-later build option for embedding.
- Decoding comes from FFmpeg, so it plays a wide range of file formats, audio and video codecs and subtitle types.Developer-stated
- The video output (OpenGL, Vulkan, D3D11) exposes high-quality scaling, colour management, frame timing and HDR.Developer-stated
Trade-offs
- It has no official GUI: control is by keyboard, mouse, configuration file and the small on-screen controller, which is a barrier if you expect menus.Developer-stated
- The project publishes no official macOS binary; mpv.io points users to third-party packages and to builds it describes as intended mainly for testing.
First-use experience
What the app asks of you when you set it up. Only established facts appear here; anything we could not confirm is left out rather than guessed at.
- Installation
- There is no official .dmg; mpv.io lists third-party macOS packages — Homebrew (a formula without application bundles), MacPorts and stolendata's builds — alongside first-party CI builds it describes as intended mainly for testing.
- First launch Developer-stated
- mpv is command-line driven. Launched from the macOS application bundle it opens in a pseudo-GUI mode with the on-screen controller over the video.
- System integration Editorially reviewed
- mpv does not install a helper to register itself as the default media application on macOS; associations are set manually through Finder's Open With panel.
What it does
mpv is a media player based on MPlayer and mplayer2. It plays a wide range of
video file formats, audio and video codecs and subtitle types, and can read
input from sources other than local files through special URL types. It is
free and open source: GPLv2 or later by default, or LGPLv2.1 or later when
built with -Dgpl=false.
Command-line first
mpv has no official GUI. Control is command-driven — keyboard, mouse, a configuration file — with only the on-screen controller (OSC) drawn over the video for basic control. The manual is explicit that the OSC is not a full GUI and is not meant to be one. Everything the player does is reachable from the command line and the configuration file, which is what makes it scriptable and why other applications embed it rather than reimplement playback.
Video output and decoding
mpv’s video output is built around quality rather than convenience. Version
0.41.0 makes the libplacebo-based gpu-next the default, with OpenGL, Vulkan
and D3D11 backends offering high-quality scaling, colour management, frame
timing, interpolation and HDR. Hardware decoding is available at runtime but
must be enabled with --hwdec; the project notes hardware decoding may help
when the CPU is too slow to decode video in real time.
Installing on macOS
The project does not publish an official macOS binary. mpv.io/installation points macOS users at third-party packages — Homebrew (a formula without application bundles), MacPorts and stolendata’s builds — plus first-party CI builds that the page describes as intended mainly for testing and possibly missing features. The same page recommends the latest git master over release tarballs, which is unusual for software at this scale and worth knowing before installing.
Apple Silicon
Recorded as unknown. The README lists macOS 10.15 or later but does not state the build’s architecture, and neither mpv.io nor the 0.41.0 release notes mention Apple Silicon or arm64. Nuanyue leaves the field unestablished rather than inferring it from third-party builds.
Release history
Dated releases recorded for mpv, newest first, each with the source it was read from.
0.41.0
Current stable release: the libplacebo-based gpu-next becomes the default video output, Vulkan hardware decoding is preferred, and a right-click context menu script is added.
Source: Source repository
Questions about mpv
Is mpv free?
Yes. mpv is free and open source, licensed GPLv2 or later by default or LGPLv2.1 or later when built with -Dgpl=false. It is distributed as source and third-party packages; there is no paid edition.
Does mpv have a GUI?
No. The manual states mpv has no official GUI other than the on-screen controller (OSC), which it describes as not a full GUI and not meant to be one. Control is command-driven, by keyboard, mouse and configuration file.Developer-stated
Which macOS version does mpv require?
macOS 10.15 or later, as listed in the project's README system requirements.
How do I install mpv on macOS?
There is no official .dmg. mpv.io/installation points macOS users to third-party packages — Homebrew (a formula without application bundles), MacPorts and stolendata's builds — and to first-party CI builds it describes as intended mainly for testing.
What is the latest mpv version?
0.41.0, published on 21 December 2025. mpv cuts a 0.X.0 release once or twice a year and does not maintain older releases except for security issues.
Alternatives to mpv
Apps that could replace this one — the same job, a different trade-off.
IINA
Native macOS video player built on mpv.
IINA is a native macOS player built on libmpv, mpv's own library — the same engine with a full Mac interface, which mpv itself does not provide.
Elmedia Player
Mac media player with wide codec support and one-click casting.
Both are Mac media players; Elmedia is a commercial app with a free tier and a conventional interface.
Competitors
Direct competitors: overlapping features aimed at the same users.
VLC
Free open-source player for most media formats.
Both are free, open-source players with wide format support; VLC ships a full GUI and its own decoders, mpv a minimal command-driven interface.
Works well with
Not a replacement — apps commonly used alongside this one.
HandBrake
Video transcoder for converting media to modern formats.
mpv plays media while HandBrake transcodes it — a common pairing when a file needs converting rather than playing.
Links
Sources
Facts on this page are checked against the sources below. Last updated .
- mpv — official websiteGrade B
- The mpv project — developer websiteGrade B
- mpv — documentationGrade C
- mpv — source repositoryGrade D
