Kyoo：自托管媒体服务器

项目简介

Kyoo 是一个自托管的媒体服务器，专注于视频内容（电影、剧集和动漫），定位为 Jellyfin 或 Plex 的替代方案。它的核心目标是尽量少维护：不需要整理文件夹结构，也不需要手动编辑元数据。文件命名不规范、所有文件堆在同一个目录、动漫名字很奇怪，都被认为应当开箱即用；如果扫描不正确，那就是 bug。

项目用 TypeScript 编写，采用 GPL-3.0 许可。技术上它被拆分为多个可以独立工作的服务，因此第三方应用可以复用 Kyoo 的组件，写集成或脚本也比较方便。官方提供在线演示 kyoo.zoriya.dev，其中使用的是 Blender Studio 提供的开源影片。

主要功能

• 动态转码：可转码到任意质量，支持 ABR（根据网络状况自动切换画质），也可以使用原始画质。
• 不要求目录结构：不需要预先整理媒体库，命名混乱也能正常扫描入库。
• 视频预览缩略图：鼠标悬停在进度条上即可预览对应画面。
• VLC 播放内核：在 Android 与 Android TV 上，当 exoplayer 无法播放视频或需要显示 ASS 字幕时改用 VLC。
• 片头/片尾检测：通过音频指纹（或章节标题匹配）自动识别片头与片尾。
• 字幕支持：支持 PGS/VODSUB 与 SSA/ASS，并在可用时使用视频内嵌字体，网页和 Chromecast 上同样有效。
• Helm Chart：官方提供 Helm chart，可部署到 Kubernetes 集群（多副本支持仍在开发中）。
• OIDC 登录：可接入任意兼容 OIDC 的服务，例如 Google、Discord、Authelia 等。

目前支持的客户端：Web、Android、Android TV、Chromecast。

安装与使用

README 没有直接给出安装命令，安装与启动、启用 OIDC、硬件转码等内容请参考仓库中的安装文档：

• 安装指南：https://github.com/zoriya/Kyoo/blob/master/INSTALLING.md
• 在线演示：https://kyoo.zoriya.dev
• API 文档（Swagger）：https://kyoo.zoriya.dev/swagger

部署完成后通过 Web 客户端访问即可浏览媒体库，Android 与 Android TV 客户端另有对应的 App。

注意事项

• 项目基本由一位开发者维护，因此目前可用客户端数量有限。
• 观看列表同步（如 SIMKL）以及下载/离线观看功能在 v5 中尚未重新实现，README 中标注为后续提供。
• Kyoo 没有插件系统，官方倾向于把所有功能内置。
• 界面翻译可通过 Weblate 参与补充。
• 项目采用 GPL-3.0 许可证，使用与分发时请留意许可条款。

本作品整理自 GitHub 开源项目 zoriya/Kyoo，原作者 @zoriya，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。