SubSync 项目使用教程

SubSync 项目使用教程

1. 项目介绍

SubSync 是一个自动下载电影字幕的工具。它通过监视指定的电影文件夹及其子文件夹，自动为新添加的视频文件下载字幕。SubSync 使用视频文件的文件名来确定电影的名称，并在 subscene.com 上搜索并下载最佳匹配的字幕。下载的字幕文件会被重命名为与视频文件相同的名称，以便在 VLC 等播放器中快速识别。

2. 项目快速启动

2.1 下载和安装

首先，从 GitHub 仓库下载 SubSync 的最新版本：

git clone https://github.com/zerratar/SubSync.git
cd SubSync

2.2 编译和运行

使用 Visual Studio 2017 打开 SubSync.sln 文件，并按下 CTRL+SHIFT+B 进行编译。编译完成后，可以通过以下命令运行 SubSync：

SubSync.exe "D:\Movies" -lang swedish;english

2.3 参数说明

• <input folder>: 需要监视的电影文件夹路径。
• -lang <languages>: 字幕语言列表，优先级从左到右。例如 swedish;english。
• -vid <video extensions>: 视频文件扩展名列表，默认为 *avi;*mp4;*mkv;*mpeg;*flv;*webm。
• -sub <subtitle extensions>: 字幕文件扩展名列表，默认为 *srt;*txt;*sub;*idx;*ssa;*ass。
• -delay <ms>: 请求之间的延迟时间（毫秒），默认为 0（无延迟）。
• -resync: 重新下载所有未同步的字幕，无论是否已有字幕文件。
• -resyncall: 重新下载所有字幕，包括已同步的字幕。
• -exit: 同步完成后自动退出 SubSync。

3. 应用案例和最佳实践

3.1 自动字幕下载

假设你有一个存放电影的文件夹 D:\Movies，你可以使用 SubSync 自动为新添加的电影下载字幕。只需运行以下命令：

SubSync.exe "D:\Movies" -lang swedish;english

3.2 批量字幕更新

如果你需要重新下载所有字幕，可以使用 -resyncall 参数：

SubSync.exe "D:\Movies" -lang swedish;english -resyncall

3.3 忽略特定视频

如果你有一些视频不需要下载字幕，可以在 vidignore 文件中添加这些视频的文件名或通配符模式。

4. 典型生态项目

4.1 VLC 播放器

SubSync 可以与 VLC 播放器配合使用，自动为视频文件添加字幕，提升观影体验。

4.2 Plex 媒体服务器

如果你使用 Plex 媒体服务器管理电影库，SubSync 可以帮助你自动为新添加的电影下载字幕，确保所有电影都有字幕可用。

通过以上步骤，你可以轻松使用 SubSync 自动下载和管理电影字幕，提升观影体验。