MPV 配置备忘录

文档

更新

不要使用覆盖旧版本文件的形式进行更新！
不要与 git clone 合并，会产生配置冲突！
（如有必要，事先备份配置 + 重装 mpv + choco pin）
releases 页面下载 noBin，解压
code 界面下载对应 tag 的源码，挑出 portable_config/shaders（即原先的 hook 着色器）合并
- vsLite 通用 vs 滤镜已不再单独提供，将来可能改成 vsAMD
- portable_config 目录与备份配置对比，先 commit 一份版本更新，完成修改同步到 %APPDATA%\mpv，测试运行正常再 commit 一份细微改动，最后 tag
- 其余文件放到 C:\ProgramData\chocolatey\lib\mpvio.install\tools
- 安装：运行 C:\ProgramData\chocolatey\lib\mpvio.install\tools\installer\mpv-install.bat
- mpv.conf 修改内容参考

# mpv.conf

 ########
 # 功能 #
 ########
 idle = no
 watch-later-options = aid,vid,sid
 keepaspect-window = yes
 icc-cache = yes
 gpu-shader-cache = yes

 ########
 # 音频 #
 ########
 volume = 80

 ########
 # 视频 #
 ########
 icc-profile-auto = yes
 tscale = oversample
 sigmoid-upscaling = yes
 correct-downscaling = yes

 ####################
 # 脚本 滤镜 着色器 #
 ####################
 vf-append = vapoursynth="~~/vs/MEMC_MVT_LQ.vpy"
#glsl-shaders         = "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Restore_CNN_M.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_S.glsl"
 glsl-shaders-append  = "~~/shaders/KrigBilateral.glsl"
#glsl-shaders-append = "~~/shaders/AMD_FSR_EASU_rgb.glsl"

 ########
 # 字幕 #
 ########
 sub-color = "#FFFFFF"
#sub-color = "#FFD766"

 ########
 # 截图 #
 ########
 screenshot-format = webp
 screenshot-webp-compression = 3
 screenshot-tag-colorspace = yes
 screenshot-high-bit-depth = yes

配置

使用 profile 实现自动切换配置，满足不同格式匹配不同解码模式的需求，示例（profiles.conf 中补充）：

[native_hwdec_auto]
 profile-desc = 超过2k宽度的片源自动dx纯硬解
 profile-cond = width>=2000
 profile-restore = copy
 hwdec = d3d11va

Linux

超分 & 补帧复习：

mpv Resampling
~~使用 svp 补帧相关 #114~~ 效率不如 mvtools
RIFE 实时补帧 #123，ECCV2022-RIFE，4080 以下都图一乐
使用自定义的超分辨率 AI 模型 #329
- 实时超分还是遥不可及
- RTX 4080, 1080p ×2
- RTX 3060, 720p ×2 性能及格线
vpy 的设计与优化思路 #313
居然还有 VSDB……
windows10+ 快速部署一体化便携式 mpv-vs 工具链

大差不差，只需要修改一小部分内容（同时牺牲了 VS 倍帧脚本，不过换到高刷屏之后再想倍帧到刷新率是不可能了）：

 vo=gpu-next
#gpu-context = winvk
#hwdec = auto-copy
#ao=wasapi
 ao=alsa # 默认的 pipewire 没有声音，uosc 控制台显示 muted
#vf-append = vapoursynth="~~/vs/MEMC_MVT_LQ.vpy" # VapourSynth 搞不定
#screenshot-jxl-distance = 0 # 提示缺失 jxl 相关的处理库，懒得查

虽然 Void 提供 VapourSynth 软件包，但 mpv 始终提示 vs 不存在，不确定是不是得和 Windows 一样手动下 embedded Python 到 portable_config，K7sfunc 也没整明白，就先凑合用吧。

下面的问题已解决，安装 colord/xiccd 并导入色彩配置即可：

#icc-cache = no # Linux 不带调色方案，icc 档案由 Windows 的显示器驱动提供
#icc-profile-auto = yes

旧版

下面为旧版历史内容，基本不具备参考价值，仅用作归档。

文档

MPV 使用引导（旧版历史内容，下同）

配置文件

因为 mpv 本身不具有图形化前端，绝大多数的设置选项都是靠在主设置文件 mpv.conf 中输入参数实现的。

配置存放目录

这两种设置目录的选择各有特点：

以 %APPDATA%/mpv/ 为设置目录，相当于这是“全局设置目录”，不管你使用电脑里存放的多少个不同版本的 mpv，都会自动读取这个设置目录
以 X:/xxxxx/MPV 文件夹/portable_config/ 为设置目录，除去其具有最高优先级（会让其忽略“全局设置”）的特性，还赋予了软件绿色化的特性（查看【进阶】章可知大部分文件都可放在设置目录），非常适合便携党。

配置书写规范

主设置文件的书写规范最为宽松：

你可以在参数后直接注释中文解释 hwdec=d3d11va # 使用 d3d11va 硬解（原生模式）
也可以加大量空格美化参数的排版 hwdec = d3d11va # 使用 d3d11va 硬解（原生模式）
还可以用 --hwdec=d3d11va 这种（不合规的）替代写法表示激活的参数
甚至其中 no-osd-bar 这类 no- 开头的参数可改成为 osd-bar=no
以及官方手册中没有赋值的参数比如 deband 可以写成 deband=yes（等效）

进阶使用

脚本增强
- 3.1.3 条件配置
- 3.1.4 YTDL 集成（在环境变量 PATH 中即可）
- 3.2 外置脚本
第三方着色器
VapourSynth （下载 64 位便携包）
- VapourSynth 滤镜脚本
  - MPV 公开脚本
  - KCCat 脚本
  - 懒人包自带脚本
- mvtools 插件库
- mvtools 对应的 vpy 脚本

文件存放

C:\ProgramData\chocolatey\lib\mpv.install\tools:

python embeddable package
VapourSyhth
Run vs-detect-python.bat to configure it for the current Python version
PS: 官方的 VapourSyhth 版本需要使用匹配的 Python 版本才能正常工作，例如 R53-R57 对应 3.8.x 或 3.9.x（R64 可用 3.11.x）

C:\ProgramData\chocolatey\lib\mpv.install\tools\vapoursynth64\plugins:

libmvtools.dll

文档

更新

配置