跳至主内容
非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

Kodi

插件仓库​

我们提供两款功能定位略有不同的 Kodi 插件：

  • Jellyfin for Kodi - 此插件将选定媒体库的元数据同步至 Kodi 本地数据库。其优势在于提供近乎原生 Kodi 的本地媒体体验（默认在首页电影/剧集栏目直接展示，响应几乎零延迟等）。但需注意它会完全占用数据库且兼容性有限，若您同时使用本地媒体或其他直接操作数据库的功能，可能引发冲突。若未保持 Kodi 24/7 运行，启动时的同步过程可能耗时稍长（运行时以后台同步为主）。

  • JellyCon - 采用更接近标准 Kodi 流媒体插件的运作模式。需通过"插件→JellyCon"菜单访问媒体，但支持创建首页快捷入口。优势在于无需元数据同步，可轻松切换多个 Jellyfin 服务器或用户。浏览时需实时请求服务器数据（测试中通常仅需 1-2 秒），但彻底避免了数据库同步及维护的等待时间。

安装插件仓库​

推荐通过官方 Kodi Jellyfin 仓库安装插件，既能简化安装流程，也可自动获取最新版本更新。未来开发的 Jellyfin 相关插件也将在此统一发布。

根据设备类型不同，仓库安装方式有所差异，具体如下：

通用设备（电脑/平板）​

  1. 下载 Jellyfin Kodi 仓库 ZIP 文件

    • 保存为 repository.jellyfin.kodi.zip

  2. 安装 Jellyfin 仓库

    • 打开 Kodi，进入设置菜单，选择"插件浏览器"
    • 点击"从 ZIP 文件安装"
      • 若提示需启用"未知来源"，请先至设置中开启后返回
    • 选择刚下载的 ZIP 文件完成安装

嵌入式设备（Android TV、FireTV Stick 及其他电视盒子）​

  1. 打开 Kodi，进入设置菜单，选择"文件管理器"

    • 点击"添加源"
    • 在地址栏输入 https://kodi.jellyfin.org
    • 命名数据源（如"Jellyfin 仓库"）并确认

  2. 返回设置菜单，进入"插件浏览器"

    • 点击"从 ZIP 文件安装"
      • 若提示需启用"未知来源"，请先至设置中开启后返回
    • 选择刚添加的数据源
    • 安装 repository.jellyfin.kodi.zip

Jellyfin for Kodi​

提示

强烈建议同时在 Jellyfin 服务器安装 Kodi Sync Queue 插件， 这将保持媒体库实时更新，无需等待 Kodi 的定期同步。

注意

不支持远程 Kodi 数据库（如 MySQL），必须使用本地 SQLite 数据库（此为默认配置）。

Jellyfin for Kodi 概述​

此插件将选定 Jellyfin 媒体库的元数据同步到本地 Kodi 数据库中。这使得交互体验与使用本地媒体的原生 Kodi 极为相似（媒体默认显示在首页的"电影/电视剧"栏目下，几乎无延迟等）。但这也意味着它会独占数据库且兼容性较差——如果您同时使用本地媒体或其他直接操作数据库的工具，将会产生冲突导致异常。若未保持 Kodi 24/7 运行，启动时的同步过程可能需要额外时间，不过 Kodi 运行期间同步主要在后台进行。

Kodi 数据库中的媒体通过以下方式之一自动与服务器保持同步：

  • 启动同步 - 每次 Kodi 启动时，会通过服务器的 Kodi Sync Queue 插件获取自上次关闭后更新的媒体内容

  • 实时同步 - Kodi 运行期间，当服务器更新媒体项时会通过 WebSocket 连接通知 Kodi 进行更新

安装 Jellyfin for Kodi 插件​

  1. 安装 Jellyfin for Kodi

    • 在 Kodi 中进入"插件浏览器"
    • 选择"从仓库安装"
    • 选择"Kodi Jellyfin Add-ons" → "视频插件"
    • 选中 Jellyfin 插件并安装

  2. 数秒后将出现服务器配置向导

    • 若局域网检测到 Jellyfin 服务器，将自动显示在对话框中
    • 若未检测到服务器，选择"手动添加服务器"并填写信息：
      • 输入服务器名称/IP 地址及端口号（默认 8096）
        • 主机地址示例: 192.168.1.10:8096
      • 若使用 SSL 反向代理，需在"主机"字段填写完整 URL
        • 主机地址示例: https://jellyfin.example.com
      • 注意：若设置了基础路径(baseurl)，需追加在主机地址末尾
        • 主机地址示例: 192.168.0.10:8096/jellyfin
    • 选择用户账户并输入密码，或通过"手动登录"填写凭据

  3. 成功验证后，将提示选择运行模式（插件模式或原生模式），详见下文说明

插件模式​

插件模式通过 Jellyfin 服务器将文件系统的媒体转译给 Kodi。此为插件默认设置，适用于绝大多数场景，支持局域网和互联网（通过反向代理或 VPN）。只要网络带宽充足，Kodi 几乎都能直接播放文件，对 Jellyfin 服务器负载影响极小。

选择"插件"模式后，请继续媒体库同步配置

原生模式​

原生模式绕过 Jellyfin 服务器，直接从文件系统访问媒体文件。该模式需要复杂配置，仅在网络带宽严重受限时可能提升性能（罕见场景）。要求媒体文件必须通过 NFS/Samba 协议对 Kodi 设备可见，因此仅限局域网或 VPN 环境使用。

  1. 在 Kodi 中配置媒体库

    • 跳过初始媒体库选择，需先向 Kodi 添加文件共享
    • 在 Kodi 设置菜单中选择"文件管理器"
    • 点击"添加源"
    • 选择"浏览"→"添加网络位置"
    • 从协议选择框创建 NFS 或 SMB 位置，填写网络共享信息
      • 若使用已挂载共享，请导航至文件系统的挂载点而非网络路径
    • 选择新建的位置并确认
    • 为媒体源命名后确认
    • 前往：插件→Jellyfin→管理媒体库→添加媒体库

  2. 继续执行媒体库同步

  3. 务必配置路径替换规则，将 Jellyfin 服务器路径重写为网络共享的正确路径

媒体库同步​

此界面可选择要同步到Kodi的媒体库。此过程会将媒体元数据复制到本地Kodi数据库，使您能像浏览本地媒体一样浏览媒体库。

选择"全部"或勾选需同步的媒体库后点击确定。元数据同步将自动开始。同步时长取决于媒体库大小、设备性能及服务器连接速度。

未同步的媒体库仍可通过Jellyfin插件菜单访问，这些库将标记为"动态"。

同步出错时，请启用Kodi中Jellyfin插件的调试日志记录。Unix-like系统用户可将Samba的日志级别设为2以检查认证问题。

多用户账户​

Jellyfin for Kodi插件本身不支持多账户。幸运的是，Kodi内置了配置文件功能（详见Kodi维基）。创建配置文件后，需在每个用户配置文件中单独安装Jellyfin插件并完成设置。切换Kodi配置文件时将同步切换Jellyfin用户。如需启动时显示登录界面，请在设置→配置文件中勾选"启动时显示登录屏幕"。

提示

Kodi默认皮肤不支持显示全部Unicode字符，需更改皮肤字体以正常显示。

多客户端使用​

使用多个Kodi客户端时，切勿复制数据库文件（如myvideosXYZ.db, jellyfin.db）来缩短初始同步时间。此举可能导致客户端冲突，且服务器同步流程将无法正常工作。

JellyCon​

JellyCon概述​

JellyCon 的行为更接近标准的 Kodi 流媒体插件。用户主要通过访问 插件 -> JellyCon 菜单来浏览媒体内容，不过根据使用的皮肤主题不同，可以在主菜单添加自定义快捷入口和小部件。由于无需同步所有元数据，它能更轻松地在多个 Jellyfin 服务器或用户之间切换。由于元数据未同步，浏览时需要从服务器请求信息，这可能导致轻微延迟（实测通常仅1-2秒），但用户无需等待数据库同步或维护更新。该插件还兼容其他媒体源，可与其他插件无缝协作。

安装 JellyCon 插件​

  1. 安装 JellyCon 插件

    • 在 Kodi 中导航至 "插件浏览器"
    • 选择 "从仓库安装"
    • 进入 "Kodi Jellyfin 插件集" → "视频插件"
    • 选中 JellyCon 插件并安装

  2. 数秒后将弹出服务器配置界面

    • 如果局域网存在 Jellyfin 服务器，将自动显示在对话框中
    • 从用户列表选择账户，或通过"手动登录"输入用户名/密码

主界面自定义配置​

多数 Kodi 皮肤支持通过自定义节点和小部件调整主菜单。由于不同皮肤的布局和术语存在差异，本节仅提供基础配置指引。

配置示例​

若要在主屏幕添加指向 Jellyfin 媒体库"儿童电影"的快捷入口： 路径：Add-On -> Video Add-On -> JellyCon -> Jellyfin Libraries -> Kid's Movies -> Create menu item to here

除修改主菜单项外，多数皮肤支持小部件功能。小部件可在主屏动态展示媒体内容，例如在选定图片中展示媒体海报。若要在主屏显示所有 Jellyfin 库的最新电影： 路径：Add-On -> Video Add-On -> JellyCon -> Global Lists -> Movies -> Movies - Recently Added (20) -> Use as widget

常用的小部件场景是展示待播剧集的下一集：

  • Add-On -> Video Add-On -> JellyCon -> Jellyfin Libraries -> Anime -> Anime - Next Up (20) -> Use as widget

  • Add-On -> Video Add-On -> JellyCon -> Global Lists -> TV Shows -> TV Shows - Next Up (20) -> Use as widget