Jellyfin 中文字幕插件常见问题解决方案

Jellyfin 中文字幕插件常见问题解决方案

jellyfin-plugin-maxsubtitle 一个 Jellyfin 中文字幕插件（未来可以不局限中文） 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-maxsubtitle

项目基础介绍

Jellyfin 中文字幕插件（jellyfin-plugin-maxsubtitle）是一个开源项目，旨在为 Jellyfin 媒体服务器提供中文字幕支持。该项目的主要编程语言是 C#，同时也包含少量的 Shell 和 HTML 代码。该插件通过调用外部 API 接口来实现字幕的整合和扩展，未来计划支持更多语言的字幕。

新手使用注意事项及解决方案

1. 插件版本与 Jellyfin 版本不匹配

问题描述：新手在安装插件时，可能会遇到插件版本与 Jellyfin 版本不匹配的问题，导致插件无法正常工作。

解决步骤：

1. 检查 Jellyfin 版本：登录 Jellyfin 管理界面，查看当前安装的 Jellyfin 版本。
2. 选择合适的插件版本：根据 Jellyfin 版本选择合适的插件版本。例如，Jellyfin 10.7.x 应使用插件版本 0.x.x，而 Jellyfin 10.8.x 应使用插件版本 2.x.x。
3. 下载并安装插件：从项目仓库中下载对应版本的插件，并按照 Jellyfin 插件安装指南进行安装。

2. API 接口配置错误

问题描述：插件依赖外部 API 接口进行字幕整合，如果 API 接口配置错误，可能导致字幕无法正常下载或显示。

解决步骤：

1. 检查 API 配置：确保在插件配置中正确填写了 API 接口的 URL 和相关参数。
2. 验证 API 可用性：使用浏览器或命令行工具（如 curl）访问 API 接口，确认其返回正确的数据。
3. 更新插件配置：根据 API 返回的数据格式，调整插件配置中的字幕解析逻辑。

3. 网络环境导致的下载问题

问题描述：由于网络环境限制，新手可能无法从默认的镜像源下载插件或字幕文件。

解决步骤：

1. 选择合适的镜像源：根据所在网络环境选择合适的镜像源。例如，中国用户可以选择 https://gitee.com/caryyu/jellyfin-plugin-repo/raw/master/manifest-cn.json，而其他地区用户可以选择 https://github.com/caryyu/jellyfin-plugin-repo/raw/master/manifest-us.json。
2. 配置 Jellyfin 插件仓库：在 Jellyfin 管理界面中，添加选择的镜像源作为插件仓库。
3. 重新下载插件：从新配置的插件仓库中重新下载并安装插件。

通过以上步骤，新手可以更好地理解和使用 Jellyfin 中文字幕插件，解决常见问题，提升使用体验。

jellyfin-plugin-maxsubtitle 一个 Jellyfin 中文字幕插件（未来可以不局限中文） 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-maxsubtitle