Jellyfin Bangumi插件配置指南：轻松管理中文动画元数据

还在为Jellyfin中的动画元数据不完整而烦恼吗？Jellyfin Bangumi插件是专为中文用户设计的解决方案，能够自动从Bangumi获取高质量的中文动画元数据，并实现播放进度与Bangumi账号的完美同步。

【免费下载链接】jellyfin-plugin-bangumibgm.tv plugin for jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-bangumi

前置准备

在开始配置前，请确保满足以下条件：

• Jellyfin版本：建议使用Jellyfin 10.8.x及以上版本
• Bangumi账号：需要拥有Bangumi番组计划账号
• 网络要求：Jellyfin服务器需要能够访问Bangumi API

安装方法

插件库安装（推荐方式）

1. 打开Jellyfin控制台，进入插件管理页面
2. 添加插件存储库，输入官方插件库地址
3. 在插件目录中找到"Bangumi"插件并点击安装
4. 重启Jellyfin服务完成安装

手动安装方案

1. 从项目仓库下载最新插件DLL文件
2. 将文件放入Jellyfin数据目录的Plugins/Bangumi文件夹
3. 重启Jellyfin服务使插件生效

核心配置步骤

Bangumi OAuth认证配置

1. 进入Jellyfin控制台，选择插件菜单中的Bangumi
2. 点击"授权登录Bangumi"按钮开始认证流程
3. 系统会自动跳转到Bangumi授权页面
4. 登录您的Bangumi账号并完成授权
5. 授权成功后返回Jellyfin即可完成账号绑定

元数据抓取设置

• 标题翻译：可选择优先使用中文翻译或日文原名
• 人物名称：支持中日文名称切换显示
• 季度命名：使用Bangumi词条作为季名称
• 剧集解析：提供基础解析器和高级解析器选项

主要功能特性

播放进度自动同步

开启"同步播放进度到Bangumi"功能后，您在Jellyfin中观看的每一集动画都会自动同步到Bangumi收藏状态。主要支持以下功能：

• 实时播放进度上报
• 手动状态变更同步
• 内容过滤选项

高质量元数据匹配

插件提供完整的动画元数据支持：

• 中文标题和详细简介
• 精确的演职员信息
• 动画评分和用户标签
• 高清海报和背景图片

常见问题解决方案

认证失败处理

如果遇到OAuth认证失败问题，请检查：

1. 网络连接是否正常
2. Jellyfin服务器时间是否准确
3. 尝试重新授权或手动填写Token

元数据匹配技巧

• 确保文件名包含准确的动画名称
• 对于多季动画，建议按季分文件夹存放
• 使用高级解析器可提高识别准确率

同步问题排查

如果播放进度未正常同步：

1. 检查"同步播放进度"选项是否开启
2. 确认Bangumi账号授权状态正常
3. 查看Jellyfin日志获取详细错误信息

高级功能配置

离线数据库使用

插件支持离线数据库功能，可定期自动更新：

• 优先查询离线数据，加快元数据加载速度
• 可设置近期放送剧集使用在线接口
• 支持自动更新评分和元数据信息

网络优化设置

针对不同的网络环境，可进行以下优化：

• 自定义API地址解决访问问题
• 设置请求超时时间缓解网络不稳定
• 配置网络代理确保稳定访问

通过以上完整的配置指南，您的Jellyfin媒体库将获得完善的中文动画元数据支持，同时实现与Bangumi平台的完美同步管理体验。

【免费下载链接】jellyfin-plugin-bangumibgm.tv plugin for jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-bangumi