install

Additional install commands

macOS

Homebrewverified · 100%

brew install mpv

local Homebrew formula metadata

MacPortsverified · 94%

sudo port install mpv

MacPorts ports tree · multimedia/mpv/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%

sudo apk add mpv

Alpine Linux edge package indexes · mpv · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%

sudo apt install libmpv-dev

Debian stable package indexes · libmpv-dev · source: deb.debian.org

Fedora dnfverified · 92%

sudo dnf install mpv

Fedora Rawhide package metadata · mpv · source: dl.fedoraproject.org

Nixverified · 92%

nix profile install nixpkgs#mpv

nixpkgs package indexes · pkgs/by-name/mp/mpv/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%

sudo pacman -S mpv

Arch Linux sync databases · mpv · source: geo.mirror.pkgbuild.com

openSUSE zypperverified · 92%

sudo zypper install libmpv2

openSUSE Tumbleweed package metadata · libmpv2 · source: download.opensuse.org

Windows

Chocolateyverified · 92%

choco install mpv

Chocolatey community package catalog · mpv · source: community.chocolatey.org

Scoopverified · 92%

scoop install extras/mpv

Scoop official bucket manifest trees · bucket/mpv.json · source: api.github.com

Windows Package Managerverified · 92%

winget install --id shinchiro.mpv -e

Windows Package Manager source index · shinchiro.mpv · source: cdn.winget.microsoft.com

overview

Package summary

Media player based on MPlayer and mplayer2

Project links

Commands and aliases

mpv

history

Project history and usage

mpv is a free command-line media player descended from MPlayer and mplayer2. The mpv FAQ says the relationship with MPlayer is mostly historic: mplayer2 forked away from MPlayer, and in 2012 a group of newer mplayer2 developers forked mplayer2 again, later naming the second fork mpv. The reason given by the project was disagreement over direction: MPlayer emphasized maintenance and old compatibility, while mpv prioritized modernization, code removal, rewrites, bug reduction, and replacing MPlayer-specific mechanisms with FFmpeg mechanisms.

Project history

The result became a player with a small default interface but a large technical surface. The README describes support for many media formats, audio and video codecs, and subtitle types. The stable manual documents keyboard-driven playback, GPU video output, configuration files, profiles, input commands, IPC, embedding through libmpv, and extension points through Lua, JavaScript, and C plugins. Lua scripting is a major part of the ecosystem: the Lua manual says scripts can call into the mpv core, retrieve playback state and user settings, and use the client API internally.

How it is used

A major milestone was the LGPL relicensing effort opened in 2015, motivated by turning the player core into libmpv and reducing GPL friction for applications that embed video playback in-process. That discussion also documents how much obsolete MPlayer-era code mpv had already removed, including mencoder, the old GUI, old kernel drivers, decoder wrappers, win32 codec loading, ancient video outputs, filters, and build-system pieces. In package-manager terms, mpv occupies the power-user media-player slot: a scriptable CLI player used directly from terminals, file managers, frontends, media-center tools, and other applications through libmpv.

Sources

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

broad file, network, media, or database tool signal

Signals

text:media

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Installs with 16 runtime dependencies.
Build metadata lists 4 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ~/.config/mpv/mpv.conf~/.mpv/config/etc/mpv/mpv.conf

executables

Installed executables

Command	Kind	Exposure	Note
`mpv`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-07

manager version0.41.0

manager updated2026-06-22

local dataok

upstreamcurrent

latest detectedv0.41.0

https://github.com/mpv-player/mpv

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:mpv
Version	0.41.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/mpv
Homepage	https://mpv.io
Repository	https://github.com/mpv-player/mpv
Upstream docs	https://mpv.io/manual/stable
License	GPL-2.0-or-later AND LGPL-2.1-or-later
Source archive	https://github.com/mpv-player/mpv/archive/refs/tags/v0.41.0.tar.gz
Last updated	2026-06-22T14:05:33-07:00
Pulse	updated
Dependencies	ffmpeg, jpeg-turbo, libarchive, libass, libbluray, libplacebo, little-cms2, luajit, molten-vk, mujs, rubberband, uchardet, vapoursynth, vulkan-loader, yt-dlp, zimg
Build dependencies	docutils, meson, ninja, pkgconf
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared
Caveats	The global configuration directory is now $HOMEBREW_PREFIX/etc/mpv/ You may need to migrate any data in previous $HOMEBREW_PREFIX/etc/mpv/mpv/

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	mpv
Version Scheme	0
Revision	6
Head Version	HEAD
Requirements	xcode
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

libmpv-dev 0.40.0-3+deb13u1

video player based on MPlayer/mplayer2 (client library dev files)

Install mpv with Homebrew, apk, chocolatey, apt, dnf, MacPorts, Nix, pacman, scoop, winget, zypper