Orivio TV：为 Apple TV 打造的原生 SwiftUI 媒体播放器

Apple TV 媒体播放器很容易变成一层遥控器适配：视频能播放就算完成，搜索、焦点、快进和字幕操作都留给用户自己摸索。Orivio TV 选择了另一条路线。它是从零用 SwiftUI 编写的原生 tvOS 播放器，把 Orivio 的电视端体验、Stremio 插件生态和为 Siri Remote 设计的播放控制放进同一个应用。

项目仓库是 OrivioTVAppleTV，它是 Android TV 版 Orivio 的 Apple TV 移植，但不是直接复用 Android 代码。当前核对到的最新版本是 Orivio TV v8.5，许可证是 GPL-3.0。

它能做什么

打开应用后，Home 不是一个静态海报网格。焦点移动到不同卡片时，顶部 hero 会一起切换背景、Logo、IMDb 标记、元数据和简介；下面则是插件提供的目录行，以及可以恢复播放位置的 Continue Watching。这更像为电视设计的内容浏览，而不是把手机列表放大。

Orivio TV 使用 Stremio 插件生态。Cinemeta 默认随应用安装，其他插件可以在 Settings 中粘贴 manifest.json 地址，也可以通过 stremio:// 链接添加。原生 tvOS 搜索会覆盖所有支持搜索的插件目录，而不只是当前屏幕上的一行。

详情页提供全宽背景、Logo、元数据徽章、演员、季和集列表。点击播放后，应用会并行请求可用的 stream 插件，把结果按插件分组并显示画质徽章，方便在自动选择和手动选择之间切换。

双引擎播放

HLS、MP4、MOV 和 fMP4 等适合 Apple 硬件路径的格式，会通过 KSPlayer 的 KSAVPlayer 走原生引擎。对于常见网络视频，这条路径尽量使用 tvOS 的硬件解码和系统播放能力。

MKV、AVI、FLV、TS 等格式则可以交给 KSPlayer 的 FFmpeg 引擎 KSMEPlayer。播放器支持嵌入式文本字幕和 PGS/VobSub 位图字幕；如果原生引擎拒绝某个流，Orivio TV 会自动回退到 FFmpeg，并在控制栏的 via 信息中显示当前引擎。

v8.5 还改进了 Dolby Atmos 输出：在 HDMI 路径上，带有 Atmos 标记的 E-AC-3/AC-3 内容可以直接作为 Dolby MAT 2.0 输出。TrueHD 和 DTS-HD 仍会解码为 PCM，这是 tvOS 的平台限制，不应理解为应用保证所有音频格式都能 bitstream。

为 Siri Remote 设计的操作

播放控制不是把触摸屏按钮缩小后排列在电视上。隐藏控制栏时，在 Siri Remote 触控面上左右滑动会进入类似 Infuse 的预览式拖动：慢速移动更精细，快速滑动会加速，浮动时间气泡会显示目标时间和带正负号的差值。点击确认跳转，Menu 取消，六秒没有继续操作也会自动取消。

控制栏包含播放、下一集、字幕、音频、来源、剧集、倍速和画面比例等入口。进度条获得焦点时会强化缓冲显示；暂停后可以看到标题、演员标签和时钟。左右边缘点击提供十秒跳转，来源和剧集则可以从侧边面板选择。

遥控器操作的重点是每一步都有退路：Menu 会依次取消拖动、关闭面板、退出播放器，Play/Pause 只负责播放状态，向上或向下可以重新显示控制。对经常在长视频中定位的用户来说，这比依赖一组隐藏手势更容易形成习惯。

如何安装

目前没有找到 Orivio TV 的 App Store 或 TestFlight 安装页面；README 说明项目正在为 TestFlight 筹款。因此普通用户应从官方 GitHub Releases 获取 IPA。更新已有旁加载版本时使用 Sideloadly IPA，希望与现有安装并存时使用 独立安装 IPA。

# Open the latest release page:
open https://github.com/prehakanson-art/OrivioTVAppleTV/releases/latest

# Or download one of the v8.5 IPA assets:
open https://github.com/prehakanson-art/OrivioTVAppleTV/releases/download/v8.5/OrivioTV-V8.5.Sideloadly.ipa
open https://github.com/prehakanson-art/OrivioTVAppleTV/releases/download/v8.5/OrivioTV-V8.5.Sideload.ipa

两份 IPA 都是未签名的 arm64 tvOS 构建，目标是 Apple TV HD/4K 和 tvOS 17 或更高版本。Sideloadly、AltStore 或同类工具会在安装时使用你的 Apple ID 重新签名。这不是 App Store 的签名安装，下载 IPA 后还必须经过旁加载工具。

如果你要更新已有的 Orivio 旁加载版本，优先选择 Sideloadly 文件。它保留历史 bundle id，项目说明会尽量保留媒体库、播放进度、插件和 Profile。想让两个版本拥有独立数据时，再选择普通的 Sideload 文件。实际可用性还取决于 Apple ID、旁加载工具和签名有效期。

第一次配置

安装后先在 Settings 添加要使用的插件。最简单的方式是粘贴插件的 manifest.json URL；遇到 stremio:// 深链接时，也可以让 tvOS 交给 Orivio TV 处理。没有插件或没有可解析的 HTTP 来源时，播放器本身不会凭空提供影视目录。

Orivio 账户、Trakt、TMDB 和去广告服务属于可选集成。Provider key 留空时仍可以通过插件浏览和播放；填入密钥后，才会启用相应账户同步、Trakt 功能或 TMDB 丰富信息。v8.5 还修复了 Profile 同步、Real-Debrid token 刷新和 AllDebrid key 校验的一些边界。

需要改代码时再从源码构建

源码构建适合开发者，不是普通用户的首选安装路径。项目需要 Xcode 16 或更高版本、tvOS 平台和 XcodeGen。README 中的密钥模板仍写着 NuvioTV/Secrets.swift，但当前 project.yml 的应用 target 源码目录是 OrivioTV；按当前 checkout 构建时，应把模板复制到实际会被编译的源目录，并确认生成的工程能看到它。

git clone https://github.com/prehakanson-art/OrivioTVAppleTV.git
cd OrivioTVAppleTV
cp Secrets.example.swift OrivioTV/Secrets.swift

xcodegen generate
xcodebuild -project OrivioTV.xcodeproj -scheme OrivioTV \
  -destination 'generic/platform=tvOS Simulator' build

这些 Provider key 都是可选的，Secrets.swift 应保持在 gitignore 保护下。第一次构建还会下载较大的 FFmpegKit 二进制 xcframework；如果 Metal 工具链尚未安装，需要先运行 xcodebuild -downloadComponent MetalToolchain。要装到真实 Apple TV，则在 Xcode 中选择自己的 signing team 和设备。

需要提前知道的限制

tvOS 版本不会处理 torrent 或只有 infoHash 的来源，应用会过滤这类链接；经去广告服务解析成 HTTP 的插件链接才有机会播放。不要把“支持 Stremio 插件”理解为自带 torrent 引擎。

外部字幕插件目前还没有接通 OpenSubtitles 这类完整流程，嵌入式字幕是更可靠的路径。硬件能力、来源响应头、缓存空间和 HDMI 接收器也会影响实际播放；v8.5 把缓存可用空间下限提高到 4 GB，并在来源失败时更快回退，但它仍不是对所有来源的兼容性保证。

项目版本变化很快，本文以 v8.5 Release 为核对基准。Release 页面比 README 中较早的示例文件名更可靠；如果后续版本更换 IPA 名称、bundle id 或安装工具，请以新的 Release 说明为准。

许可证与边界

Orivio TV 的代码使用 GNU GPL-3.0。你可以查看、运行和在许可证允许的范围内修改它，但再分发修改版本时需要遵守 GPL 的许可证、版权和相应源码提供义务。KSPlayer、FFmpegKit、VLCKit、YouTubeKit 等依赖还有各自的许可证，不能因为主仓库是 GPL 就把所有第三方组件当成同一条款。

适合安装吗

如果你有 Apple TV HD 或 4K，愿意使用旁加载工具，并且希望在电视上把 Stremio 插件、复杂格式播放和 Siri Remote 操作整合起来，Orivio TV 值得从 v8.5 Release 开始试用。它的优点是播放器和遥控器体验做得很完整；它的门槛也很明确：没有 App Store 一键安装，IPA 需要你的 Apple ID 重新签名，torrent-only 来源和外部字幕仍有缺口。

# Open the latest GitHub Release:
open https://github.com/prehakanson-art/OrivioTVAppleTV/releases/latest

# Update an existing sideloaded installation with Sideloadly:
open https://github.com/prehakanson-art/OrivioTVAppleTV/releases/download/v8.5/OrivioTV-V8.5.Sideloadly.ipa

# Install the standalone bundle as a separate app:
open https://github.com/prehakanson-art/OrivioTVAppleTV/releases/download/v8.5/OrivioTV-V8.5.Sideload.ipa