幫 2F 的內容轉正體中文
##⇘⇘基本說明:
##對大多數選項加入了中文註解說明
##行首存在註解符號"#",代表此項處於不啟用狀態(即恢覆MPV的預設設定狀態),刪去即啟用
##註解內容解釋 —— # <可選值> [條件要求] 參數意義說明 (補充)
##部分選項之間有關聯作用,MPV讀取參數時由上往下讀,所以注意書寫通用參數的順序,可查看手冊[02]的順序邏輯部分的錯誤示範
include = "~~/profiles.conf" # 該參數用於追加讀取額外的設定檔案。原預設設定已被分離到該檔案中
#log-file = "~~desktop/mpv-lazy.log" # 記錄名為"mpv-lazy"的log日誌在桌面
########
# 基礎 #
########
vo = gpu # <gpu/gpu-next> 影片輸出驅動。許多後續選項也只能在此三項下正常工作。目前版本預設值即gpu
gpu-context = d3d11 # <win/d3d11/winvk> 選擇圖形輸出後端,預設auto(此項的值與 --gpu-api 相關聯,分別對應opengl/d3d11/vulkan)
#fbo-format = auto # 內處理精度。此項通常由 --gpu-api=<value> 自動決定正確值,預設首選16位及以上的精度
#d3d11-exclusive-fs = yes # --gpu-api=d3d11 下的全螢幕獨占
#d3d11-flip = no # [通常發生在 --d3d11-exclusive-fs=yes 和 --on-top 一起使用時] 可用於避免MPV全螢幕時的凍顯示器問題
hwdec = auto-copy # 指定應使用的硬體影片解碼API。軟解改為 no(預設)。硬解建議使用 d3d11va-copy。10系以上N卡強烈建議使用 nvdec-copy
# 值 auto 等效 yes。不推薦選用理論上解碼效率最高的 無-copy 的原生硬解 ,目的是確保全部設定/濾鏡/著色器正常作用(有些不支援)
# 在部分機器上 dxva2-copy 的占用可能遠低於 d3d11va-copy
hwdec-codecs = all
# 在選定範圍內的編碼格式嘗試硬解,目前版本預設值為 --hwdec-codecs="h264,vc1,hevc,vp8,vp9,av1,prores"
##⇘⇘雙顯示卡筆電的處理
d3d11-adapter = "Intel(R) Arc(TM) A750 Graphics"
# [當 gpu-api=d3d11 時] 指定某張顯示卡作為主繪製輸出,預設情況下自動選擇系統指定的主繪製顯示卡。
# 顯示卡名可查看任務管理器自行更改調整。該參數等效在驅動面板中設定以獨顯執行mpv
# 例如使用I+N的雙顯筆電的內顯示器時,實際使用的是"Intel(R) UHD Graphics",修改該項範例指定獨顯可降低任務管理器中雙顯示卡的3d繪製占比
# 大多數雙顯示卡筆電在外接顯示器時,表現類似「獨顯直連」,此時無需該參數也會自動用獨顯輸出
vulkan-device = "Intel(R) Arc(TM) A750 Graphics"
# [當 gpu-api=vulkan 時] 此參數代替 --d3d11-adapter 執行指定顯示卡的職能
########
# 功能 #
########
idle = yes # <yes|預設no|預設once> 空閒待機(中止播放或所有文件播放後依舊保持mpv執行)。
#input-ipc-server = mpvpipe # [使用SVP Manager時必須開啟此項] IPC支援
input-builtin-bindings = no # 禁用mpv初始的快捷鍵方案(只使用 input.conf 中的設定)
# 此項不同於 --input-default-bindings=no (同時也禁用腳本中預設的弱綁定鍵位)
#background = "#778899" # <格式為(AA)RRGGBB> 更改MPV初啟動與播放無影片軌檔案時的背景顏色
pause = yes # 以暫停狀態啟動播放器
#panscan = 1.0 # <0.0-1.0> 裁切橫向畫面以充滿視窗(建議配合 keepaspect-window=no 使用)
#loop = inf # <N|inf|no> 始終循環播放目前文件
#loop-playlist = no # <N|inf|force|no> 播放列表循環
hr-seek-framedrop = no # [SVP補幀時推薦設定為no] 跳轉時丟幀,關閉利於修正音訊延遲
save-position-on-quit = yes # 退出時記住播放狀態
watch-later-options = vid,aid,sid
# [SVP補幀時推薦設定為留空] 稍後觀看的白名單(留空即只儲存播放位置)
# 當 --save-position-on-quit=yes 或使用退出時儲存到稍後觀看的功能時,如果不使用白名單,濾鏡列表、音量、速率等其它狀態也會被儲存並在下次啟動時恢覆
##⇘⇘視窗相關
#fs = yes # --fs 等效 --fullscreen。執行MPV自動進入全螢幕
keep-open = yes # <yes|預設no|always> 預設為播完列表不暫停,值為 yes 播完列表暫停,值為 always 時每個文件播完都暫停
#ontop = yes # 視窗置頂(當 --gpu-api=vulkan 時也有全螢幕獨占作用)
#border = no # 預設為系統原生視窗介面,啟用此項使用無邊框介面(去除WINDOWS的視窗裝飾)
#geometry = 1280x720 # 設定初始位置或尺寸,附帶鎖定視窗比例的作用。支援多種表示方法(例 50%x50% 即桌面長寬的一半)
# 使用這項參數將無效化 --autofit --autofit-larger --autofit-smaller --window-scale
#autofit-larger = 80%x80% # 視窗自動拉伸時(初起動/切換文件)防止太大。使用 --autofit 系列的參數將無效化 --window-scale
autofit-smaller = 40%x40% # 視窗自動拉伸時(初起動/切換文件)防止太小
#keepaspect-window = no # 視窗自由拉伸(no)還是按比例拉伸(預設yes)
hidpi-window-scale = no # [推薦設定為no] 是否執行HIDPI縮放,預設yes
##⇘⇘快取相關
#demuxer-max-bytes = 200MiB # 播放網路影片時的向後快取大小(KiB或MiB)
icc-cache-dir = "~~/_cache/icc"
# 指定目錄儲存和載入從ICC設定檔建立的3D LUT,可以用來加快載入速度。未壓縮的LUT的大小取決於 --icc-3dlut-size=<value>
gpu-shader-cache-dir = "~~/_cache/shader"
# 在此目錄中儲存和載入已編譯的GLSL著色器快取,可以提高啟動性能。
watch-later-directory = "~~/_cache/watch_later"
# 在此目錄中儲存 "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 = 0
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,其它可用的有openal和sdl。
#audio-device = auto # 此項用於指定啟動時的音訊輸出裝置
# 改具體值範例 --audio-device="wasapi/{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}",裝置名獲取方式見發布頁FAQ圖文或官方手冊
#audio-exclusive = yes # 音訊通道獨占(如果有其他軟體先獨占音訊通道後,再打開MPV可能會畫面會卡頓)
volume = 60 # 播放器啟動音量。0為無,預設100
#volume-max = 100 # <100.0-1000.0> 最大音量。預設值130(130的響度約為100的兩倍 1.3^3≈2)
audio-channels = stereo # 強制多聲道音源下混為雙聲道輸出(避免可能的7.1/5.1→2.0聲音遺失和音量過小)
#audio-pitch-correction = no # [ --af=scaletempo/scaletempo2/rubberband 的前置條件] 變速播放時的音調修正,預設yes。自動插入前三項音訊濾鏡中其一(更多訊息見濾鏡區)
#alang = chs,sc,zh,chi,zho
# 音軌首選語言為中文,但MPV優先載入外掛軌道,此項參數可能實際用處不大
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-p3(srgb顯示器無需更改此預設值)
##⇘⇘影音同步模式。只需註解掉 --video-sync=<value> 即可恢覆MPV的預設同步模式
video-sync = display-resample # 類"ReClock"作用,更改為與影片幀與顯示器重新整理率同步,自動調節音訊速度補償偏移。
# 預設值audio(與音訊/系統時鐘同步)通常相容性最好但有偶爾的丟幀和重複
video-sync-max-video-change = 5 # [僅當 --video-sync=display-xxxx 時生效] 預設1
interpolation = yes # [僅當 --video-sync=display-xxxx 時生效] 減少由於影片幀率fps和顯示重新整理率hz不匹配而引起的卡頓(抖動)。
tscale = spline16 # [僅開啟 --interpolation 時生效] 時間插值演算法(非MEMC運動補償)。
# oversample 即維持源觀感的演算法(效果類似MADVR的smoothmotion),預設值 mitchell
##⇘⇘「畫質」相關
##避免簡單粗暴的使用 --profile=gpu-hq ,原因見手冊 [02]
#cscale = ewa_lanczos # 色度還原演算法;可由更好的 "KrigBilateral.glsl" 著色器取代。預設 bilinear
scale = catmull_rom # 放大演算法,預設值同上
dscale = mitchell # 縮小演算法。若不設定,則自動採用 --scale 的值
##所有可用的內建演算法參見手冊 [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位顯示器寫8,10位顯示器寫10,auto的值取決於 --gpu-api 不一定正確
# 如果8抖10的顯示器使用10存在輸出異常的情況,改回值8
#dither = error-diffusion # <預設fruit|ordered|error-diffusion|no> 色深抖動的演算法;值 no 等效 --dither-depth=no
# 誤差擴散非常好但沒必要,它基於計算著色器需要不低的效能開銷,感知弱
#deband = yes # 去色帶。可能受硬解碼影響實際效果
#profile = DeBand+ # 備選的去色帶方案,具體參數見 "profiles.conf" 中的同名預設設定
#profile = SWscaler # 備選的軟體縮放器方案,具體參數見 "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]
#load-scripts = no # 自動掛載 /scripts/ 目錄中的所有外部腳本,預設yes。設定為no時可用下一行範例的指令載入指定的外部腳本
#scripts = "~~/scripts/load_plus.lua;~~/scripts/playlistmanager.lua"
#script-opts = osc-layout=box,osc-seekbarstyle=diamond,console-scale=1.2
# 該範例參數是一種透過主設定檔案來設定腳本內選項的方式,它的優先度高於資料夾 /script-opts/ 內的腳本設定檔案
# 語法結構為: <腳本1>-<腳本1的選項1>=<值>,<腳本1>-<腳本1的選項2>=<值>,<腳本2>-<腳本2的選項1>=<值>...
# 如果要設定的腳本選項較多,應該用多個 -append 單項追加(見下方範例),顯得條理清晰(當然最好使用 /script-opts/ 資料夾)
#script-opts-append = stats-redraw_delay=0.1
#script-opts-append = ytdl_hook-ytdl_path=youtube-dl
##⇘⇘濾鏡部分
##設定隨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
#vf-append = fps=fps=60/1.001
# 強制影片以指定幀率輸出(此項與補幀衝突),通常被用於增強滾動彈幕的平滑性,不推薦使用 --sub-fps=<value> 。分子數值(取整)為你的顯示器重新整理率。
##VS腳本實際以影片濾鏡的形式在MPV中工作。補幀濾鏡只能啟用一個,且不與SVP一起使用(建議編輯來源文件參數以相容實際機器)
#vf-append = vapoursynth="~~/vs/mvtools-std.vpy"
# mvtools補幀腳本標準版
vf-append = vapoursynth="~~/vs/svpflow-Starlight.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 (或 --glsl-shader ) 會依次排列在 --glsl-shaders 之後,當然你也可以不寫 --glsl-shaders 只用前二者的佇列
glsl-shaders-append = "~~/shaders/KrigBilateral.glsl"
#glsl-shaders-append = "~~/shaders/AMD-FSR-EASU_rgb.glsl"
########
# 字幕 #
########
sub-auto = fuzzy # <no|預設exact|fuzzy|all> 自動載入目前播放文件的同名外掛字幕(fuzzy為模糊名,exact為精確名)
#sub-file-paths = sub;subtitles;字幕;C:/字幕庫
# 在指定的額外目錄中尋找匹配的字幕。支援相對和絕對路徑,範例即自動搜尋目前文件路徑下名為"sub","subtitles","字幕"和C槽的"字幕庫"資料夾內
slang = cht,tc,zh,chi,zho
# 字幕首選語言為中文,但MPV優先載入外掛軌道,此項參數可能實際用處不大
#blend-subtitles = video # <yes|video|預設no> 在插值和顏色管理之前,將字幕混合到影片幀上。值video類似於yes,但是以影片的原始解析度繪製字幕,並與影片一起縮放
# 啟用此功能會將字幕限制在影片的可見部分(不能出現在影片下方的黑色空白處)
# 還會讓字幕受 --icc-profile --target-prim --target-trc --interpolation --gamma-factor --glsl-shaders 的影響
# 與 --interpolation 一起使用時,可提高字幕繪製性能
##⇘⇘純文字字幕部分 —— SRT LRC
sub-font = "思源黑體 Light"
# 指定純文字字幕的預設字體
#sub-back-color = "#641C1C1C" # <格式為(AA)RRGGBB> 設定純文字字幕的背景色
#sub-use-margins = no # 是否使純文字字幕輸出在黑邊上,預設yes
#profile = sub_SRT # 備選的純文字字幕樣式方案,具體參數見 "profiles.conf" 中的同名預設設定
##⇘⇘進階字幕部分 —— SSA ASS
sub-ass-force-margins = yes # [當 --blend-subtitles=yes/video 時無效] 使ASS字幕盡可能輸出在黑邊上
#sub-ass-force-style = ScaledBorderAndShadow=no
# 強制自訂樣式而無視字幕預設樣式。範例:不縮放字體邊框和陰影
##⇘⇘模擬vsfilter相關
##預設情況下libass和vsfilter繪製的字幕存在部分差異,以下選項可用於使視覺效果相近(模仿vsfilter)
#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> 字幕色彩空間處理
##⇘⇘圖形字幕部分 —— IDX SUB SUP
#stretch-image-subs-to-screen = yes # 強制拉伸圖形字幕到縮放解析度而不是參考影片解析度,可以使PGS實現輸出在黑邊的效果,可能破壞顯示效果
########
# 截圖 #
########
##⇘⇘以下預設參數是為了截取高品質的圖片(輸出品質越高,截圖處理效率越低)
screenshot-format = png # <預設 jpg|png|webp>
screenshot-jpeg-quality = 100 # <0-100> JPEG的品質,預設為90
screenshot-jpeg-source-chroma = no # 用與源影片相同的色度半採樣寫入JPEG,預設yes
screenshot-png-compression = 5 # <0-9> PNG壓縮等級,過高的等級影響性能,預設為7
#screenshot-png-filter = 0 # <0-5> PNG的壓縮過濾器。預設5即可實現最佳壓縮率
screenshot-webp-lossless = yes # 無損WEBP,預設no
screenshot-webp-quality = 100 # <0-100> [當 --screenshot-webp-lossless=no 時生效] 有損WEBP的品質,預設75
#screenshot-webp-compression = 3 # <0-6> WEBP壓縮等級,使用有損WEBP時進一步降低圖片品質,預設為4
#screenshot-tag-colorspace = yes # 使用適當的色彩空間標記螢幕截圖(並非所有格式受支援)預設no
#screenshot-high-bit-depth = no # 主要影響PNG,盡可能使用和影片輸出時相同的位深,預設yes
screenshot-template = "~~desktop/MPV-%P-N%n"
#screenshot-directory = "~~desktop/"
# [若已在截圖命名模板中設定路徑,此時無需使用該參數 ] 儲存截圖在桌面