【亲测免费】 GetSubtitles 项目使用教程

1. 项目介绍

GetSubtitles 是一个用于自动下载匹配字幕的 Python 工具。它能够根据视频文件的名称自动搜索并下载最合适的字幕文件。支持多种字幕格式，并且可以通过命令行参数进行高度定制。

2. 项目快速启动

2.1 安装

首先，确保你已经安装了 Python 3。然后使用 pip 安装 getsub：

pip install getsub

2.2 使用

2.2.1 下载单个视频的字幕

getsub "视频文件路径"

例如：

getsub "/path/to/video/Game of Thrones s07e01.mkv"

2.2.2 下载文件夹内所有视频的字幕

getsub "/path/to/video/folder"

例如：

getsub "/path/to/video/folder"

2.3 常用参数

• -h：显示帮助信息
• -p：手动设置字幕下载文件夹
• -q：查询模式，手动选择下载的压缩包
• -s：手动选择压缩包中要解压的字幕
• -o：若视频存在同名字幕，替换已经存在的字幕
• -m：保存原始下载字幕压缩包
• -b：若一个字母压缩包内同时有 ass、srt 类型字幕，保存两种字幕
• -n：查询模式下显示最大候选字幕数
• -d：选择下载器，如 subhd、zimuku、zimuzu
• --plex：在下载完成的字幕名中插入 zh 标识供 Plex 识别为中文字幕
• --debug：显示报错详细信息

3. 应用案例和最佳实践

3.1 自动下载字幕

假设你有一个包含多个视频文件的文件夹，你可以使用以下命令自动下载所有视频的字幕：

getsub "/path/to/video/folder"

3.2 手动选择字幕

如果你对自动下载的字幕不满意，可以使用 -q 参数手动选择字幕压缩包：

getsub "/path/to/video/Game of Thrones s07e01.mkv" -q

3.3 保存原始字幕压缩包

如果你希望保存原始的字幕压缩包，可以使用 -m 参数：

getsub "/path/to/video/Game of Thrones s07e01.mkv" -m

4. 典型生态项目

4.1 Plex 字幕识别

GetSubtitles 支持 --plex 参数，可以在下载完成的字幕名中插入 zh 标识，供 Plex 识别为中文字幕。

4.2 与其他字幕下载工具集成

GetSubtitles 可以与其他字幕下载工具集成，例如与 subhd、zimuku、zimuzu 等字幕网站的 API 结合使用，进一步扩展字幕下载的功能。

通过以上步骤，你可以快速上手并充分利用 GetSubtitles 项目，自动下载匹配的字幕文件。