diaoulael/subliminal

Subliminal Docker镜像

镜像概述

Subliminal是一款高效的字幕下载工具，该镜像为其官方Docker容器，旨在简化字幕获取流程。它支持多语言字幕检索，可快速匹配视频文件的最佳字幕，适用于个人或开发场景。

核心功能

• 多语言支持：可下载英语、法语等多种语言的字幕
• 双使用方式：提供命令行（CLI）和Python库两种调用方式
• 智能扫描：能扫描指定文件夹内的视频文件，自动识别需补充字幕的内容
• 缓存优化：通过缓存机制提升重复查询效率
• 灵活配置：支持自定义字幕语言、视频年龄筛选等参数

使用场景

1. 个人影视收藏：为本地视频批量补充缺失的字幕
2. 媒体服务器集成：与Plex、Emby等媒体服务器配合，自动添加字幕
3. 开发场景：通过Python库集成到影视处理工具中，实现字幕自动下载功能

配置说明

缓存配置

使用dogpile.cache进行缓存管理，可配置缓存文件路径（如cachefile.dbm）以提升性能。

语言选择

通过指定语言代码（如en代表英语，fra代表法语）选择需要下载的字幕语言。

Docker部署示例

基本命令行使用

下载单个视频的英语字幕：

bash
docker run --rm --name subliminal -v subliminal_cache:/usr/src/cache -v /本地视频路径:/tvshows -it diaoulael/subliminal download -l en /tvshows/你的视频文件.mp4

说明：

• -v subliminal_cache:/usr/src/cache：挂载缓存卷，保存查询缓存
• -v /本地视频路径:/tvshows：将本地视频文件夹映射到容器内的/tvshows目录
• -l en：指定下载英语字幕

批量处理视频文件夹

扫描指定文件夹内两周内的视频并下载英法字幕（需结合Python脚本或容器内批量命令）： 可通过映射视频目录后，在容器内执行批量扫描和下载操作，或使用Python库编写自定义脚本实现更复杂的批量逻辑。