# 使用 Homebrew, apk, chocolatey, apt, dnf, MacPorts, Nix, pacman, zypper, scoop, winget 安装 mpv

查看 mpv 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:mpv
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install mpv
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install mpv
```

  证据: 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
```

  证据: 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 mpv
```

  证据: Debian stable package indexes: mpv from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install mpv
```

  证据: Fedora Rawhide package metadata: mpv from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#mpv
```

  证据: 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
```

  证据: 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 mpv
```

  证据: openSUSE Tumbleweed package metadata: mpv from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Chocolatey (92%):

```sh
choco install mpv
```

  证据: Chocolatey community package catalog: mpv from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','mono'

- Scoop (92%):

```sh
scoop install extras/mpv
```

  证据: 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
```

  证据: Windows Package Manager source index: shinchiro.mpv from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:mpv
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/mpv>
- **版本:** 0.41.0
- **来源摘要:** Media player based on MPlayer and mplayer2
- **主页:** <https://mpv.io>
- **仓库:** <https://github.com/mpv-player/mpv>
- **上游文档:** <https://mpv.io>
- **许可证:** GPL-2.0-or-later AND LGPL-2.1-or-later
- **源码归档:** <https://github.com/mpv-player/mpv/archive/refs/tags/v0.41.0.tar.gz>
- **最后更新:** 2026-07-29T11:48:29Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- mpv (cli)
- mpv (别名)

## 依赖

- ffmpeg
- jpeg-turbo
- libarchive
- libass
- libbluray
- libplacebo
- little-cms2
- luajit
- molten-vk
- mujs
- rubberband
- uchardet
- vapoursynth
- vulkan-loader
- yt-dlp
- zimg

## 构建依赖

- docutils
- meson
- ninja
- pkgconf

## 安装行为

- post-install 钩子: 未定义
- 注意事项: 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: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 0.41.0
- 管理器更新时间: 2026-07-29
- 本地数据: OK
- 上游仓库: https://github.com/mpv-player/mpv
- 检测到的最新版本: v0.41.0 (当前)
## 项目历史与用法

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.

### 项目历史

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.

### 使用方式

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.

### 来源

- <https://github.com/mpv-player/mpv>
- <https://github.com/mpv-player/mpv/blob/master/DOCS/client-api-changes.rst>
- <https://github.com/mpv-player/mpv/blob/master/DOCS/man/lua.rst>
- <https://github.com/mpv-player/mpv/wiki/FAQ>
- <https://mpv.io/manual/stable/>


## 安全说明

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

- **Geiger 风险:** blue / 中
- 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:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mpv
- **Version Scheme:** 0
- **Revision:** 7
- **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

## 其他软件包管理器记录

- 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-r5: 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-r5: 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-r5: 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-r5: 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-r5: 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-r5: 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-r5: 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-lua-scripts - 0.41.0-r5: normalized package name match | Alpine Linux edge package indexes: mpv-lua-scripts from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Video player based on MPlayer/mplayer2 (lua scripts) | https://mpv.io/
- apk - mpv-zsh-completion - 0.41.0-r5: 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/


## 相关链接

- [Secret-risk packages](https://pkg.so/zh-hans/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://pkg.so/zh-hans/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [ffmpeg](https://pkg.so/zh-hans/brew/ffmpeg/) - Runtime dependency declared by Homebrew.
- [jpeg-turbo](https://pkg.so/zh-hans/brew/jpeg-turbo/) - Runtime dependency declared by Homebrew.
- [little-cms2](https://pkg.so/zh-hans/brew/little-cms2/) - Runtime dependency declared by Homebrew.
- [yt-dlp](https://pkg.so/zh-hans/brew/yt-dlp/) - Runtime dependency declared by Homebrew.
- [libarchive](https://pkg.so/zh-hans/brew/libarchive/) - Runtime dependency declared by Homebrew.
- [luajit](https://pkg.so/zh-hans/brew/luajit/) - Runtime dependency declared by Homebrew.
- [libbluray](https://pkg.so/zh-hans/brew/libbluray/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://pkg.so/zh-hans/brew/pkgconf/) - Build dependency declared by Homebrew.
- [ninja](https://pkg.so/zh-hans/brew/ninja/) - Build dependency declared by Homebrew.
- [meson](https://pkg.so/zh-hans/brew/meson/) - Build dependency declared by Homebrew.
- [docutils](https://pkg.so/zh-hans/brew/docutils/) - Build dependency declared by Homebrew.
- [dzr](https://pkg.so/zh-hans/brew/dzr/) - Popular package that depends on this formula.
- [mplayer](https://pkg.so/zh-hans/brew/mplayer/) - Shares pkgdb curated category or tags: audio, cli, media, media-player, subtitles.
- [gstreamer](https://pkg.so/zh-hans/brew/gstreamer/) - Shares pkgdb curated category or tags: audio, cli, media, video.
- [ffmpeg-full](https://pkg.so/zh-hans/brew/ffmpeg-full/) - Shares pkgdb curated category or tags: audio, cli, media, video.
- [pipewire](https://pkg.so/zh-hans/brew/pipewire/) - Shares pkgdb curated category or tags: audio, cli, media, video.
- [media-info](https://pkg.so/zh-hans/brew/media-info/) - Shares pkgdb curated category or tags: audio, cli, media, video.
- [streamlink](https://pkg.so/zh-hans/brew/streamlink/) - Shares pkgdb curated category or tags: cli, media, media-player, video.
- [geeqie](https://pkg.so/zh-hans/brew/geeqie/) - Local package facts share a topical domain. Shared terms: based, cli, cms2, jpeg, jpeg-turbo.
- [handbrake](https://pkg.so/zh-hans/brew/handbrake/) - Both packages work with overlapping file formats or content types. Shared terms: cli, jpeg, jpeg-turbo, libass, libbluray.

## Combined YAML source

View the package source record on GitHub. [combined/mpv.yml](https://github.com/mxcl/pkgdb/blob/main/combined/mpv.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
