如何快速为Jellyfin自动添加弹幕？2025年最实用的弹幕插件完整指南
项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-danmu 想让你的Jellyfin媒体中心播放视频时自动显示弹幕吗？Jellyfin弹幕自动下载插件就是你的不二之选！这款免费工具支持B站、腾讯视频、芒果TV等主流平台的弹幕自动抓取，让你轻松打造沉浸式观影体验。无论是番剧、电影还是电视剧，都能一键匹配海量弹幕资源，从此告别手动下载的繁琐步骤。
📌 为什么选择这款弹幕插件？核心功能大揭秘
Jellyfin弹幕插件作为一款专为Jellyfin设计的辅助工具，凭借以下特性脱颖而出：
- 多平台支持：整合B站、腾讯视频、芒果TV等6大主流弹幕源，覆盖90%以上的视频内容
- 全自动操作：新添加影片自动匹配弹幕，旧媒体库可通过计划任务批量扫描
- 双格式输出：同时生成XML和ASS格式弹幕，适配各类播放器需求
- 智能纠错：支持手动搜索修正错误匹配，集号自动对齐技术提升准确率
图：Jellyfin媒体库配置页面中的弹幕插件启用选项（alt文本：Jellyfin媒体库字幕下载设置界面）
🚀 3步完成插件安装：超简单的配置教程
1. 添加插件存储库
打开Jellyfin控制台，依次进入「插件」→「存储库」→「添加」，根据网络环境选择合适的源：
- 国内加速地址：
https://ghfast.top/https://github.com/cxfksword/jellyfin-plugin-danmu/releases/download/manifest/manifest_cn.json - 国外访问地址：
https://github.com/cxfksword/jellyfin-plugin-danmu/releases/download/manifest/manifest.json
无法访问时可直接下载Release包解压到Jellyfin插件目录
2. 启用媒体库弹幕支持
在「控制台」→「媒体库」中选择目标媒体库，下拉至「字幕下载」区域，勾选「Danmu」选项并保存设置。此时系统会自动为新添加的视频匹配弹幕资源。
3. 手动触发弹幕扫描（针对旧媒体）
进入「控制台」→「计划任务」，找到「扫描媒体库匹配弹幕」任务，点击「运行」即可批量处理存量视频。对于电视剧集，需确保季数和集号正确命名以获得最佳匹配效果。
⚙️ 高级配置：打造个性化弹幕体验
开启ASS格式弹幕生成
默认情况下插件仅生成XML格式弹幕，如需ASS格式（支持PotPlayer、IINA等播放器），需在插件配置中手动启用：
- 进入「控制台」→「插件」→「Danmu」配置页
- 勾选「生成ASS格式弹幕」选项
- 设置字体大小、显示时长等个性化参数
手动修正弹幕匹配错误
当系统匹配错误时，可通过视频详情页的「修改字幕」功能手动搜索：
- 电影/单集视频：直接输入关键词或平台ID（如B站BV号）
- 电视剧/动画：确保季数文件夹按规范命名（如"Season 01"）
🎬 支持的播放器与格式对照表
| 弹幕格式 | 推荐播放器 | 平台支持 |
|---|---|---|
| XML | Switchfin | Windows/macOS/Linux |
| XML | 弹弹play | Windows/macOS/Android |
| ASS | PotPlayer | Windows |
| ASS | IINA | macOS |
| ASS | Infuse | Apple生态全平台 |
图：Jellyfin弹幕插件官方标识（alt文本：Jellyfin弹幕自动下载插件logo）
🔧 常见问题解决指南
Q：插件安装后显示未激活怎么办？
A：检查Jellyfin版本是否兼容（需10.9.x/10.10.x），尝试重启服务或重新安装插件
Q：电视剧弹幕匹配错乱如何处理？
A：确保视频文件按"季-集"规范命名（如"S01E05"），通过「媒体库设置」→「元数据管理」刷新元数据
Q：ASS弹幕显示异常？
A：检查字体文件是否缺失，建议安装微软雅黑或思源黑体等常用字体
📝 开发与构建说明
如需自行构建插件，需安装.NET Core SDK 9.0环境，执行以下命令：
git clone https://gitcode.com/gh_mirrors/je/jellyfin-plugin-danmu
cd jellyfin-plugin-danmu
dotnet restore
dotnet publish --configuration=Release Jellyfin.Plugin.Danmu/Jellyfin.Plugin.Danmu.csproj
构建产物位于./Jellyfin.Plugin.Danmu/bin/Release/net9.0/目录，将其复制到Jellyfin的data/plugins/danmu文件夹即可使用。
本项目仅用于学习交流，请勿用于商业用途。如有侵权请联系开发者删除。
通过这款强大的弹幕插件，你的Jellyfin媒体中心将获得媲美主流视频网站的互动体验。现在就动手安装，让观影过程充满更多乐趣与互动吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
