OpenSubtitlesDownload.py 技术文档

1. 安装指南

环境要求

• Python 3.6 或更高版本
• zenity（仅适用于GNOME桌面环境）
• kdialog（仅适用于KDE桌面环境）
• 常用的Unix工具：ps、grep（用于GUI自动检测）和wget（用于GNOME下载）

快速安装（适用于GNOME桌面环境的nautilus脚本）

1. 创建nautilus脚本的目录：

   mkdir -p ~/.local/share/nautilus/scripts/
   

2. 进入目录：

   cd ~/.local/share/nautilus/scripts/
   

3. 下载脚本并赋予执行权限：

   wget https://raw.githubusercontent.com/emericg/OpenSubtitlesDownload/master/OpenSubtitlesDownload.py
   chmod u+x OpenSubtitlesDownload.py
   

重要步骤：使用opensubtitles.com账户

• 在opensubtitles.com网站上创建一个账户。
• 使用该账户登录脚本。

2. 项目使用说明

功能概述

• GUI模式：支持GNOME/GTK和KDE/Qt桌面环境。
• CLI模式：适用于自动化操作，支持Linux、macOS和Windows。
• 多语言支持：支持超过60种语言的字幕搜索。
• 多文件支持：可以同时搜索多个视频文件和文件夹的字幕。
• 自动检测视频文件：通过计算唯一的电影哈希值来识别视频文件。
• 自动下载字幕：如果只有一个字幕可用，自动下载；否则，用户可以选择。
• 字幕重命名：下载的字幕文件会自动重命名为与视频文件匹配，并可选择添加语言代码。

使用步骤

1. 右键点击视频文件，选择“OpenSubtitlesDownload.py”。
2. 如果找到多个字幕，选择你想要的字幕。
3. 字幕将自动下载并放置在视频文件旁边。

3. 项目API使用文档

字幕搜索API

• API版本：v6，使用opensubtitles.com的REST API。
• 认证：需要有效的opensubtitles.com账户。
• 搜索方式：通过计算视频文件的唯一哈希值进行精确匹配，若失败则使用文件名进行备份搜索。

API调用示例

• 哈希值计算：用于精确匹配字幕。
• 文件名搜索：作为备份搜索方式。

4. 项目安装方式

安装步骤

1. 确保系统满足环境要求。
2. 按照快速安装指南下载并安装脚本。
3. 使用opensubtitles.com账户登录脚本。

其他安装选项

• 更多安装选项和详细配置，请参考项目wiki。

5. 项目截图

• 启动搜索：右键点击视频文件，启动字幕搜索。
• 多字幕选择：如果找到多个字幕，用户可以选择其中一个。
• 下载字幕：字幕下载只需片刻。
• 享受字幕视频：下载完成后，即可享受带字幕的视频。

6. 贡献者

• FriendlyTroll：REST API移植工作。
• Thiago Alvarenga Lechuga：Windows CLI和文件夹搜索功能。
• jeroenvdw：字幕自动选择和文件名搜索功能。
• Gui13：参数解析工作。
• Tomáš Hnyk：多语言功能。
• Carlos Acedo：原始脚本开发。
• 以及其他众多贡献者。

7. 许可证

OpenSubtitlesDownload.py是自由软件，遵循GNU General Public License v3.0或更高版本。详细信息请参阅LICENSE文件。