Orivio TV: A Native SwiftUI Media Player for Apple TV

Key takeaways

Orivio TV is a from-scratch SwiftUI/tvOS port of the Orivio media player for Apple TV HD and Apple TV 4K.
The latest v8.5 GitHub Release provides separate Sideloadly and standalone unsigned arm64 IPAs for tvOS 17+.
Playback combines AVPlayer through KSPlayer with an FFmpeg engine, automatic fallback, embedded subtitles, and a custom Siri Remote interface.
There is no App Store or TestFlight installation listed, so normal users need a sideloading tool and their own Apple ID for re-signing.

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 插件，把结果按插件分组，并显示画质徽章，方便你在自动选择和手动挑选之间切换。

双引擎播放器

适合 Apple 硬件路径的 HLS、MP4、MOV 和 fMP4 会走原生引擎，也就是 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，而不是先打开 Xcode。v8.5 的 Sideloadly IPA 用于更新已有的旁加载版本，独立安装 IPA 则使用自己的 bundle id 与现有安装并存。

# 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 下载后可以直接在 Apple TV 上打开。

如果你正在更新已有的 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 来源和外部字幕仍有缺口。

Project facts

License: GPL-3.0
Platform: tvOS 17+ / Apple TV HD and Apple TV 4K
Written in: Swift, SwiftUI, XcodeGen
Version reviewed: v8.5 (GitHub Release, checked 2026-09-21)
Repository: github.com/prehakanson-art/OrivioTVAppleTV

Install

# 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

License summary

The repository is published under GPL-3.0. Keep the license and notices, and follow the applicable source-disclosure obligations when distributing modified versions. Bundled and vendored dependencies retain their own terms.