MeiamSubtitles 是一款专为 Emby 和 Jellyfin 媒体服务器打造的中文字幕下载插件。它集成了 Assrt（伪射手网） 与 迅雷影音 的字幕搜索能力，支持影片名称与视频特征（CID）匹配，帮助您的媒体库便捷地搜索和补全中文字幕。
当前维护两个字幕源：
- Assrt（伪射手网）：按影片名称搜索，支持下载并解析 ZIP、RAR 等压缩字幕；需要配置 Assrt API Token。
- Thunder：根据视频文件计算 CID，优先匹配对应文件的字幕；无需额外配置。
Shooter 的旧版接口已很少返回有效字幕，自 v1.0.16.0 起停止编译、维护和发布。
搬瓦工 $99 年付：建站神器重出江湖，THE PLAN V1 传家宝套餐，18 机房随意切换。
配置：2 核 / 2G / 40G SSD / 1TB 流量 / 2.5Gbps，支持 CN2 GIA 等大陆优化线路。
当前推荐循环优惠码：
BWHNCXNVXV（最高约 6.81%，实际优惠以结账页验证结果为准）
- 同时支持 Emby 和 Jellyfin。
- 支持
zho、chi、zh-CN等中文语言代码。 - 使用异步文件读取计算视频特征，适用于本地及网络媒体库。
- 对搜索结果进行格式校验、去重和排序。
- 下载前校验响应内容，避免将空响应或错误页面保存为字幕。
- Assrt 支持从压缩包中选择并提取
.srt、.ass、.ssa字幕。 - 日志隐藏 Assrt Token，且不记录完整接口响应。
| 插件 | 平台 | 目标框架 | 字幕源 |
|---|---|---|---|
Emby.MeiamSub.Assrt |
Emby（版本限制见下文） | .NET Standard 2.1 | Assrt.net |
Emby.MeiamSub.Thunder |
Emby（版本限制见下文） | .NET Standard 2.1 | Thunder XMP |
Jellyfin.MeiamSub.Assrt |
Jellyfin（版本限制见下文） | .NET 8.0 | Assrt.net |
Jellyfin.MeiamSub.Thunder |
Jellyfin（版本限制见下文） | .NET 8.0 | Thunder XMP |
| 平台 | 兼容版本 |
|---|---|
| Emby | 4.8.10.0 至 4.10.0.40 |
| Jellyfin | 10.10.7 至 12.1 |
- 正式版：版本号末位为
0，例如1.0.18.0。正式版会发布到 GitHub Releases，并同步到 Jellyfin 稳定插件仓库。 - 测试版（Preview）：GitHub 只保留一个滚动更新的“测试版（滚动更新）”，固定使用
preview标签和Emby_preview.zip、Jellyfin_preview.zip两个附件。GitHub 中仍标记为 Pre-release，以区别于稳定发布。 - 每次更新测试版时，插件内部版本末位继续递增，例如
1.0.17.1、1.0.17.2，用于识别用户实际安装的测试批次；旧测试包会被新包替换。 - 测试版不会写入稳定插件仓库，测试用户需要从 GitHub 的
previewRelease 手动下载安装。 - 正式版版本号必须高于同一轮全部测试版。例如
1.0.17.1、1.0.17.2验证完成后发布1.0.18.0。 - 正式版发布后，滚动测试 Release 会转为草稿保留；开始下一轮测试时再更新并重新公开。
推荐通过插件存储库安装，以便接收后续更新。
-
打开 Jellyfin 控制台的“插件 → 存储库”。
-
添加存储库名称
MeiamSub。 -
填写以下地址：
https://github.com/91270/MeiamSubtitles.Release/raw/main/Plugin/manifest-stable.json -
在“目录”中分别安装
MeiamSub.Assrt或MeiamSub.Thunder。 -
重启 Jellyfin。
从 Releases 下载与平台对应的压缩包。
- 解压
Emby_v*.zip。 - 将需要的插件 DLL 放入 Emby 的
plugins目录。 - 不要额外复制
SharpCompress.dll；Assrt 复用 Emby 自带版本。 - 重启 Emby。
- 解压
Jellyfin_v*.zip。 - 将需要的整个插件目录复制到 Jellyfin 的
plugins目录。 - Assrt 目录中的
SharpCompress.dll是 Jellyfin 所需依赖，请勿单独删除。 - 重启 Jellyfin。
- 升级到 v1.0.16.0 或更高版本后，删除旧的 Shooter DLL 和插件目录；Shooter 已停止维护和发布。
- 同一个插件不要同时保留多个版本，否则服务器可能重复加载或启动失败。
- Emby Assrt 只需保留插件 DLL，不要额外复制
SharpCompress.dll。 - Jellyfin Assrt 必须保留发布包中同目录的
SharpCompress.dll。
常见插件目录：
| 环境 | 目录示例 |
|---|---|
| Jellyfin Windows | %LOCALAPPDATA%\jellyfin\plugins |
| Jellyfin Linux | /var/lib/jellyfin/plugins |
| Emby Windows | %APPDATA%\Emby-Server\programdata\plugins |
| Docker | 容器映射的 /config/plugins |
- 从 Assrt 获取 API Token。
- 打开插件配置页，将 Token 填入
Assrt API Token。 - 在媒体库的字幕下载器中启用
MeiamSub.Assrt。
未配置 Token 时，Assrt 会跳过搜索并在日志中给出提示。
Thunder 默认使用视频文件计算 CID。Jellyfin 版本还可在插件设置中启用元数据搜索，用影片名称辅助匹配。
建议先通过“搜索字幕”手动确认匹配效果，再决定是否启用媒体库自动下载。
- 同一媒体库的字幕下载语言只应添加一次。例如只保留一个
zho，重复添加会让服务器发起多次下载请求。 - Emby 与 Jellyfin 如果共用媒体目录，会采用不同的字幕文件命名方式，因此目录中可能同时出现
.zh-CN.*和.zho.*文件。 SearchAllProviders表示同时搜索多个字幕源，不代表下载全部搜索结果。- 自动下载行为由 Emby/Jellyfin 调度；插件只响应服务器发出的搜索与下载请求。
- 确认字幕语言已选择中文，并使用最新版插件。
- Assrt 用户请确认 Token 已填写且有效。
- Thunder 依赖视频文件内容计算 CID，请确认服务器能够读取媒体文件。
- 某些影片或版本可能没有对应资源，可尝试启用元数据搜索或手动选择其他结果。
首先检查媒体库的“字幕下载语言”是否存在重复项。服务器会为每个语言项分别执行一次下载，产生 .0、.1 等后缀。
手动连续下载不同的搜索结果时，服务器也会为避免覆盖已有字幕而添加数字后缀。这属于 Emby/Jellyfin 的文件保存行为，不表示插件正在循环下载。
- Emby：仅安装插件 DLL，不要携带其他版本的
SharpCompress.dll。 - Jellyfin：确保 Assrt 插件目录中包含发布包附带的
SharpCompress.dll。
请在 Issues 中提供：
- Emby/Jellyfin 版本与操作系统；
- 插件名称和版本；
- 媒体文件名、容器格式及问题复现步骤；
- 对应时间段的服务器日志。
提交日志前请删除 Token、媒体路径和其他隐私信息。
欢迎提交 Issue、Pull Request，或者为项目点一个 Star。