# Install mpv with Homebrew, apk, chocolatey, apt, dnf, MacPorts, Nix, pacman, scoop, winget, zypper Media player based on MPlayer and mplayer2. Version 0.41.0 via Homebrew; verified 2026-06-22. ## Install ```sh sudo av install brew:mpv ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install mpv ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install mpv ``` Evidence: MacPorts ports tree: multimedia/mpv/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add mpv ``` Evidence: Alpine Linux edge package indexes: mpv from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install libmpv-dev ``` Evidence: Debian stable package indexes: libmpv-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install mpv ``` Evidence: Fedora Rawhide package metadata: mpv from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#mpv ``` Evidence: nixpkgs package indexes: pkgs/by-name/mp/mpv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S mpv ``` Evidence: Arch Linux sync databases: mpv from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install libmpv2 ``` Evidence: openSUSE Tumbleweed package metadata: libmpv2 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Chocolatey (92%): ```sh choco install mpv ``` Evidence: Chocolatey community package catalog: mpv from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','mirc' - Scoop (92%): ```sh scoop install extras/mpv ``` Evidence: Scoop official bucket manifest trees: bucket/mpv.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id shinchiro.mpv -e ``` Evidence: Windows Package Manager source index: shinchiro.mpv from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:mpv - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.41.0 - **Source summary:** Media player based on MPlayer and mplayer2 - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-2.0-or-later AND LGPL-2.1-or-later - **Source archive:** - **Last updated:** 2026-06-22T14:05:33-07:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - mpv (cli) - mpv (alias) ## 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 ## Install behavior - Post-install hook: not defined - 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/ - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.41.0 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/mpv-player/mpv - Upstream latest detected: v0.41.0 (current) ## 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 Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## 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 - Unix: ~/.config/mpv/mpv.conf, ~/.mpv/config, /etc/mpv/mpv.conf ## 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:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - libmpv-dev - 0.40.0-3+deb13u1: normalized package name match | Debian stable package indexes: libmpv-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | video player based on MPlayer/mplayer2 (client library dev files) | https://mpv.io/ - Debian apt - libmpv2 - 0.40.0-3+deb13u1: normalized package name match | Debian stable package indexes: libmpv2 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | video player based on MPlayer/mplayer2 (client library) | https://mpv.io/ - Debian apt - mpv - 0.40.0-3+deb13u1: normalized package name match | Debian stable package indexes: mpv from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | video player based on MPlayer/mplayer2 | https://mpv.io/ - Nix - mpv: normalized package name match | nixpkgs package indexes: pkgs/by-name/mp/mpv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - libmpv-dev - 0.37.0-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: libmpv-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | video player based on MPlayer/mplayer2 (client library dev files) | https://mpv.io/ - Ubuntu apt - libmpv2 - 0.37.0-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: libmpv2 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | video player based on MPlayer/mplayer2 (client library) | https://mpv.io/ - Ubuntu apt - mpv - 0.37.0-1ubuntu4: normalized package name match | Ubuntu 24.04 LTS package indexes: mpv from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | video player based on MPlayer/mplayer2 | https://mpv.io/ - apk - mpv - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Video player based on MPlayer/mplayer2 | https://mpv.io/ - apk - mpv-bash-completion - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for mpv | https://mpv.io/ - apk - mpv-dbg - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv-dbg from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Video player based on MPlayer/mplayer2 (debug symbols) | https://mpv.io/ - apk - mpv-dev - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv-dev from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Video player based on MPlayer/mplayer2 (development files) | https://mpv.io/ - apk - mpv-doc - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Video player based on MPlayer/mplayer2 (documentation) | https://mpv.io/ - apk - mpv-fish-completion - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for mpv | https://mpv.io/ - apk - mpv-libs - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv-libs from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Video player based on MPlayer/mplayer2 (libraries) | https://mpv.io/ - apk - mpv-zsh-completion - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: mpv-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for mpv | https://mpv.io/ - apk - umpv - 0.41.0-r2: normalized package name match | Alpine Linux edge package indexes: umpv from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Video player based on MPlayer/mplayer2 - script to add new videos to existing playlist instead of starting a new instance | https://mpv.io/ ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Runtime dependency declared by Homebrew. - [jpeg-turbo](https://www.automicvault.com/pkg/brew/jpeg-turbo/) - Runtime dependency declared by Homebrew. - [libarchive](https://www.automicvault.com/pkg/brew/libarchive/) - Runtime dependency declared by Homebrew. - [libbluray](https://www.automicvault.com/pkg/brew/libbluray/) - Runtime dependency declared by Homebrew. - [little-cms2](https://www.automicvault.com/pkg/brew/little-cms2/) - Runtime dependency declared by Homebrew. - [luajit](https://www.automicvault.com/pkg/brew/luajit/) - Runtime dependency declared by Homebrew. - [docutils](https://www.automicvault.com/pkg/brew/docutils/) - Build dependency declared by Homebrew. - [meson](https://www.automicvault.com/pkg/brew/meson/) - Build dependency declared by Homebrew. - [ninja](https://www.automicvault.com/pkg/brew/ninja/) - Build dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [dzr](https://www.automicvault.com/pkg/brew/dzr/) - Popular package that depends on this formula. - [alass](https://www.automicvault.com/pkg/brew/alass/) - Shares av.db curated category or tags: cli, media, subtitles, video. - [ccextractor](https://www.automicvault.com/pkg/brew/ccextractor/) - Shares av.db curated category or tags: cli, media, subtitles, video. - [ffmpeg-full](https://www.automicvault.com/pkg/brew/ffmpeg-full/) - Shares av.db curated category or tags: audio, cli, media, video. - [gstreamer](https://www.automicvault.com/pkg/brew/gstreamer/) - Shares av.db curated category or tags: audio, cli, media, video. - [media-info](https://www.automicvault.com/pkg/brew/media-info/) - Shares av.db curated category or tags: audio, cli, media, video. - [mlt](https://www.automicvault.com/pkg/brew/mlt/) - Shares av.db curated category or tags: audio, cli, media, video. - [mpegdemux](https://www.automicvault.com/pkg/brew/mpegdemux/) - Shares av.db curated category or tags: audio, cli, media, video. - [geeqie](https://www.automicvault.com/pkg/brew/geeqie/) - Local package facts share a topical domain. Shared terms: based, cli, cms2, jpeg, jpeg-turbo. - [handbrake](https://www.automicvault.com/pkg/brew/handbrake/) - Both packages work with overlapping file formats or content types. Shared terms: cli, jpeg, jpeg-turbo, libass, libbluray. - [ghostscript](https://www.automicvault.com/pkg/brew/ghostscript/) - Local package facts share a topical domain. Shared terms: cli, cms2, jpeg, jpeg-turbo, libarchive. ## Combined YAML source View the package source record on GitHub. [combined/mpv.yml](https://github.com/automic-vault/db/blob/main/combined/mpv.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph