mpv Lua 脚本三件套：从自动连播到音量拉平，完整配置指南

【免费下载链接】mpv 🎥 Command line media player 项目地址: https://gitcode.com/GitHub_Trending/mp/mpv

日常使用的三个小烦恼

你打开 mpv 播放器里的一个视频，文件夹里下一个不会自动排队；电影的上下黑边吃掉屏幕三分之一；音量忽大忽小，吵得耳朵疼。这三个问题，都能靠 mpv 的 Lua 脚本扩展解决。官方仓库自带了三个现成脚本，都是现成文件，改的是配置文件，不碰源码。

第一层 · 三行 conf 搞定自动连播

解决什么： mpv 默认只加载你打开的那个文件，放完就停。autoload 脚本 会扫描文件所在目录，把前后的文件自动加入播放队列。

mpv 脚本安装就一步： 把脚本复制到 ~/.config/mpv/scripts/，mpv 会自动加载，不用注册。

改哪里： 在配置目录建 ~/.config/mpv/script-opts/autoload.conf：

directory_mode=recursive
videos=yes
audio=no

改完看到什么： 当前目录（含子目录）的视频按字母序排队，播放列表自动填满，这就是完整的 mpv 自动播放列表。

一句话原理： 扫描当前目录，按扩展名过滤。

还有几个细节。它只加入播放列表里没有的文件，队列稳定，不会重复排队；前后各最多扫 5000 个文件，超大目录也不会卡。队列存在内存里，关掉 mpv 就没了，下次打开会重新扫目录，删掉的文件不会残留在列表。audio=no 表示不排队音频；想影音混排，改成 yes 即可。临时文件多的话，加一行 ignore_patterns=^~,^bak- 跳过。

一个 50 集的文件夹，打开第一集，后面 49 集自动就位，看完不用切窗口找下一集。文件名排序就是播放顺序，给文件名加上 01、02 这种编号，顺序自然对。

第二三层 · 去黑边、拉音量、窗口置顶

画面裁剪： autocrop 在播放开始后自动工作，默认第 4 秒检测一次，避开开头淡入的黑屏。流程是先采样约 1 秒画面找出黑边，把结果写入 video-crop 属性，再移除检测滤镜。想手动调，按 C 重新裁剪，再按一次恢复。按的时候尽量停在正常画面上，整屏黑底的标题卡会让结果偏。裁好的结果只写进属性，不改动源文件。裁剪完，黑边消失，画面铺满整个窗口。

窗口置顶： ontop-playback 提供两种模式。手动模式按 T 切换置顶：

改哪里： ~/.config/mpv/input.conf（模板 里就有这条绑定）：

T cycle ontop

改完看到什么： 按一下，视频窗口浮到所有窗口之上。自动模式：先按 T 置顶，之后暂停时自动取消置顶，恢复播放又自动置顶。它监听的是 pause 状态，暂停即取消、恢复即还原。边工作边看教程，不用来回切换窗口，多屏用户还能把视频固定在副屏。这就是最省心的 mpv 窗口置顶。

这两个功能互不干扰：裁剪改画面，压缩改声音，可以同时开。

mpv 音频压缩配置：两个参数拉平音量

解决什么： acompressor 把音量起伏压平，喊叫不炸耳，低语不费劲。

改哪里： 建 ~/.config/mpv/script-opts/acompressor.conf：

default_enable=yes
default_threshold=-25
default_ratio=3

改完看到什么： 播放自动生效，按 n 随时开关。

• threshold：压缩阈值，超过才启动压缩，推荐值 -25
• ratio：压缩比率，越大压得越狠，推荐值 3

从哪先试起

建议从 autoload 开始：丢进脚本目录，五分钟就有自动连播。再顺手把音量压缩加上。三个脚本叠加，连播、画面、音量、窗口各管一段。想折腾，mpv 的 Lua API 支持自定义按键绑定，空间不小。

【免费下载链接】mpv 🎥 Command line media player 项目地址: https://gitcode.com/GitHub_Trending/mp/mpv