Skip to content

2_portable_config

Karl Hook edited this page May 25, 2024 · 21 revisions

主设置文件夹(便携式)

点击段标题右侧的emoji可跳转到对应的文件夹

主设置目录 🔗

mpv-lazy/portable_config
这是win环境下使用mpv的最高优先级设置文件夹

当存在 portable_config 文件夹时, mpv.exe 不会读取 %AppData%/mpv 内的文件

Q 为什么不用 %AppData%/mpv (常规的设置文件夹)
A 我不喜欢

Q 如果使用 %AppData%/mpv 子目录结构有无变化
A 没有

文件名 说明
mpv.conf 主要设置文件(官方指定)
input.conf 主要快捷键绑定文件(官方指定)
input_uosc.conf 取代 input.conf (我的个人指定)
profiles.conf 追加设置文件(非必要、我的个人指定)
fonts.conf FONTCONFIG(非必要、官方指定)
script-opts.conf 管理脚本选项(非必要、我的个人指定)

追加关联文档:

快捷键管理

当前 mpv-lazy 版本不使用官方指定的快捷键绑定文件( input.conf )。此对象可由用户根据选项 --input-conf 自定义。
不使用原始设定的理由是:第三方脚本扩展了原始的 input 语法,使用额外的文件以示区分。

追加关联文档:

FONTCONFIG

--sub-font-provider=fontconfig
fontconfig在win的体验比较糟糕不如原生的DirectWrite,不推荐使用。
编辑修改内容 <dir>CUSTOMFONTDIR</dir> 此处的“自定义文件夹”替换为你的字体文件夹(例如: <dir>C:/player/fonts</dir>

使用主设置文件管理脚本选项

阅读 《集中化管理mpv的脚本选项》 了解详情


临时字体路径

mpv-lazy/portable_config/fonts
该文件夹下存放伴随mpv启动,临时装载到内存中的字体

此路径为默认的临时字体加载路径。你可以用 --osd-fonts-dir--sub-fonts-dir 指定到自定义目录。前者参数仅用于OSD,后者仅用于字幕。

开源字体指路:Google_Fonts & Github

如果你有海量字体,为了避免浪费内存,推荐使用 ——

  • 法一: SubtitleFontHelperFontLoaderSub 或字体管理类软件实现(半)自动按需加载字体。
  • 法二(简易): auto_sub_fonts_dir (简易) 或 auto_load_fonts 脚本临时加载字体目录(参见下方)

外置脚本路径 🔗

mpv-lazy/portable_config/scripts
该文件夹下存放伴随mpv自启动的脚本

脚本名 功能 说明 备注
contextmenu_gui(组) 图形化右键菜单 #60 部分功能重合 uosc
uosc(组) OSC界面 多功能版 #186 完全冲突 osc{内部脚本}
部分功能重合 input_plus ; load_plus ; playlist_osd ; contextmenu_gui
auto_load_fonts.js fontconfig #189
auto_sub_fonts_dir.lua 动态切换字幕字体目录 脚本内 功能重合 auto_load_fonts
input_plus.lua 快捷指令增强 脚本内 部分功能重合 uosc
load_plus.lua 自动补充播放列表
快捷载入文件/网址
高级次字幕
#106 部分功能重合 uosc
playlist_osd.lua 高级OSD播放列表 脚本内及设置文件 部分功能重合 uosc
save_global_props.lua 保存并恢复属性值 脚本内及设置文件
stats_plus.lua 统计数据增强 脚本内 完全冲突 stats{内部脚本}
thumbfast.lua 缩略图引擎(新版) 脚本内及设置文件

所有脚本均无预绑定的静态键位,查看 input.conf 的"LUA脚本"部分示例参考
playlist_osd.lua存在动态绑定键位,查看对应配置文件 playlist_osd.conf 的相关部分

除了以下特例,大部分脚本皆可独立使用:

  • thumbfast 必须依附其中一个 OSC界面 使用

脚本的设置文件路径 🔗

mpv-lazy/portable_config/script-opts
该文件夹下存放对应mpv脚本的脚本设置文件

如果“使用主设置文件管理脚本选项”,则该文件夹中脚本设置的同名选项会被前者覆盖!!!

通常脚本设置文件名与所属脚本文件同名,实际遵脚本开发者设定为准。
脚本设置文件切勿美化格式(例如加入无意义的空格);切勿在参数后注释(应单独另起一行写注释);
脚本及其设置文件可能不支持windows的CRLF换行(尝试更改为LF)。
以上所述情况在自行修改的过程中都可能导致脚本设置文件(部分)失效。

以下为mpv内置脚本所使用的设置文件:

console.conf
osc.conf
stats.conf
ytdl_hook.conf

为什么不在 mpv.conf 中用官方的mpv参数 --script-opts=key1=value1,key2=value2,...
不嫌烦和乱的话完全没有问题,只有在脚本所需更改的选项数量极少的情况下,我才会使用。
#options-script-opts

演示:《集中化管理mpv的脚本选项》


着色器路径 🔗

mpv-lazy/portable_config/shaders
该文件夹下存放第三方着色器
该目录并非官方指定,只是我的个人习惯,无需遵守。

个别着色器略作修改,与上游存在细微差异
详细的中文介绍:《mpv-lazy 第三方着色器》

追加关联文档:


VS脚本路径 🔗

mpv-lazy/portable_config/vs
该文件夹下存放Vapoursynth脚本
该目录并非官方指定,只是我的个人习惯,无需遵守。

打开脚本文件查看并编辑 “用户选项” 的参数以适配机器。

🔺K7sfunc 是下列脚本的基础依赖!!!
🔺查询k7f对应的相关模块文档以获取所需的 外部依赖

vpy示例脚本 应用场景 涉及的需外部依赖的k7f模块
ETC_DEINT_EX 最好的反交错/去隔行算法(效果好但开销大甚至超级大) DEINT_EX
ETC_IVTC_STD 修正错误的25/30帧为24FPS IVTC_STD
ETC_UAI_DML 使用自定义的AI放大模型 UAI_DML
ETC_UAI_NV_TRT 使用自定义的AI放大模型 UAI_NV_TRT
MEMC_MVT_LQ 运动补偿//补帧 MVT_LQ
MEMC_MVT_STD 运动补偿//补帧 MVT_STD
MEMC_RIFE_NV 运动补偿//补帧(效果好但开销较大) RIFE_NV
MEMC_RIFE_STD 运动补偿//补帧(效果好但开销较大) RIFE_STD
MEMC_SVP_LQ 运动补偿//补帧 SVP_LQ
MEMC_SVP_PRO 运动补偿//补帧 SVP_PRO
NR_BM3D_NV 位于最好的降噪算法梯队,复杂且高开销 BM3D_NV
NR_CCD_STD 降低彩噪 CCD_STD
SR_ESRGAN_DML 放大//降噪(开销极大) ESRGAN_DML
SR_ESRGAN_NV 放大//降噪(开销极大) ESRGAN_NV
SR_WAIFU_DML 放大//降噪(开销非常大) WAIFU_DML
SR_WAIFU_NV 放大//降噪(开销非常大) WAIFU_NV

关联文档:

追加关联文档:


调色与色彩特征文件路径 🔗

mpv-lazy/portable_config/luts
该文件夹下存放luts文件
该目录并非官方指定,只是我的个人习惯,无需遵守。

扩展名为cube结尾的是调色预设文件,icc/icm结尾的是色彩特性描述文件。

文件 说明
FGCine* (8) FILTERGRADE的免费电影感色调包
pinkgirl Krell-粉嫩少女-17

涉及的mpv选项:
--icc-profile=<file>

--lut=<file> --lut-type
--image-lut=<file> --image-lut-type
--target-lut=<file>
--vf=lut3d=file=<file>


缓存汇总目录 🔗

mpv-lazy/portable_config/_cache
该文件夹下汇总各类缓存文件
该目录并非官方指定,只是我的个人习惯,无需遵守。

涉及的mpv选项
--icc-cache-dir=<dirname>
--gpu-shader-cache-dir=<dirname>
--watch-later-dir=<path>

注意:如不设定 --watch-later-dir=<path> ,将默认使用官方指定路径 ~~/watch_later/

涉及的脚本
save_global_props.lua