OwnTV：Android TV IPTV 播放器

项目简介

OwnTV 是一款原生 Android TV IPTV 播放器，使用 Kotlin 与 Jetpack Compose for TV 编写。它内置两套播放引擎：libmpv（FFmpeg）优先兼容性，ExoPlayer（Media3）追求近乎瞬时的直播切换，并支持自动回退与按频道手动指定引擎。

它只是播放器，本身不提供任何内容：你需要自备 Xtream 登录、M3U 播放列表（URL 或本地文件）或 Stalker/Ministra 门户。项目以 GPLv3 开源，仅面向 Android TV，采用 leanback 启动器，以方向键操作为优先。

主要功能

播放

• 双引擎（mpv / ExoPlayer），自动降级与按频道覆盖
• 4K HDR 直通渲染、可选的自动帧率匹配、环绕声与立体声兜底、150% 音量增强
• 字幕支持文本、图形与隐藏字幕，可搜索 OpenSubtitles 与加载本地文件
• 续播、自动播放下一集、迷你播放器 / 画中画、纯音频模式、直播信息浮层
• 可导出的错误日志，便于排查问题流

浏览

• 首页「继续观看」与 Now Trending（TMDB 排行，并与提供商实际可播放的内容匹配）
• 直播电视、电影、剧集、下载、节目指南，支持收藏、历史、搜索（电视支持时可用语音搜索）
• 同时挂载多个播放列表，分类可重命名、隐藏、排序、合并，支持批量重命名规则
• TMDB 海报、简介、演员与预告片，40 种语言，可承载约 5 万频道 / 约 16.8 万影片
• 电影与剧集提供两种布局：经典三栏，或整屏铺满剧照的 Cinematic 布局

源与 EPG

• Xtream、M3U、Stalker/Ministra，可通过手机扫码 + PIN 经 Wi-Fi 添加
• TV Guide（XMLTV）带实时 Now 标记、多指南源与自动频道匹配
• 回看最多 7 天、直播倒带，即使频道没有节目单也可「回到…」
• 支持 Widevine 与 ClearKey 的受保护（DRM）频道，直接从播放列表读取
• 自定义 DNS（Google、Cloudflare、Quad9、DoH 或自填）

录制与多画面

• 可从节目指南、频道列表或观看中录制，包括某节目的所有场次
• Multiview 最多同时播放四路频道，其中一路出声
• 会探测提供商允许的并发流数量，并在被拒绝前提醒

配置与下载

• 多用户配置，各自独立的收藏、历史与续播点，支持 PIN 锁与儿童模式
• 每个配置可设置启动页：首页、上次频道、节目指南中的上次频道、收藏或指定频道
• 离线下载电影与剧集，支持暂停、续传、重试与存储条

外观与稳定性

• 自定义主色与焦点高亮、可调透明度的磨砂 Glass 效果、三种背景
• 全局深色 / 浅色主题（可跟随电视），播放器同样适用；界面与弹窗字号可分别调整
• 遥控器快捷键：把空闲的颜色键、数字键、频道键与媒体键映射到 26 种操作
• 26 种界面语言、支持 RTL；备份与恢复到单个 .own 文件，可选加密
• 可从另一台设备经局域网复制整机配置，应用内更新

安装与使用

从 最新 Release 下载签名 APK，固定地址：

https://github.com/ahXN00/OwnTV/releases/latest/download/OwnTV.apk

• Fire TV：安装 Downloader（AFTVnews 出品），输入代码 4308278；如提示请开启「来自未知来源的应用」。
• Android TV / Google TV：Downloader 也在 Google Play 上，同样可用上述代码；或用 Send files to TV、USB 盘、adb install OwnTV.apk 侧载。

每个版本提供两个 APK：OwnTV.apk（arm，适用于所有真实电视盒子，也是 Downloader 代码获取的那个）与 OwnTV-x86_64-vX.X.X.apk（模拟器与少见的 Intel 盒子）。

从源码构建（可选）：克隆仓库后在 Android Studio 打开并同步 Gradle，选择 standard（真机与 arm 模拟器）或 x86_64（x86_64 模拟器）变体，最低 Android 8.0 / API 26。命令行可用 ./gradlew assembleDebug。部分代码位于单独的 OwnTV_Core 仓库，Gradle 会从公开 Maven 仓库自动下载，无需账号或令牌。

功能细节与遥控器快捷键见 User Guide。

注意事项

• OwnTV 不附带任何频道、播放列表、订阅或流，你需要对自己添加的来源负责。
• 仅支持 Android TV，采用 leanback 启动器，不适合手机触屏使用（同源的手机版为 OwnTV Mobile）。
• 请只从本仓库的 Releases 页面安装。
• 许可证为 GPL-3.0。

---

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