mpv
mpv 0.41.0 是跨平台命令行媒体播放器与可嵌入播放引擎，支持广泛音视频和字幕格式、GPU 着色器渲染、脚本、配置文件及 libmpv API。
适合做什么
mpv 适合需要高质量 GPU 渲染、广泛格式支持、命令行自动化或 libmpv 嵌入能力的用户。它不是传统媒体库应用，配置和脚本自由度高，也意味着用户需要理解参数、构建差异和扩展权限。
0.41.0 渲染变化
0.41.0 于 2025-12-21 发布，gpu-next 取代 gpu 成为默认输出，并在启用硬件解码时优先 Vulkan。本版还改进 Wayland 色彩管理、字幕与 HDR 选项；旧 LUT、ICC 或着色器配置升级后应重新校准。
构建、脚本与 IPC 边界
官方 CI 资产不包含全部可选功能，Linux 发行版也可能采用不同编译选项。Lua/JavaScript 脚本、yt-dlp、IPC 和第三方 libmpv 前端会引入执行与网络权限，只配置可信且必要的部分。
维护记录
本页依据 mpv 0.41.0 官方发布资产、gpu-next 与 Vulkan 变化、系统要求、硬件解码默认状态、脚本和 IPC 机制及双许可说明复核，检查日期为 2026-08-06。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
mpv 0.41.0 安装、gpu-next 与配置教程
先以默认配置播放本地 SDR 视频，确认音视频与字幕正常，再逐项启用硬件解码、HDR、脚本和网络播放；配置文件每次只改一项并保留注释。
安装前准备
- 核对 Windows、macOS 架构或 Linux 软件包来源；官方 0.41.0 CI 构建是可用资产，但不包含 mpv 支持的全部可选功能。
- 更新显卡驱动，准备普通 SDR、HDR 和字幕样本，并记录当前显示器与音频设备能力。
- 备份现有 mpv.conf、input.conf 与 scripts 目录，避免旧脚本影响新版本基线。
安装步骤
- 01
解压或安装 0.41.0
Windows、macOS 使用匹配架构资产，Linux 优先发行版软件包；从终端运行版本命令，核对编译选项与 0.41.0。
- 02
用默认配置播放本地样本
暂时移走用户配置和脚本，播放普通视频并测试字幕、音轨、截图和屏幕控制器，确认核心功能正常。
- 03
建立最小配置文件
先设置窗口、字幕和音量等低风险选项，再单独启用硬件解码；不直接复制无法理解的整套网络配置。
快速上手
- 01
验证 gpu-next 色彩
0.41.0 默认从 gpu 切换到 gpu-next，分别测试 SDR 与 HDR，出现色偏时先清除 LUT、ICC 和着色器，再核对输出色彩空间。
- 02
测试硬件解码
显式启用硬件解码并观察日志、CPU/GPU 与掉帧；黑屏或崩溃时恢复软件解码，再检查驱动和所选 API。
- 03
隔离脚本与网络播放
脚本逐个安装并审阅权限，yt-dlp 只处理有权访问的网络媒体；IPC 使用仅当前用户可访问的位置，用后关闭。
使用建议
- 0.41.0 于 2025-12-21 发布，gpu-next 成为默认视频输出，并在可用时优先 Vulkan 硬件解码。
- 本版需要 FFmpeg 6.1 及以上与较新的 libplacebo；不同发行版或第三方构建的功能集合可能不同。
- 官方 CI 资产没有包含所有可选功能，例如编码能力，不能仅凭“mpv 支持”推断当前二进制已启用。
- 配置、脚本、协议处理和 libmpv 前端都能改变安全边界，问题排查应先回到无脚本默认配置。
故障排查与卸载方法
更新后 HDR 色偏、Wayland 显示异常或视频不出画面怎么办？
清除自定义着色器、LUT 和色彩参数，恢复软件解码及默认 gpu-next；核对 ICC、驱动、Wayland 色彩协议和显示器模式后逐项恢复。
网络链接不能播放或 yt-dlp 报错怎么办？
先确认本地文件可播，再更新可信的 yt-dlp 并查看站点是否要求登录、受 DRM 或改变接口。不要粘贴来源不明的 Cookie、脚本或绕过命令。
- 备份必要配置和脚本清单保存理解且需要的 mpv.conf、input.conf 与脚本列表，删除其中的令牌、Cookie、网络凭据和 IPC 路径。
- 删除程序并清理可选数据按安装方式卸载或删除程序目录；确认不再使用时再移除用户配置、缓存和脚本，媒体文件不会随播放器卸载而删除。
常见问题
mpv 为什么安装后没有传统播放器界面？
mpv 以命令行和简洁屏幕控制器为主，主要设置来自参数与配置文件。需要完整媒体库、海报墙或大量对话框设置时，可选择基于 libmpv 的其他前端，但第三方前端版本和安全性需单独核对。
硬件解码默认会自动开启吗？
官方 README 明确说明硬件解码默认不启用，需要显式配置。0.41.0 在启用时更偏好 Vulkan 和非复制路径，但实际可用性仍取决于 GPU、驱动、视频编码与构建选项。
mpv 脚本和 IPC 是否有权限风险？
有。Lua/JavaScript 脚本可调用播放器命令、读取文件或访问网络，IPC 控制端可操作正在运行的播放器。只使用可信脚本，限制套接字权限，不把 IPC 暴露到不可信用户或网络。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。