mpv-conf/mpv.conf
2023-03-27 21:42:42 +08:00

299 lines
24 KiB
Text
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

##⇘⇘基本说明:
##对大多数选项加入了中文注释说明
##行首存在注释符"#"代表此项处于不启用状态即恢复MPV的默认设置状态删去即启用
##注释内容解释 —— # <可选值> [条件要求] 参数意义说明 (补充)
##部分选项之间有关联作用MPV读取参数时由上往下读所以注意书写通用参数的顺序可查看手册[02]的顺序逻辑部分的错误示范
include = "~~/profiles.conf" # 该参数用于追加读取额外的设置文件。原配置组已被分离到该文件中
########
# 基础 #
########
vo = gpu-next # <gpu/gpu-next> 视频输出驱动。许多后续选项也只能在此三项下正常工作。当前版本默认值即gpu
# gpu最高普适性和完成度gpu-next查看此处讨论 https://github.com/hooke007/MPV_lazy/discussions/39
#gpu-context = vulkan # <d3d11/winvk> 选择输出后端默认auto此项的值与 --gpu-api 相关联,通常只需设置其中一项即可)
gpu-api = vulkan # <d3d11/vulkan> 选择图形绘制接口默认auto。非特殊情况下win10用户始终应首选d3d11
# vulkan的10bit尚未完全实现 https://github.com/mpv-player/mpv/issues/8554
#fbo-format = auto # 内处理精度。此项通常由 --gpu-api=<value> 自动决定正确值默认首选16位及以上的精度
#d3d11-exclusive-fs = yes # --gpu-api=d3d11 下的全屏独占
#d3d11-flip = no # [通常发生在 --d3d11-exclusive-fs=yes 和 --on-top 一起使用时] 可用于避免MPV全屏时的冻屏问题
# 如果存在上述问题则启用该参数否则不应该使用因为d3d11下的翻转模型性能最好
hwdec = auto # 指定应使用的硬件视频解码API。软解改为 no默认。硬解建议使用 d3d11va-copy。10系以上N卡强烈建议使用 nvdec-copy
# 当 --gpu-api=d3d11 时,值 auto 首选 d3d11va ;值 auto-copy 首选 dxva2-copy当 --gpu-api=vulkan 时,值 auto 首选 nvdec
# 值 auto 等效 yes。不推荐选用理论上解码效率最高的 无-copy 的原生硬解 ,目的是确保全部设置/滤镜/着色器正常作用(有些不支持)
# 在部分机器上 dxva2-copy 的占用可能远低于 d3d11va-copy
hwdec-codecs = all
# 在选定范围内的编码格式尝试硬解,当前版本默认值为 --hwdec-codecs=h264,vc1,hevc,vp8,vp9,av1
#log-file = "~~desktop/mpv-lazy.log"
# 记录名为"mpv-lazy"的log日志在桌面
##⇘⇘双显卡笔记本的处理
#d3d11-adapter = "NVIDIA GeForce RTX 2070 Super"
# [当 gpu-api=d3d11 时] 指定某张显卡作为主渲染输出,默认情况下自动选择系统指定的主渲染显卡。
# 显卡名可查看任务管理器自行更改适配。该参数等效在驱动面板中设置以独显运行mpv
# 例如使用I+N的双显笔记本的内屏时实际使用的是"Intel(R) UHD Graphics"修改该项示例指定独显可降低任务管理器中双显卡的3d渲染占比
# 大多数双显卡笔记本在外接显示器时,表现类似“独显直连”,此时无需该参数也会自动用独显输出
#vulkan-device = "NVIDIA GeForce RTX 2070 Super"
# [当 gpu-api=vulkan 时] 此参数代替 --d3d11-adapter 执行指定显卡的职能
########
# 功能 #
########
input-builtin-bindings = no # 禁用mpv初始的快捷键方案只使用 input.conf 中的设定)
# 此项不同于 --input-default-bindings=no (同时也禁用脚本中预设的弱绑定键位)
#fs = yes # --fs 等效 --fullscreen。运行MPV自动进入全屏
#border = no # 默认为系统原生窗口界面启用此项使用无边框界面去除WINDOWS的窗口装饰
#window-maximized = yes # 运行MPV自动窗口最大化无边框界面时的最大化类似“无边窗口模式”而非“全屏”
#ontop = yes # 窗口置顶(当 --gpu-api=vulkan 时也有全屏独占作用)
hidpi-window-scale = no # [推荐设置为no] 是否执行HIDPI缩放默认yes。MPV支持HIDPI没有实际意义因为本身不是GUI程序
# 默认值情况下初始化的视频窗口随DPI改变大小例如在缩放200%的4k的显示器打开800p视频后自动执行2倍缩放变1600p。此外还会影响其它脚本部分内容
autofit-larger = 80%x80% # 窗口模式下最大占屏幕的百分比例如在FHD屏上打开4k视频初始窗口过大
autofit-smaller = 50%x50% # 窗口模式下最小占屏幕的百分比例如在4k屏上打开720p视频初始窗口过小
#keepaspect = no # 默认yes默认情况下MPV只按源比例拉伸视频。启用此项将始终变形画面至窗口大小
#keepaspect-window = no # 默认yes默认情况下MPV的窗口比例锁定为视频比例。启用此项以实现窗口自由拉伸行为当 keepaspect=yes 时四周填充黑边)
#panscan = 1.0 # <0.0-1.0> 裁切横向画面以充满窗口(建议配合 keepaspect-window=no 使用)
#background = "#778899" # <格式为(AA)RRGGBB> 更改MPV初启动与播放无视频轨文件时的背景颜色
pause = no # 以暂停状态启动播放器
#loop = inf # <N|inf|no> 始终循环播放当前文件
#loop-playlist = no # <N|inf|force|no> 播放列表循环
keep-open = no # <yes|默认no|always> 默认情况下播完列表所有文件MPV自动关闭设置为 yes 所有播放完毕不退出,设置为 always 可以实现类似“每个文件播完都暂停”的效果
hr-seek-framedrop = no # [SVP补帧时推荐设置为no] 跳转时丢帧,关闭利于修正音频延迟
save-position-on-quit = no # 退出时记住播放状态
watch-later-options = vid,aid,sid
# [SVP补帧时推荐设置为留空] 稍后观看的白名单(留空即只保存播放位置)
# 当 --save-position-on-quit=yes 或使用退出时保存到稍后观看的功能时,如果不使用白名单,滤镜列表、音量、速率等其它状态也会被保存并在下次启动时恢复
#input-ipc-server = mpvpipe # [使用SVP Manager时必须开启此项] IPC支持
##⇘⇘缓存相关
#demuxer-max-bytes = 200MiB # 播放网络视频时的向后缓存大小KiB或MiB
icc-cache-dir = "~~exe_dir/_cache/icc"
# 指定目录存储和加载从ICC配置文件创建的3D LUT可以用来加快加载速度。未压缩的LUT的大小取决于 --icc-3dlut-size=<value>
# gpu-shader-cache-dir = "~~exe_dir/_cache/shader"
# 在此目录中存储和加载已编译的GLSL着色器缓存可以提高启动性能。
watch-later-directory = "~~exe_dir/_cache"
# 在此目录中存储 "watch_later" 文件夹,其中的文件记录 --watch-later-options 指定的选项。默认路径为 "~~/watch_later"
#######
# OSD #
#######
##⇘⇘OSD 即 On-Screen-Display ,通常为屏幕上弹出显示的信息。 OSC 即 on-screen-controller MPV中指的是简易操控界面
osd-on-seek = msg-bar # <no,bar,msg,msg-bar> 在跳转时间轴时显示的信息类型
#osd-blur = 1
osd-bar-w = 100
osd-bar-h = 2
osd-bar-align-y = -1
#osd-color = "#B300FFFF"
#osd-border-color = "#B3008B8B"
osd-border-size = 1
osd-font-size = 40 # 更改OSD字体大小全局影响多个功能显示的文本默认值55
osd-fractions = yes # 以秒为单位显示OSD时间毫秒精度有助于查看视频帧的确切时间戳
osd-playing-msg = "${filename}"
# 开始播放时短暂显示的信息:文件名
osd-duration = 2000 # 设置OSD文本信息的持续时间毫秒默认值1000
########
# 音频 #
########
#ao = wasapi # win10默认使用WASAPI。如果有其他软件先独占音频通道后再打开MPV可能会画面会卡顿
#audio-device = auto # 此项用于指定启动时的音频输出设备
# 改具体值示例 --audio-device="wasapi/{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"设备名获取方式见发布页FAQ图文或官方手册
#audio-exclusive = yes # 音频通道独占
volume-max = 120 # <100.0-1000.0> 最大音量。默认值130130的响度约为100的两倍
volume = 90 # 播放器启动音量。0为静音默认100
#audio-channels = stereo # 强制多声道音源下混为双声道输出避免可能的7.1/5.1→2.0声音丢失和音量过小)
#audio-pitch-correction = yes # [--af=scaletempo/scaletempo2/rubberband 的前置条件] 变速播放时的音调修正,默认开启。自动插入前三项音频滤镜中其一(更多信息见滤镜区)
audio-file-auto = fuzzy # <默认no|exact|fuzzy|all> 自动加载同名外挂音轨fuzzy为模糊名exact为精确名
########
# 视频 #
########
##⇘⇘色彩管理
#icc-profile-auto = yes # 如果做过专业校色应开启系统目录存在对应的icm校色文档。未做校色的广色域屏应手动指定 --target-prim=<value>
#icc-profile = "X:/xxx/xxxx.icm"
# 此选项用于加载指定的ICC与前项不共存
#icc-3dlut-size = <r>x<g>x<b> # <2-512> 从ICC配置文件的每个维度生成的3D LUT的大小。默认值为 64x64x64
#icc-force-contrast = inf # <no|0-1000000|inf> 强制指定ICC的静态对比度而不是使用配置文件的内设可能存在测量错误。默认 no
# 普通LCD一般使用 1000 以面板原生数据为准使用OLED显示设备的用户尝试使用 1000000 或特殊值 inf
#target-prim = auto # 当不使用ICC颜色管理时视频颜色将适应此颜色空间
# 未经校色的广色域屏可设定此参数以解决色彩过饱和的问题。例如99%的argb屏幕写adobe。90%+的p3色域屏写dci-p3srgb屏无需更改此默认值
##⇘⇘音视频同步模式。只需注释掉 --video-sync=<value> 即可恢复MPV的默认同步模式
video-sync = display-resample # 类"ReClock"作用,更改为与视频帧与显示器刷新率同步,自动调节音频速度补偿偏移。
# 默认值audio与音频/系统时钟同步)通常兼容性最好但有偶尔的丢帧和重复
video-sync-max-video-change = 5 # [仅当 --video-sync=display-xxxx 时生效]
interpolation = yes # [仅当 --video-sync=display-xxxx 时生效] 减少由于视频帧率fps和显示刷新率hz不匹配而引起的卡顿抖动
tscale = spline16 # [仅开启 --interpolation 时生效] 时间插值算法非MEMC运动补偿
# oversample 即维持源观感的算法效果类似MADVR的smoothmotion默认值 mitchell
##⇘⇘“画质”相关
##避免简单粗暴的使用 --profile=gpu-hq ,原因见下方以及手册[02]开头部分
cscale = catmull_rom # 色度还原算法;可由更好的 "KrigBilateral.glsl" 着色器取代。默认 bilinear
scale = sinc # 放大算法, 默认值同上
dscale = mitchell # 缩小算法。若不设定,则自动采用 --scale=<value> 的值
##所有可用的内置算法参见手册 [06]
#linear-upscaling = yes # [须 --fbo-format 指定16位及以上的精度与 --sigmoid-upscaling 不兼容] 对HDR内容无影响
#sigmoid-upscaling = yes # [使用"adaptive-sharpen.glsl"时须关闭;与 --linear-upscaling 不兼容] 放大时非线性的颜色转换,可避免强振铃伪影
##开发者建议要么优先使用 --sigmoid-upscaling ,要么以上两项干脆都不用
#linear-downscaling = yes # [使用"SSimDownscaler.glsl"时须关闭;须 --fbo-format 指定16位及以上的精度] 对HDR内容无影响
##上两项 --linear- 的参数对应MADVR中的"scale in linear light",在缩小算法中线性处理可以提升颜色对比度的精确性
#correct-downscaling = yes # [当 --dscale=bilinear 时此项无效] 增强缩小算法的质量,对于异形比例视频可能产生微小失真
#scaler-resizes-only = no # 默认yes当未进行缩放处理时使用bilinear算法完美还原
# 禁用时即使未改变大小也使用指定的scale值进行处理。这可以修正nnedi3和ravu引入的半像素偏移但没必要
dither-depth = auto # <N|no|auto> 是否开启色深抖动弥补色彩转换损失。8位显示器写810位显示器写10auto的值取决于 --gpu-api 不一定正确
# 如果8抖10的显示器使用10存在输出异常的情况改回值8
#deband = yes # 去色带。可能受硬解码影响实际效果
#profile = DeBand+ # 备选的去色带方案,具体参数见 "profiles.conf" 中的同名配置组
####################
# 脚本 滤镜 着色器 #
####################
##以下都可选择在此处开启,即默认每次随播放器启动;或者使用"input.conf"中的方案手动选择加载
##⇘⇘脚本部分
##内置脚本开关如果没有必要的目的那就不要屏蔽mpv内建的功能
#load-auto-profiles = no # <yes|no|默认auto> 新版条件配置(使用旧版外挂的用户记得禁用)
#load-osd-console = no # 控制台
#load-stats-overlay = no # 统计信息
osc = no # [使用第三方OSC的前置条件] 禁用原OSC即内置的"osc.lua"脚本)以兼容第三方的界面样式
#ytdl = no # 网址解析增强
#ytdl-raw-options-append = cookies=[D:/cookies.txt]
# [当 --ytdl=yes 时有效] 将自定义的选项传递给ytdl https://github.com/ytdl-org/youtube-dl#options
# 示例仅为传递单个选项,多个选项最好独立追加,即写多个 --ytdl-raw-options-append 参数 https://mpv.io/manual/master/#options-ytdl-raw-options
#load-scripts = yes # 自动挂载/scripts/目录中的所有外置脚本默认yes。设置为no时可用下一行示例的命令加载指定的外置脚本
#scripts = "~~/scripts/autoload.lua;~~/scripts/playlistmanager.lua;~~/scripts/open-file-dialog.lua"
##⇘⇘滤镜部分
##设定随MPV启动的音/视频滤镜的书写格式(支持多项) --af/vf=滤镜①=参数❶=值:参数❷=值,滤镜②...
## --af= 和 --vf= 仅能各存在一条。如果不想只使用这条参数,可以拆开写,例如使用 --vf-append 单项多次追加更多的滤镜,并不会覆盖 --vf=<value> 指定的滤镜
##音频变速滤镜三选一(当前默认值已足够好)
#af = scaletempo=scale=1.0:stride=60:overlap=.20:search=14:speed=tempo
# 旧版mpv使用的音频变速滤镜。示例值为默认参数
# 其中的 scale=<N> 控制额外视频加速度stride=<N> 值太高会导致在高速时跳音,低速出现回声,值太低会改变音调,值增大提升性能
# overlap=<N> 重叠百分比值减少提高分离度且提升性能search=<N> 搜索最佳重叠位置的长度(毫秒),值减少提升性能
# speed=<tempo|pitch|both|none> tempo节奏与速度同步pitch造成卡顿不使用both同时兼顾节奏与音调none忽略速度变化不使用
#af = scaletempo2=min-speed=0.25:max-speed=4.0:search-interval=30:window-size=20
# 此项参数为变速播放时默认自动激活的音频滤镜。在 min/max-speed=<N> 此速度范围外直接静音处理。scaletempo2具有更高的音频质量
#af = rubberband
# 声音质量介于scaletempo和scaletempo2之间。可调节的细参众多详情见官方文档这里直接使用默认参数
#vf-append = format=gamma=gamma2.2
# MPV校色曲线目标是BT.1886,此视频滤镜用于回归常见的显示器标准 https://github.com/mpv-player/mpv/issues/8009
#vf-append = fps=fps=60/1.001
# 强制视频以指定帧率输出(此项与补帧冲突),通常被用于增强滚动弹幕的平滑性,不推荐使用 --sub-fps=<value> 。分子数值(取整)为你的显示器刷新率。
##VS脚本实际以视频滤镜的形式在MPV中工作。补帧滤镜只能启用一个且不与SVP一起使用建议编辑源文件参数以适配实际机器
#vf-append = vapoursynth="~~/mvtools-standard.vpy"
# mvtools补帧脚本标准版
#vf-append = vapoursynth="~~/svpflow-2x.vpy"
# 通过svpflow实现的补帧脚本动漫版非SVP Manager程序
##⇘⇘着色器部分
##此处的 --glsl-shaders=<value> 用于指定每次随MPV共同启动的着色器支持多项。更多详细着色器信息参见手册[01]
##--glsl-shaders-append 等效 --glsl-shader=<value> (注意和上行说明中参数的区别),表示追加着色器(单次仅能追加一项),并不会覆盖第一条 --glsl-shaders=<value> 指定的着色器,可无限追加该命令。
##初始加载多个着色器的示例写法
#glsl-shaders = "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Restore_CNN_M.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_S.glsl"
#glsl-shaders-append = "~~/shaders/SSimDownscaler.glsl"
# [与 --linear-downscaling=no 一起使用] 对MPV的内置缩小算法增强
#glsl-shaders-append = "~~/shaders/adaptive-sharpen.glsl"
# [与 --sigmoid-upscaling=no 一起使用] 自适应锐化
########
# 字幕 #
########
sub-auto = fuzzy # 自动加载当前播放文件的同名外挂字幕
#sub-file-paths = sub;subtitles;字幕;C:/字幕库
# 在指定的额外目录中寻找匹配的字幕。支持相对和绝对路径,示例即自动搜索当前文件路径下名为"sub","subtitles","字幕"和C盘的"字幕库"文件夹内
slang = chs,sc,zh,chi,zho
# 字幕首选语言为中文但MPV优先加载外挂轨道此项参数可能实际用处不大
#sub-font = "YouYuan"
# 指定纯文本字幕的默认字体
# 该参数本应对ASS字幕无效实际影响了ASS的缺省默认字体 https://github.com/mpv-player/mpv/issues/8637
sub-back-color = "#641C1C1C" # <格式为(AA)RRGGBB> 设定纯文本字幕的底色
#blend-subtitles = video # <yes|video|默认no> 在插值和颜色管理之前将字幕混合到视频帧上。值video类似于yes但是以视频的原始分辨率绘制字幕并与视频一起缩放
# 启用此功能会将字幕限制在视频的可见部分(不能出现在视频下方的黑色空白处)
# 还会让字幕受 --icc-profile --target-prim --target-trc --interpolation --gamma-factor --glsl-shaders 的影响
# 与 --interpolation 一起使用时,可提高字幕渲染性能
sub-ass-force-margins = yes # [当 --blend-subtitles=yes/video 时无效] 使ASS字幕尽可能输出在黑边上
#sub-use-margins = no # 是否使纯文本字幕输出在黑边上默认yes
#stretch-image-subs-to-screen = yes # 强制拉伸图形字幕到缩放分辨率而不是参考视频分辨率可以使PGS实现输出在黑边的效果可能破坏显示效果
##⇘⇘模拟vsfilter相关
##默认情况下libass和vsfilter渲染的字幕存在部分差异以下选项可用于使视觉效果相近模仿vsfilter
#sub-ass-force-style = ScaledBorderAndShadow=no
# 强制样式:不缩放边框和阴影。可防止所谓的“重墨”风格 https://github.com/libass/libass/issues/287
# 该行为可能违背创作者意图,建议使用快捷键方案手动触发
#sub-ass-vsfilter-aspect-compat = no # 播放非常规比例视频时拉伸ASS字幕默认yes
#sub-ass-vsfilter-blur-compat = no # 通过视频分辨率而不是.ass指定的分辨率缩放"\blur"标签默认yes
#sub-ass-vsfilter-color-compat = full # <默认basic|full|force-601|no> 字幕色彩处理 https://mpv.io/manual/master/#options-sub-ass-vsfilter-color-compat
########
# 截图 #
########
##⇘⇘以下预设参数只是为了截取最高质量的图片(高质量截图处理效率较低)
screenshot-format = png # <默认 jpg|png|webp>
#screenshot-jpeg-quality = 100 # <0-100> JPEG的最高质量默认为90
#screenshot-jpeg-source-chroma = yes # 用与源视频相同的色度半采样写入JPEG默认yes
screenshot-png-compression = 5 # <0-9> PNG压缩等级过高的等级影响性能默认为7
#screenshot-png-filter = 5 # <0-5> PNG的压缩过滤器。默认5即可实现最佳压缩率
#screenshot-webp-lossless = yes # 无损WEBP默认no
#screenshot-webp-quality = 100 # 此项数值仅在 --screenshot-webp-lossless=no 时生效
#screenshot-webp-compression = 3 # WEBP压缩等级使用有损WEBP时进一步降低图片质量默认为4 <0-6>
screenshot-tag-colorspace = yes # 使用适当的色彩空间标记屏幕截图并非所有格式受支持默认no
#screenshot-high-bit-depth = yes # 主要影响PNG尽可能使用和视频输出时相同的位深默认yes
screenshot-template = "~~desktop/MPV-%P-N%n"
# [若直接在模板中设置路径,此时无需 --screenshot-directory ] 截图命名模板: https://mpv.io/manual/master/#options-screenshot-template
#screenshot-directory = "~~desktop/"
# 保存截图在桌面
########
# 其它 #
########
#d3d11-output-csp = pq # [须 --gpu-api=d3d11] 此项参数用于直出HDR且不支持条件配置会影响sdr播放。
# 当前版本需先手动打开win10 OS HDR再打开MPV后全屏开始播放