MPV自动字幕下载工具：让观影更智能的完整配置指南
项目地址: https://gitcode.com/gh_mirrors/mp/mpv-autosub MPV-Autosub 是一款专为 MPV 媒体播放器设计的自动字幕下载脚本，能够智能识别视频文件并自动下载匹配的字幕资源。这款工具支持跨平台使用，无论您使用 Windows、Mac 还是 Linux 系统，都能享受到便捷的字幕下载体验。
项目亮点速览
- 全自动字幕匹配：无需手动操作，打开视频即自动搜索下载
- 多语言字幕支持：涵盖英语、中文、法语等主流语言
- 智能路径管理：可自定义字幕下载的包含和排除路径
- 灵活配置选项：支持字幕提供商登录和多种自定义设置
三步快速安装指南
第一步：环境准备 确保系统中已安装 Python 和 subliminal 工具：
pip install subliminal
第二步：脚本部署 将 autosub.lua 文件复制到 MPV 的脚本目录中：
| 操作系统 | 部署路径 |
|---|---|
| Windows | C:\Users\[用户名]\AppData\Roaming\mpv\scripts\ |
| Mac/Linux | ~/.config/mpv/scripts/ |
第三步：路径配置 在脚本开头设置正确的 subliminal 路径：
local subliminal = '/path/to/your/subliminal'
核心特性深度解析
智能字幕检测机制 MPV-Autosub 采用先进的字幕检测算法，能够准确识别视频文件中是否已存在合适字幕。只有当缺少相应语言的字幕时，才会自动触发下载流程，避免重复下载和资源浪费。
多语言优先级管理 在 autosub.lua 配置中，您可以设置多个备选语言：
local languages = {
{ 'English', 'en', 'eng' },
{ 'Chinese', 'zh', 'chi' },
-- 更多语言选项
}
高级配置选项详解
- 自动下载开关：通过
auto = true/false控制自动下载功能 - 强制下载模式：设置
force = true可覆盖现有字幕文件 - UTF-8 编码支持：确保字幕文件编码兼容性
实用技巧与最佳实践
路径管理策略 利用 excludes 和 includes 列表精确控制字幕下载范围：
local excludes = {
'no-subs-dl', -- 排除包含此字符串的路径
-- '/home/user/Videos', -- 排除特定完整路径
}
快捷键操作技巧
- 按
b键：手动下载首选语言字幕 - 按
n键：手动下载次选语言字幕
常见问题解答
Q：为什么自动下载功能没有生效？ A：请检查视频文件时长是否超过15分钟，以及文件路径是否在排除列表中。
Q：如何添加字幕提供商账号？ A：在 logins 配置段取消注释并填写相应账号信息：
local logins = {
{ '--addic7ed', '用户名', '密码' },
-- 更多提供商支持
}
Q：字幕下载失败怎么办？ A：启用调试模式查看详细日志信息：
local bools = {
debug = true, -- 输出调试信息
}
通过以上配置和使用指南，您可以充分发挥 MPV-Autosub 的自动字幕下载功能，让观影体验更加流畅和便捷。无论是追剧还是观看电影，都能享受到准确匹配的字幕服务。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
