批量下载字幕不求人：OpenSubtitlesDownload多文件与文件夹批量处理实战指南

【免费下载链接】OpenSubtitlesDownloadAutomatically find and download the right subtitles for your favorite videos!项目地址: https://gitcode.com/gh_mirrors/op/OpenSubtitlesDownload

看剧、刷片最烦的莫过于字幕文件与视频对不上，音画不同步、翻译错乱、手动搜字幕找半天……其实你完全可以实现批量下载字幕，一次搞定整个文件夹的影片。今天要介绍的 OpenSubtitlesDownload 就是一款专为「自动查找并下载正确字幕」而生的开源工具，它支持单文件、多文件乃至整个文件夹的字幕批量下载，堪称追剧党的效率神器。

OpenSubtitlesDownload 是什么？

OpenSubtitlesDownload 是一个用 Python 编写的小巧工具（当前版本 v6.5），整个程序只有一个核心文件 OpenSubtitlesDownload.py，却能完成字幕搜索、对比、下载、重命名的一整套流程。它的两大亮点是：

• 精确匹配：通过计算视频文件的唯一 hash 值（文件大小 + 首尾 64KB 数据校验和），精准锁定与片源完全对应的字幕，从根源上避免音画不同步问题；
• 全平台可用：既可以在 GNOME/KDE 桌面环境下作为右键菜单脚本使用，也可以使用纯命令行模式，在 NAS、树莓派、Windows、macOS 上轻松跑起来，非常适合自动化批量处理。

此外它支持 60 多种语言的字幕查询，还可以一次查询多种语言，纪录片、电影、剧集通吃。

准备工作：注册账号与克隆项目

使用 OpenSubtitlesDownload 前需要两个前提：

1. 注册 opensubtitles.com 账号：这是硬性要求，脚本通过官方 REST API 搜索和下载字幕，免费账号即可使用（注意：用户名不是邮箱地址，而是注册时设置的用户名）；
2. Python 3.6 及以上版本：以及常见的wget、ps、grep等基础工具。

然后把项目克隆到本地：

git clone https://gitcode.com/gh_mirrors/op/OpenSubtitlesDownload cd OpenSubtitlesDownload

单文件下载：先快速上手

先拿一个视频练手，命令行模式下只需一条命令：

python3 OpenSubtitlesDownload.py --cli -u 你的用户名 -p 你的密码 -l zh movie.mp4

其中-l zh表示下载中文字幕，--cli强制使用命令行界面。工具会自动识别视频、计算 hash、搜索匹配的字幕并下载到视频旁边，整个过程全自动，非常省心。

批量下载字幕实战：多文件与文件夹一次搞定

单文件只是热身，OpenSubtitlesDownload 真正的威力在于批量处理。

方式一：一次传入多个视频文件

直接在命令后面罗列所有文件路径即可，工具会自动为每个视频查找并下载字幕：

python3 OpenSubtitlesDownload.py --cli -u 用户名 -p 密码 -l zh movie1.mp4 movie2.mkv movie3.avi

方式二：直接传入文件夹（重点）

这也是最推荐的方式！在 CLI 模式下传入文件夹路径，工具会递归扫描整个目录树，把子文件夹里的所有视频文件全部找出来处理，无需手动罗列：

python3 OpenSubtitlesDownload.py --cli -u 用户名 -p 密码 -l zh /home/user/Videos/

无论你的影视库层级多深，一条命令就能完成全部字幕的搜索与下载。内部实现上，第一个视频由当前进程处理，其余文件会分发到多个脚本实例并行执行，并在实例间间隔 2 秒启动，以避开 API 的 429 限流（对应源码中的「Instances dispatcher」逻辑，见 OpenSubtitlesDownload.py）。

小提示：GUI 模式下传入文件夹只会扫描顶层文件，想要深入子目录，请使用 CLI 模式。

常用参数组合：把批量处理玩出花

OpenSubtitlesDownload 提供了丰富的参数，组合起来可以满足各种批量场景：

全自动批量下载最佳实践

给整个影视文件夹批量下载中英双语字幕，并自动选择最优字幕：

python3 OpenSubtitlesDownload.py --cli -a -u 用户名 -p 密码 -l zh,en /home/user/Videos/

增量补齐：跳过已有字幕

想给剧集补字幕，又不想重复下载已有的？加上-i参数，工具会检测 srt、ass、ssa 等常见字幕格式，发现已存在就自动跳过：

python3 OpenSubtitlesDownload.py --cli -a -i -u 用户名 -p 密码 -l zh /home/user/TV-Shows/

集中输出 + 语言后缀

把字幕统一存放到指定目录，并在文件名中标注语言，方便多语言管理：

python3 OpenSubtitlesDownload.py --cli -a -o /home/user/Subtitles -x -u 用户名 -p 密码 -l zh,en /home/user/Movies/

批量下载字幕的注意事项

• 免费账号每日限额：非 VIP 账号每天只能下载约 10 条字幕，批量处理大批量片库时留意配额，可分批执行；
• 避免频繁请求：脚本已内置 2 秒间隔的实例调度防止 429 限流，但请勿同时手动运行多个脚本进程；
• 文件命名规范：下载的字幕默认与视频同名且放在同一目录（如movie.mp4→movie.srt），播放器会自动加载；
• 桌面环境集成：GNOME 用户可将脚本配置为 Nautilus 右键菜单，KDE 用户则可使用 desktop-files/OpenSubtitlesDownload-kde.desktop 集成到 Dolphin，右键即批量下载，日常使用更顺滑。

总结

OpenSubtitlesDownload 用极简的方式解决了「字幕难找、字幕不对版、批量处理麻烦」三大痛点。无论是给一部电影补字幕，还是给整个影视库批量补齐中文字幕，一条命令即可搞定。配合-a自动选择、-i增量跳过和文件夹递归扫描，它完全称得上「批量下载字幕不求人」的终极答案。现在就克隆项目，给你的影视库来一次字幕大扫除吧！

【免费下载链接】OpenSubtitlesDownloadAutomatically find and download the right subtitles for your favorite videos!项目地址: https://gitcode.com/gh_mirrors/op/OpenSubtitlesDownload