把 mpv 配置成日常观影工具Lua 脚本与配置分层实践【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpv如果你用 mpv 看过几次视频大概率会遇到这几个问题同一个文件夹里几十个视频播放完要手动找下一个老电影上下黑边占掉小半屏幕音量忽大忽小切到响的那段必须伸手调音量。这些都不是播放器不行而是默认状态没被调教过。这篇文章写给已经能打开终端、跑过一次 mpv 的人。读完你能做三件事用仓库自带的脚本解决播放列表和黑边问题把音量波动压平并理解 mpv 的配置文件是怎么分层的——这样后面自己加脚本、改快捷键都不会乱。不需要写 Lua只需要知道每个开关在哪、默认是什么。mpv 的扩展方式和其他播放器不太一样它不装插件包而是靠三类东西——配置文件、Lua 脚本、快捷键绑定。这三者各管一层下面按实际场景一层层来。先让播放列表变顺autoload 脚本什么时候用你在一个目录或一整棵目录树里存着连续剧、课程录屏、照片集希望点开一个文件后mpv 自动把同目录的其他文件排进播放列表。怎么配置仓库的TOOLS/lua/目录里有一组官方维护的脚本autoload.lua就在其中。把它的拷贝放进你的用户脚本目录~/.config/mpv/scripts/启动 mpv 时会自动加载。脚本的行为是播放开始时扫描当前文件所在目录按自然顺序2排在10前面把文件插入到当前位置的前后。它默认只扫描本地路径且不会动你手动建好的播放列表。常用开关写在~/.config/mpv/script-opts/autoload.conf里imagesno # 只放视频的目录别把图片也拖进来 directory_moderecursive # 递归扫描子目录 ignore_patterns^~,^bak-,%.bak$ # 跳过备份文件注意什么脚本对每个文件两侧最多添加 5000 条有上限超大目录不用担心卡死但也不会把整盘都塞进来。ignore_patterns用的是 Lua 模式逗号本身也是分隔符文件名里带逗号时要用%转义这是脚本注释里专门提醒过的坑。它只识别本地路径网络流、已手动加载的多文件列表都不会被扫描这个保守是好事。黑边与窗口遮挡autocrop 与 ontop 两个小脚本什么时候用老片、教学录像上下常有大片黑边看教程视频时窗口总是被其他应用盖住。黑边裁剪autocrop.lua脚本的原理不难理解——它临时插入cropdetect滤镜采集约 1 秒画面的亮度数据算出黑边范围然后写入video-crop属性再把检测滤镜撤掉。默认行为是播放开始后延迟几秒自动裁剪一次你也可以随时按C键手动触发再按一次取消。想关掉自动裁剪比如你更信任自己看内容再决定加一行script-opts-appendautocrop-autono注意什么检测依据是画面里有没有暗区域片头黑场、黑底字幕卡会让结果偏差。手动按C时选一个画面内容明确的片段按效果最准。硬件解码copy-back 模式下检测滤镜无法工作脚本会临时关掉 hwdec 再检测结束后恢复属于正常现象。如果裁剪过度把画面吃掉了可以调小detect_min_ratio参数。暂停时让出窗口ontop-playback.lua这是十几行的小脚本逻辑只有一条你开着ontop置顶时暂停就把窗口放下继续播放时再顶回来。适合视频放角上当背景、需要腾地方时按空格的多任务场景。启用方式mpv.conf里加ontopyes脚本放进 scripts 目录即可没有别的参数。音量忽大忽小acompressor 的用法什么时候用预告片、综艺节目、多来源混剪响度经常一段 -20dB 一段 0dB耳朵被反复冲击。怎么配置acompressor.lua封装了 FFmpeg 的动态压缩滤镜acompressor默认不启用按n键开关OSD 上会显示当前参数。参数调整也绑在键盘上不用打开任何配置文件F1/ShiftF1阈值 threshold 增减决定多响的声音才开始被压F2/ShiftF2压缩比 ratio 增减数值越大压得越狠F4/ShiftF4补偿增益 makeup整体提一点响度默认参数阈值 -25dB、比值 3:1对大多数内容已经够用先按n开起来听一段觉得压过头就把 ratio 降下来。注意什么压缩不是响度归一化它不会把本来就小声的整部电影整体提亮别指望它替代--audio-pitch-correction之外的系统级响度管理另外它实时处理音频老机器上 CPU 占用会略升。配置文件分层三个位置各管什么理解了脚本最后把整个配置体系捋一下以后加任何东西都有地方放。mpv 读配置按这个优先级后者覆盖前者/etc/mpv/mpv.conf 系统级管理员写的默认 ~/.config/mpv/ 用户级你自己的主阵地 命令行参数 最高优先级适合临时试验用户目录里的几个关键文件对应仓库里可参考的模板etc/文件作用mpv.conf全局开关窗口、解码、缓存、音轨字幕轨偏好input.conf快捷键绑定仓库里的etc/input.conf注释非常全可直接抄scripts/目录放.lua脚本启动即自动加载script-opts/目录每个脚本一个同名.conf存它的私有参数mpv.conf还支持 profile把一组只在特定场合生效的选项包起来比如# 全屏观影时用的渲染预设 [high-quality] profilehigh-quality然后mpv --profilehigh-quality file.mkv即可。注意什么官方etc/mpv.conf模板里特意提醒被注释的示例行通常不是默认值想看默认值用mpv --list-options别把模板当说明书。给新手的渐进路径不用一次到位。比较稳的顺序是第一周只动两样把autoload.lua放进 scripts 目录再在mpv.conf加一行ontopyes。这两项没有副作用效果立竿见影。确认自己真的被音量困扰再上 acompressor。默认参数听两次再决定要不要长期按n开着。黑边问题出现了再装 autocrop。它的检测依赖画面内容平时用不上就不要常驻。最后才碰 input.conf。改快捷键前建议先用mpv --input-test --force-window --idle进入测试模式验证绑定别在正播着的视频上瞎试。不要做的事一上来把三个脚本全装齐、给每个脚本都调参、复制别人的整套 profile。mpv 的设计哲学是每个问题一个最小开关你的配置里每多一行没想清楚的东西日后排查问题就多一层噪音。先解决今天最烦的那一件事比抄一份完整配置更值得。【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 把 mpv 配置成日常观影工具：Lua 脚本与配置分层实践
把 mpv 配置成日常观影工具Lua 脚本与配置分层实践【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpv如果你用 mpv 看过几次视频大概率会遇到这几个问题同一个文件夹里几十个视频播放完要手动找下一个老电影上下黑边占掉小半屏幕音量忽大忽小切到响的那段必须伸手调音量。这些都不是播放器不行而是默认状态没被调教过。这篇文章写给已经能打开终端、跑过一次 mpv 的人。读完你能做三件事用仓库自带的脚本解决播放列表和黑边问题把音量波动压平并理解 mpv 的配置文件是怎么分层的——这样后面自己加脚本、改快捷键都不会乱。不需要写 Lua只需要知道每个开关在哪、默认是什么。mpv 的扩展方式和其他播放器不太一样它不装插件包而是靠三类东西——配置文件、Lua 脚本、快捷键绑定。这三者各管一层下面按实际场景一层层来。先让播放列表变顺autoload 脚本什么时候用你在一个目录或一整棵目录树里存着连续剧、课程录屏、照片集希望点开一个文件后mpv 自动把同目录的其他文件排进播放列表。怎么配置仓库的TOOLS/lua/目录里有一组官方维护的脚本autoload.lua就在其中。把它的拷贝放进你的用户脚本目录~/.config/mpv/scripts/启动 mpv 时会自动加载。脚本的行为是播放开始时扫描当前文件所在目录按自然顺序2排在10前面把文件插入到当前位置的前后。它默认只扫描本地路径且不会动你手动建好的播放列表。常用开关写在~/.config/mpv/script-opts/autoload.conf里imagesno # 只放视频的目录别把图片也拖进来 directory_moderecursive # 递归扫描子目录 ignore_patterns^~,^bak-,%.bak$ # 跳过备份文件注意什么脚本对每个文件两侧最多添加 5000 条有上限超大目录不用担心卡死但也不会把整盘都塞进来。ignore_patterns用的是 Lua 模式逗号本身也是分隔符文件名里带逗号时要用%转义这是脚本注释里专门提醒过的坑。它只识别本地路径网络流、已手动加载的多文件列表都不会被扫描这个保守是好事。黑边与窗口遮挡autocrop 与 ontop 两个小脚本什么时候用老片、教学录像上下常有大片黑边看教程视频时窗口总是被其他应用盖住。黑边裁剪autocrop.lua脚本的原理不难理解——它临时插入cropdetect滤镜采集约 1 秒画面的亮度数据算出黑边范围然后写入video-crop属性再把检测滤镜撤掉。默认行为是播放开始后延迟几秒自动裁剪一次你也可以随时按C键手动触发再按一次取消。想关掉自动裁剪比如你更信任自己看内容再决定加一行script-opts-appendautocrop-autono注意什么检测依据是画面里有没有暗区域片头黑场、黑底字幕卡会让结果偏差。手动按C时选一个画面内容明确的片段按效果最准。硬件解码copy-back 模式下检测滤镜无法工作脚本会临时关掉 hwdec 再检测结束后恢复属于正常现象。如果裁剪过度把画面吃掉了可以调小detect_min_ratio参数。暂停时让出窗口ontop-playback.lua这是十几行的小脚本逻辑只有一条你开着ontop置顶时暂停就把窗口放下继续播放时再顶回来。适合视频放角上当背景、需要腾地方时按空格的多任务场景。启用方式mpv.conf里加ontopyes脚本放进 scripts 目录即可没有别的参数。音量忽大忽小acompressor 的用法什么时候用预告片、综艺节目、多来源混剪响度经常一段 -20dB 一段 0dB耳朵被反复冲击。怎么配置acompressor.lua封装了 FFmpeg 的动态压缩滤镜acompressor默认不启用按n键开关OSD 上会显示当前参数。参数调整也绑在键盘上不用打开任何配置文件F1/ShiftF1阈值 threshold 增减决定多响的声音才开始被压F2/ShiftF2压缩比 ratio 增减数值越大压得越狠F4/ShiftF4补偿增益 makeup整体提一点响度默认参数阈值 -25dB、比值 3:1对大多数内容已经够用先按n开起来听一段觉得压过头就把 ratio 降下来。注意什么压缩不是响度归一化它不会把本来就小声的整部电影整体提亮别指望它替代--audio-pitch-correction之外的系统级响度管理另外它实时处理音频老机器上 CPU 占用会略升。配置文件分层三个位置各管什么理解了脚本最后把整个配置体系捋一下以后加任何东西都有地方放。mpv 读配置按这个优先级后者覆盖前者/etc/mpv/mpv.conf 系统级管理员写的默认 ~/.config/mpv/ 用户级你自己的主阵地 命令行参数 最高优先级适合临时试验用户目录里的几个关键文件对应仓库里可参考的模板etc/文件作用mpv.conf全局开关窗口、解码、缓存、音轨字幕轨偏好input.conf快捷键绑定仓库里的etc/input.conf注释非常全可直接抄scripts/目录放.lua脚本启动即自动加载script-opts/目录每个脚本一个同名.conf存它的私有参数mpv.conf还支持 profile把一组只在特定场合生效的选项包起来比如# 全屏观影时用的渲染预设 [high-quality] profilehigh-quality然后mpv --profilehigh-quality file.mkv即可。注意什么官方etc/mpv.conf模板里特意提醒被注释的示例行通常不是默认值想看默认值用mpv --list-options别把模板当说明书。给新手的渐进路径不用一次到位。比较稳的顺序是第一周只动两样把autoload.lua放进 scripts 目录再在mpv.conf加一行ontopyes。这两项没有副作用效果立竿见影。确认自己真的被音量困扰再上 acompressor。默认参数听两次再决定要不要长期按n开着。黑边问题出现了再装 autocrop。它的检测依赖画面内容平时用不上就不要常驻。最后才碰 input.conf。改快捷键前建议先用mpv --input-test --force-window --idle进入测试模式验证绑定别在正播着的视频上瞎试。不要做的事一上来把三个脚本全装齐、给每个脚本都调参、复制别人的整套 profile。mpv 的设计哲学是每个问题一个最小开关你的配置里每多一行没想清楚的东西日后排查问题就多一层噪音。先解决今天最烦的那一件事比抄一份完整配置更值得。【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考