↓ 跳过正文

MPV 播放器使用方法教程指南

·6 分钟

开始
#

MPV 现代的开源多媒体播放器,且可便携化

# 目录结构
path/to/MPV
 ├─updater.bat # 升级版本
 ├─installer
 │   └─mpv-install.bat # 设为默认播放器
 └─portable_config # 便携版的路径
    ├─mpv.conf # 主配置文件
    ├─input.conf # 自定义快捷键
    ├─scripts # 脚本目录 .lua
    ├─script-opts # 脚本配置目录 .conf
    ├─fonts # 字体目录
    └─shaders # 着色器目录
    
# 安装版配置目录路径
C:/Users/用户名/AppData/Roaming/mpv/ # Windows
~/.config/mpv/ # Linux

播放视频只需将文件拖动到窗口中添加到播放列表,也可以命令行跳转到目录后执行 mpv . 也支持多个图片拖入后以1秒显示一张的方式进行幻灯片播放

配置
#

mpv.conf 主配置文件,官方手册

## 说明:注释中,<默认值|可选项>,默认值无需配置只是为说明其作用,大部分的默认是 auto 自动判断

## 视频输出
# vo=gpu-next # 视频输出驱动,<gpu-next|gpu>
hwdec=auto # 解码方式,<auto|no(软解)|yes(硬解)>,播放时可用 Ctrl+H 切换
profile=high-quality # 启用内置的高质量预设 <默认平衡|high-quality>

# 开启插帧,平滑播放
# interpolation=yes # 运动插值(平滑运动)

# 高质量反光晕/抗锯齿
# sigmoid-upscaling=yes # 启用 Sigmoid 曲线,减少高对比度边缘的光晕
# linear-upscaling=yes # 启用线性光照,改善缩放画质

# 画质增强
# deband=yes # 去色带
# scale=ewa_lanczossharp # 高质量亮度,上面 high-quality 已包含
cscale=ewa_lanczossharp # 高质量色度

## HDR
# target-trc=pq # 指定色彩空间(PQ 为 HDR10 标准,HLG 为广播)
# target-peak=auto # 显示器峰值亮度
# target-prim=bt.2020 # 色域,通常为 HDR
# target-colorspace=hdr # 强制 HDR(需先开启系统 HDR 开关)

# image-subs-hdr-peak=10000 # HDR 下的图像字幕亮度
# blend-subtitles=no # 字幕以其原始颜色和亮度独立渲染

## HDR 映射 SDR
# tone-mapping=auto # 默认值
# hdr-compute-lut=yes # 启用 HDR 查表(LUT)计算,这是高质量色调映射的基础
# hdr-compute-peak=yes # 启用计算机而不是视频文件自带 HDR 元数据
# vf=format=colorlevels=full # 输出色彩范围设为全范围,保留更多色彩信息,减少色阶损失

# target-contrast=1000
# target-prim=dci-p3
# allow-delayed-peak-detect=no # 默认 yes ,禁止延迟检测峰值亮度(高质量渲染)

## 音频输出
volume-max=200 # 最大音量
ao=wasapi # Windows 音频API

## 播放
title=${?pause==yes:⏸ }${?mute==yes:🔇}${?ontop==yes:📌 }${?demuxer-via-network==yes:${media-title}}${?demuxer-via-network==no:${filename}} # 自定义窗口标题
geometry=60% # 启动时相对显示器窗口大小
snap-window=yes # 屏幕边缘吸附
keep-open=yes # 播放结束后不退出
volume=0 # 启动后的默认音量
# ontop=yes # 始终置顶
border=no # 无边框
save-position-on-quit=yes # 记忆上次播放位置
autocreate-playlist=same # 自动加载同目录中的视频到播放列表
directory-mode=ignore # 忽略子目录被加载到播放列表
directory-filter-types=video # 指定仅播放的文件类型
# priority=high # 如果需要高优先级

## 屏显
osc=no # 是否使用原生屏控,使用第三方需设为 no
osd-bar=no # 是否禁用原生播放进度条,使用第三方需设为 no
osd-playing-msg="${filename}" # 开始播放时短暂显示文件名
# osd-font-size=25 # 文本大小
# osd-color="#FFF500" # 文本颜色

## 字幕
sub-auto=fuzzy # 自动加载同名外置字幕
slang=chs,cht,zh,eng,en,english,jp,ja # 字幕语言优先级
alang=eng,en,ja,jp,zh,chi # 音频语言载入优先级
# sub-margin-y=20 # 距离底部的像素数

## 字幕样式
sub-font=Source Han Sans CN # 字体
sub-font-size=65 # 尺寸 40,默认 55
# sub-bold=yes # 粗体
sub-color="#FFE5A0" # 颜色,ass 为 &H00A0E5FF
sub-border-size=3 # 边框,默认 3
# sub-ass-override=force # 强制 ass 字幕为自定义样式
# sub-shadow-offset=5 # 阴影距离
# sub-shadow-color="#000000" # 阴影颜色

## 截图
screenshot-dir=T:/Downloads # 截图保存路径
screenshot-format=jpg # 截屏图片格式

## 缓存与日志
# cache=yes # 开启缓存,默认 auto 只对网络流缓存,开启则对本地也缓存
# cache-on-disk=no # 用内存缓存而不用硬盘
# cache-secs=20 # 缓存时间
# demuxer-cache-dir="T:/cache/mpv" # 指定缓存路径,需先创建好目录
gpu-shader-cache-dir="T:/cache/mpv" # 已编译的GLSL着色器缓存
watch-later-dir="T:/cache/mpv/watch_later" # 保存稍后观看的记录
# log-file="T:/cache/mpv/mpv.log" # 日志记录,不调试时注释掉

判断是否为默认值

mpv --list-options | findstr osc # osc 设置项
# 输出末尾的 (default: ...) 即为当前版本的默认值

快捷键
#

快捷键功能
F8显示播放列表,或鼠标右击播放控制栏左右三角箭头
F9显示视频/音频/字幕轨道信息(按住持久显示)
q退出,按 Shfit + q 保存进度并退出
i显示视频信息(按住或加 Shift 保持显示,1 和 2 键翻页)
o显示播放进度
播放控制
Space 或 鼠标右击播放/暂停
← →倒退/快进
,(逗号).(句号)逐帧倒退/快进
[   ]减速/加速播放(Backspace 还原)
Shift+,(逗号).(句号)上一集/下一集跳转(可指定 PgUp PgDn )
9 0增减音量(可指定 ↑ ↓ )
m静音
# (Shift + 3)切换音轨
窗口控制
f 或 鼠左双击切换全屏
t置顶窗口
Alt+0 1 2窗口缩放,缩小一半 / 原尺寸 / 两倍
w e画面平铺范围
Ctrl+鼠标滚轮缩放窗口
s截图(Shift + S 无字幕)
字幕控制
j切换字幕
v显隐字幕
x z增减字幕延迟 0.1 秒
r R上下移动字幕位置
Ctrl + ↑ ↓字幕大小(需自定义)

input.conf 自定义快捷键,参考

## 键盘
ENTER cycle fullscreen # 全屏切换
# n set window-minimized yes # 最小化
UP add volume 5 # 键盘上键增加音量
DOWN add volume -5 # 键盘下键减少音量
HOME seek 0 absolute # 跳转到开始从头播放
RIGHT seek 2 exact # 快进2秒,精确的
LEFT seek -2 exact # 后退2秒,精确的
Ctrl+RIGHT seek 20 # 快进20秒
Ctrl+LEFT seek -20 # 后退20秒
PGUP playlist-prev # 播放列表上一个
PGDWN playlist-next # 播放列表下一个
Ctrl+ALT+= add video-zoom 0.1 # 放大视频
Ctrl+ALT+- add video-zoom -0.1 # 缩小视频
Ctrl+ALT+0 set video-zoom 0 ; set video-pan-x 0 ; set video-pan-y 0 ; set panscan 0 # 重设视频缩放与裁剪
Ctrl+Shift+f run explorer.exe "/select,${path}" # 打开文件所在目录
Ctrl+UP add sub-scale +0.05 # 字幕放大5%
Ctrl+DOWN add sub-scale -0.05 # 字幕缩小5%
Ctrl+z set sub-delay 0 # 字幕延时复位
Ctrl+F7 sub-reload # 重载字幕
F2 cycle-values sub-ass-override force no

## UOSC 专用
MBTN_RIGHT_DBL script-binding uosc/menu # 右键菜单
F8 script-binding uosc/playlist # 播放列表
# WHEEL_UP no-osd add volume 5 ; script-binding uosc/flash-volume # 右侧音量条增加音量5
# WHEEL_DOWN no-osd add volume -5 ; script-binding uosc/flash-volume # 右侧音量条减少音量5

# 微调字幕速度 (每次增减 0.001)
Alt+[ add sub-speed -0.001
Alt+] add sub-speed +0.001
Alt+r set sub-speed 1.0 # 重置

## 鼠标
MBTN_LEFT cycle pause ; show-text "${?pause==yes:暂停}${!pause==yes:播放}" # 左键暂停/播放
MBTN_MID cycle mute # 鼠标点击滚轮静音
WHEEL_UP add volume 5 # 滚轮向上增加音量5
WHEEL_DOWN add volume -5 # 滚轮向下减少音量5
MBTN_FORWARD seek 2 # 侧键前进2秒
MBTN_BACK seek -2 # 侧键后退2秒

脚本
#

脚本能附加功能,浏览用户脚本库或自己编写并放置于对应目录

  • 脚本文件 .lua 放到 /scripts
  • 脚本配置文件 .conf 放到 /script-opts

常用脚本

recent:最近播放列表

display_bind= # 设定调出快捷键,例如数字1键左面的反点
log_path=T:/cache/history.log # 自定义历史文件记录位置

thumbfast:播放进度显示缩略图

最小化并自动暂停播放,编写 auto-pause.lua 脚本

mp.observe_property("window-minimized", "bool", function(name, value)
    if value then
        mp.set_property("pause", "yes")
    else
        mp.set_property("pause", "no")
    end
end)

清除播放历史记录,编写 clear-history.lua 脚本

local u = require 'mp.utils'
mp.add_key_binding("Ctrl+Shift+H", "clear-history", function()
    local p = "T:/cache/mpv/watch_later"
    for _, f in ipairs(u.readdir(p) or {}) do os.remove(u.join_path(p, f)) end
    mp.osd_message("播放历史已清除")
end)

Navigator:文件浏览器,f 在收藏目录间切换,↑↓ 上下选择,←→ 进入返回目录,可以修改 navigator.lua 文件进行配置

defaultpath = 默认路径 "T:/Videos"  
navigator_mainkey = 快捷键 Ctrl+o
favorites = 想收藏的目录
ignorePaths = 忽略路径
ignorePatterns = 忽略文件名
visible_item_count = 显示条目数
style_ass_tags = "{\\fs12}" 字体大小
name_prefix = "{\\c&FFFFFF&}□ " 条目颜色
selection_prefix = "{\\c&00BFFF&}■ " 选择条目颜色

Playlistmanager:操作播放列表

autosubsync-mpv:自动同步字幕,解决音频字幕不同步

mpv-copyTime:复制当前播放位置时间

解决Web版与蓝光版字幕同步问题,编写 sub-time-sync.lua 脚本

local mp = require 'mp'

local first_real = nil
local first_sub = nil

function mark_point()
    local pos = mp.get_property_number("time-pos")
    local sub_delay = mp.get_property_number("sub-delay") or 0
    local sub_pos = pos - sub_delay

    if not first_real then
        first_real = pos
        first_sub = sub_pos
        mp.osd_message(string.format("已标记【第一个时间点】: %.2fs", pos), 3)
    else
        local second_real = pos
        local second_sub = sub_pos

        local sub_speed = (second_real - first_real) / (second_sub - first_sub)
        local new_delay = first_real - (first_sub * sub_speed)

        mp.set_property_number("sub-speed", sub_speed)
        mp.set_property_number("sub-delay", new_delay)

        mp.osd_message(string.format("字幕校准完成!\n倍速: %.4f | 延迟: %.2fs", sub_speed, new_delay), 4)
        -- 重置标记状态,方便重新设置
        first_real = nil
        first_sub = nil
    end
end

function reset_sync()
    first_real = nil
    first_sub = nil
    mp.set_property_number("sub-speed", 1.0)
    mp.set_property_number("sub-delay", 0)
    mp.osd_message("字幕缩放与延迟已重置", 3)
end

mp.add_key_binding("n", "mark_sync_point", mark_point)
mp.add_key_binding("Ctrl+n", "reset_sync_point", reset_sync)

使用方法

  1. 播放视频,第一句台词出现时,用z/x调整并根据人物说话对齐台词,按n键标记开头
  2. 将视频拉到结尾处左右的最后一句台词,再用z/x调整对齐台词,再次按下n键标记结尾
  3. 如需重置,按 Ctrl+N

OSC
#

OSC(On-Screen Controller),图形化界面控制器,目前最受欢迎的是 uosc 让屏控支持鼠标,菜单支持 Ctrl + F 搜索

在 GitHub 分别下载并放到配置目录中对应目录

  • uosc.zip 将其 fonts 和 scripts 目录放到 portable_config 目录中
  • uosc.conf 放入 /script-opts/ 目录
  • 编辑 mpv.conf
## 添加如下避免冲突
osc=no # 不使用原生屏控
osd-bar=no # 不使用原生播放进度条
  • 编辑 script-opts/uosc.conf
languages=zh-hans # 设置语言
font_scale=1.3 # 字体大小
controls_size=45 # 进度条大小
destination_time=total # 进度条右侧显示总时间
menu_item_height=36 # 所有菜单条目高度
menu_min_width=300 # 所有菜单最小宽度
top_bar=always # 是否使用顶部控制栏,如果没有使用默认标题栏可打开
thumbnail=yes # 支持时间线缩略图,需要安装 thumbnail 脚本
  • 编辑 input.conf 配置快捷键
MBTN_RIGHT_DBL  script-binding uosc/menu # 右键双击显示主菜单
F8 script-binding uosc/playlist # 打开播放列表

# 滚轮时调节音量时显示右侧音量条
wheel_up    no-osd add volume  5; script-binding uosc/flash-volume
wheel_down  no-osd add volume -5; script-binding uosc/flash-volume
m           no-osd cycle mute; script-binding uosc/flash-volume

i 键信息说明
#

File: 文件名
  Size: 文件大小与格式
  Total Cache: 总缓存

Display: 播放器渲染方式,而非原文件质量 Context:GPU-API
  Refresh Rate: 刷新率(显示器自身)
  Dropped Frames: 是否丢帧
  Frame Timings: 帧时序
  Resolution: 分辨率和比例
  Format: 格式 rgb10a2(RGB10)Levels: full(全色彩)
  Colormatrix: rgb(色彩方式),bt.709(Primaries 初选),bt.1886(Transfer 转移)(能看出是否HDR)

Video: 视频自身编码(视频文件自身质量)HW:如有这个表示硬解
  Frame Rate:帧率
  Resolution: 分辨率和比例
  Format: 编码格式,级别与色度(翻译可能有误)
  Colormatrix: rgb(色彩方式),bt.709(Primaries),bt.1886(Transfer)(能看出是否HDR)
  Bitrate:码率

Audio: 播放器音频呈现方式
  Device: 设备选择和音量
  Channels:声道 Format: 格式
  Sample Rate: 采样率(质量)
  Bitrate: 码率

现成项目
#

如果觉得配置麻烦可以用基于 MPV 的现成项目

  • mpv.net:适合 Windows 带现代图形界面
  • ImPlay:跨平台配合 ImGui 构建 - Celluloid:适合 Linux,通过 libmpv API 访问 MPV 强大的播放功能

参考资料
#

mpv_PlayKit、mpv_fruit、mpv_config、HDR 配置

中文指南、FinnR的教程

极限玩家
作者
极限玩家
A little bit about you