ChineseSubFinder: 自动化中文字幕下载神器

ChineseSubFinder

ChineseSubFinder简介

ChineseSubFinder是一款开源的自动化中文字幕下载工具，专为影视爱好者和家庭影院用户设计。它能够自动搜索并下载匹配的中文字幕，支持多种主流字幕网站和媒体服务器平台，大大简化了字幕获取的过程。

主要特性

ChineseSubFinder具有以下突出特性：

多平台支持：兼容Emby、Jellyfin、Plex、Sonarr、Radarr等主流媒体服务器。
多字幕源：支持shooter、xunlei、arrst、a4k、SubtitleBest等字幕网站。
自动化下载：可以自动检测新增视频并下载匹配字幕。
Docker部署：提供Docker镜像，便于快速部署和管理。
字幕时间轴校正：内置字幕时间轴自动校正功能。
Web界面：提供友好的Web管理界面。
API支持：对外提供HTTP API接口，方便与其他系统集成。

安装部署

ChineseSubFinder支持多种安装方式，以下是常见的部署方法：

Docker部署（推荐）

使用Docker是最简便的部署方式，只需执行以下命令：

docker run -d --name chinesesubfinder \
  -v /path/to/config:/config \
  -v /path/to/media:/media \
  -e PUID=1000 \
  -e PGID=1000 \
  -p 19035:19035 \
  -p 19037:19037 \
  allanpk716/chinesesubfinder

请将/path/to/config和/path/to/media替换为实际的配置目录和媒体目录路径。

Windows部署

从GitHub Releases页面下载最新的Windows版本。
解压缩下载的文件。
运行chinesesubfinder.exe启动程序。

从源码编译

如果您希望自行编译，可以按照以下步骤操作：

克隆项目仓库：

git clone https://github.com/ChineseSubFinder/ChineseSubFinder.git

2. 进入项目目录：

cd ChineseSubFinder

3. 编译前端（需要Node.js环境）：

cd frontend npm install npm run build

4. 编译后端：

cd ../cmd/chinesesubfinder go build -ldflags="-s -w" -o chinesesubfinder


## 使用指南

### 基本配置

1. 首次运行ChineseSubFinder后，访问`http://你的IP:19035`打开Web界面。
2. 在设置页面配置媒体库路径、字幕下载设置等。
3. 配置完成后，ChineseSubFinder将自动开始扫描媒体文件并下载字幕。

### 高级功能

- **字幕时间轴校正**：在设置中启用此功能，可以自动调整字幕时间轴以匹配视频。
- **API使用**：ChineseSubFinder提供HTTP API，可以通过`http://你的IP:19037`访问，详细文档请参考[API文档](https://github.com/ChineseSubFinder/ChineseSubFinder/tree/docs/DesignFile/ApiKey%E8%AE%BE%E8%AE%A1)。
- **传参启动**：支持通过命令行参数启动，适用于特定场景下的快速操作。

## 目录结构要求

为了确保ChineseSubFinder能够正确识别和处理您的媒体文件，建议按照以下结构组织您的电影和电视剧目录：

### 电影目录结构示例

Movies/ ├─ 电影名称 (年份)/ │ ├─ 电影名称 (年份).mp4 │ └─ 电影名称 (年份).chs.ass └─ 另一部电影 (年份)/ ├─ 另一部电影 (年份).mkv └─ 另一部电影 (年份).chs.srt


### 电视剧目录结构示例

TV Shows/ ├─ 剧集名称/ │ ├─ Season 01/ │ │ ├─ 剧集名称 - S01E01.mp4 │ │ ├─ 剧集名称 - S01E01.chs.ass │ │ ├─ 剧集名称 - S01E02.mp4 │ │ └─ 剧集名称 - S01E02.chs.srt │ └─ Season 02/ │ ├─ 剧集名称 - S02E01.mp4 │ └─ 剧集名称 - S02E01.chs.ass └─ 另一部剧集/ └─ Season 01/ ├─ 另一部剧集 - S01E01.mkv └─ 另一部剧集 - S01E01.chs.srt


遵循这些目录结构可以帮助ChineseSubFinder更准确地匹配视频文件和字幕文件。

## 常见问题解答

1. **Q: 为什么有些视频找不到字幕？**
   A: 可能是因为字幕网站没有相应的字幕，或者视频文件名不规范导致匹配失败。请检查文件命名是否符合标准格式。

2. **Q: 如何处理字幕时间轴不同步的问题？**
   A: ChineseSubFinder内置了字幕时间轴校正功能，可以在设置中启用。如果自动校正效果不佳，可以尝试手动调整字幕文件。

3. **Q: 支持哪些字幕格式？**
   A: ChineseSubFinder支持常见的字幕格式，如SRT、ASS、SSA等。建议优先使用SRT格式，兼容性最好。

4. **Q: 如何更新ChineseSubFinder？**
   A: 对于Docker用户，只需拉取最新镜像并重新创建容器即可。Windows用户可以下载最新版本替换原有文件。

5. **Q: 可以手动上传字幕吗？**
   A: 从v0.42.x版本开始，ChineseSubFinder支持通过Web界面手动上传字幕，并可以在线预览字幕效果。

## 未来展望

ChineseSubFinder团队正在持续改进和优化软件功能。未来计划包括：

- 改善字幕匹配算法，提高准确率
- 增加更多字幕源支持
- 优化Web界面，提供更好的用户体验
- 增强与其他媒体管理软件的集成
- 实现更智能的字幕时间轴校正功能

## 贡献与支持

ChineseSubFinder是一个开源项目，欢迎社区贡献。如果您遇到问题或有改进建议，请在GitHub仓库提交Issue或Pull Request。

如果您觉得ChineseSubFinder对您有帮助，可以考虑给项目一个Star⭐️，这是对开发者最好的鼓励！

## 总结

ChineseSubFinder作为一款强大的自动化中文字幕下载工具，极大地简化了影视爱好者获取字幕的过程。它的多平台支持、自动化下载和丰富的功能使其成为家庭影院系统的理想补充。无论您是使用Plex、Emby还是其他媒体服务器，ChineseSubFinder都能为您提供便捷的字幕管理体验。

随着持续的更新和社区的支持，ChineseSubFinder必将为更多用户带来便利，让观影体验更加完美。让我们一起期待ChineseSubFinder的未来发展，共同打造更好的中文字幕生态系统！