Skip to content

2_portable_config

Jump to bottom
hooke007 edited this page Dec 6, 2025 · 36 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 脚本 uosc 的菜单语法示例文件，可取代 input.conf （我的个人指定）
input_contextmenu_plus.conf 脚本 contextmenu_plus 的菜单语法示例文件，可取代 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

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

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

外置脚本路径 🔗

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

脚本名 功能 说明 备注
uosc（组） OSC界面 多功能版 #186 完全冲突 osc{内部脚本}
部分功能重合 input_plus ; playlist_osd ; contextmenu_plus
auto_load_fonts.js fontconfig #189 功能重合 auto_sub_fonts_dir
auto_sub_fonts_dir.lua 动态切换字幕字体目录 脚本内 功能重合 auto_load_fonts
contextmenu_plus.lua 上下文菜单辅助构建 脚本设置文件 部分功能重合 uosc
cover_art_fallback.lua 无封面的音频自动使用备用图片作为封面 脚本内
input_plus.lua 快捷指令增强 #615 部分功能重合 uosc
playlist_osd.lua 高级OSD播放列表 脚本内及设置文件 部分功能重合 uosc
save_global_props.lua 保存并恢复属性值 脚本内及设置文件
stats.lua 统计数据（汉化） 脚本内 完全冲突 stats{内部脚本}
stats_mediainfo.lua 统计数据（MediaInfo版） #624
thumbfast.lua 缩略图引擎（新版） 脚本内及设置文件

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

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

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

脚本的设置文件路径 🔗

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

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

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

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

commands.conf
console.conf
osc.conf
positioning.conf
select.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 第三方着色器》
每项着色器的作用请阅读： https://github.com/hooke007/mpv_PlayKit/wiki/4_GLSL

追加关联文档：

VS脚本路径 🔗

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

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

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

vpy示例脚本 应用场景
SR_ACNET_STD 超分辨率
SR_ARTCNN_NV luma平面超分辨率（开销巨大）
MEMC_MVT_LQ 运动补偿//补帧
MEMC_DRBA_NV ...（效果好但开销较大）
MEMC_RIFE_NV ...（效果好但开销较大）
MEMC_RIFE_DML ...（效果好但开销大）
MEMC_RIFE_STD ...（效果好但开销大）
MEMC_SVP_PRO ...
NR_BM3D_NV 位于最好的降噪算法梯队，开销大
NR_CCD_STD 降低彩噪
MIX_UAI_DML 使用自定义的AI放大模型
MIX_UAI_MIGX ...
MIX_UAI_NV_TRT ...
MIX_UVR_MAD madVR
ETC_DEINT_EX 最好的反交错/去隔行算法（效果好但开销超级大）

关联文档：

追加关联文档：

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

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>

或者也可转换成着色器使用，示例： https://github.com/hooke007/mpv_PlayKit/wiki/4_GLSL#lut

缓存汇总目录 🔗

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

Clone this wiki locally