Android TV 开源 IPTV 播放器选型指南
# Android TV 开源 IPTV 播放器选型指南：M3UAndroid、OwnTV、StreamVault 与 Xtream 说明
面向需要在 Android TV 上让用户自行添加、更换播放源的场景。本文对比三款可直接安装使用的开源播放器，并说明 Xtream Codes 是什么、从哪里获取、如何在 App 中配置。
# 前言：为什么不是 my-tv？
国内很火的 我的电视（my-tv） (opens new window) 主打「安装即用」，频道由项目维护，用户无法自行换源。若你的需求是：
- 用户自己粘贴 M3U 链接；
- 或通过 Xtream 账号登录换源；
- 无需自建后台；
则应选择通用 IPTV 播放器，而不是内置频道的直播 App。下面三款均满足「用户自助换源 + 无后台 + 可直接装 APK」。
# 三款播放器总览
| 项目 | 仓库 | 能否直接用 | 换源方式 | 协议 | 适合谁 |
|---|---|---|---|---|---|
| M3UAndroid | oxyroid/M3UAndroid (opens new window) | ✅ Release APK | M3U URL、Xtream | GPL v3 | 想最省心、社区最大 |
| OwnTV | ahXN00/OwnTV (opens new window) | ✅ Release APK | M3U URL、本地文件、Xtream | MIT | 纯 Android TV、可 Fork |
| StreamVault | Davidona/StreamVault-IPTV (opens new window) | ✅ Release APK | M3U、Xtream、Stalker、Jellyfin | 非商业 Source-Available | 功能最全、个人深度用 |
三者都是纯客户端：不自带频道，源由用户在设置里配置；也不需要你搭建服务器。
# 1. M3UAndroid
一句话：社区最成熟、最稳妥的默认选择。
- Stars：1200+（三款中最高）
- 技术栈：Kotlin + Jetpack Compose + ExoPlayer
- 平台：Android 手机、平板、Android TV
- 下载：GitHub Releases (opens new window)
# 优点
- 维护时间长，Issue 和教程多
- 无广告，界面简洁
- 支持 M3U、Xtream、EPG、分组、收藏、搜索
- Release 稳定，适合直接给用户用
# 缺点
- 协议为 GPL v3：若 Fork 改代码并发布，衍生作品需开源
- UI 偏通用 Android，不如 OwnTV / StreamVault 那么「TV 专用感」
# 典型使用流程
- 安装 APK
- 打开 设置 → 添加播放列表
- 粘贴 M3U URL，或填写 Xtream 服务器 + 用户名 + 密码
- 可选：添加 EPG（节目单） 地址
- 保存后自动加载频道列表
# 2. OwnTV
一句话：专为 Android TV 设计，MIT 协议，最适合二次开发。
- Stars：约 100+
- 技术栈：Kotlin + Jetpack Compose for TV + Room
- 平台：仅 Android TV（Leanback 启动器、D-Pad 优先）
- 下载：GitHub Releases (opens new window)
# 优点
- MIT 许可证：改 UI、改包名、商用相对自由
- 双播放引擎：直播用 ExoPlayer（秒开），点播/难播流用 libmpv
- 支持 M3U URL 与本地
.m3u文件 - 遥控器导航、焦点体验针对电视优化
# 缺点
- 社区规模小于 M3UAndroid
- 不支持手机端（若需要手机 + TV 同一 App，选 M3UAndroid 或 StreamVault）
# 典型使用流程
- 在 Android TV 上安装 APK
- 进入 设置 → 添加源
- 选择 M3U（网络或本地文件） 或 Xtream 登录
- 浏览分组 → 全屏播放
# 3. StreamVault
一句话：功能最接近「专业 IPTV 客户端」，适合不满足于「能播就行」的用户。
- Stars：约 400+
- 技术栈：Kotlin + Jetpack Compose + Room + Media3
- 平台：Android TV 优先（也支持手机、平板）
- 下载：GitHub Releases (opens new window)（也可直接下 StreamVault.apk (opens new window)）
# 优点
- 源类型最全：M3U、Xtream、Stalker Portal、Jellyfin
- 高级功能：EPG、DVR 录制、时移、多画面、多源合并
- 大列表性能、换台速度针对 TV 场景优化
- 支持应用内检测更新
# 缺点
- 许可证为 非商业 Source-Available，禁止商业用途（Fork 做产品前务必阅读 LICENSE）
- 功能多，上手略复杂
- 相对更新策略更保守（Release 多为手动触发）
# 典型使用流程
- 安装 APK
- 设置 → 添加 Provider（M3U / Xtream / Stalker / Jellyfin）
- 可添加多个源，在 Provider 之间切换
- 可选配置 EPG、录制、多画面等
# 横向对比
# 功能
| 功能 | M3UAndroid | OwnTV | StreamVault |
|---|---|---|---|
| M3U URL | ✅ | ✅ | ✅ |
| 本地 M3U 文件 | ✅ | ✅ | ✅ |
| Xtream Codes | ✅ | ✅ | ✅ |
| EPG 节目单 | ✅ | ✅ | ✅ |
| Stalker Portal | ❌ | ❌ | ✅ |
| Jellyfin | ❌ | ❌ | ✅ |
| DVR / 时移 | ❌ | ❌ | ✅ |
| 多源 / 多 Provider | 基础 | 基础 | ✅ 强 |
| 仅 Android TV | ❌ | ✅ | TV 优先 |
# 直接使用 vs 二次开发
| 维度 | M3UAndroid | OwnTV | StreamVault |
|---|---|---|---|
| 直接装 APK 用 | ✅ | ✅ | ✅ |
| Fork 改品牌 | ⚠️ GPL 需开源 | ✅ MIT 推荐 | ⚠️ 非商业 |
| 社区与文档 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ |
# 怎么选？
只想最快用起来、给用户换源 → M3UAndroid
要做自己的 TV App（mytv） → OwnTV
要录播、多源、Stalker 等高级功能 → StreamVault
2
3
# 安装方式（三款通用）
# 方法一：U 盘
- 在电脑上下载对应 Release 的
.apk - 拷贝到 U 盘根目录
- U 盘插入电视/盒子
- 用文件管理器打开 APK 安装（需在设置中允许「未知来源」）
# 方法二：ADB
adb connect <电视IP>:5555
adb install M3UAndroid.apk
2
# 方法三：Downloader（常见于海外 Android TV 盒子）
在 Downloader 中输入 GitHub Releases 页面 URL，下载并安装 APK。
# Xtream Codes 完全说明
# 它是什么？
Xtream Codes 不是某个 App，也不是从 GitHub 下载的软件，而是 IPTV 行业常用的一套 API / 登录协议。播放器用「服务器地址 + 用户名 + 密码」向服务商拉取：
- 直播频道列表
- 点播（VOD）电影
- 剧集（Series）
- 电子节目单（EPG）等
你在 M3UAndroid、OwnTV、StreamVault 里看到的 Xtream 登录，就是填这三项：
| 字段 | 说明 | 示例 |
|---|---|---|
| Server URL | 服务商提供的入口地址 | http://example.com:8080 |
| Username | 账号 | user123 |
| Password | 密码 | your_password |
# 从哪里获取？
Xtream 账号只能由内容/服务提供方给你，常见来源：
购买的 IPTV 订阅
订阅后，商家在邮件、后台或客服处提供 Server、Username、Password。自建 Xtream 面板
若你自己部署了 Xtream UI、XUI One 等，在面板里创建用户即可得到账号。同一服务商往往同时提供 M3U 和 Xtream
很多套餐会发两种形式，内容通常是同一套源，任选 App 支持的一种即可。
重要：开源播放器（包括上述三款）只负责播放，不提供、也不应提供任何 Xtream 账号或频道源。GitHub 上找不到「官方免费 Xtream」。
# M3U 与 Xtream 的关系
| M3U | Xtream | |
|---|---|---|
| 形态 | 一条 .m3u / .m3u8 链接 | 服务器 + 账号 + 密码 |
| 在 App 里 | 「添加播放列表 URL」 | 「Xtream Codes 登录」 |
| 典型 URL 形态 | https://host/get.php?username=xx&password=xx&type=m3u_plus | 拆成 Server / User / Pass 三项 |
| 适用 | 公开列表、自建 M3U、简单源 | 完整 IPTV 套餐（直播+点播+剧集） |
若服务商只给了 M3U 链接，不必强求 Xtream，在 App 里选「添加 M3U」即可。
# 在 App 里怎么配 Xtream？
以通用流程为例（三款类似）：
- 打开 App → 设置 / Settings
- 选择 添加 Provider / 添加源 / Xtream Codes
- 填写 Server URL、Username、Password
- 保存 → 等待同步频道、电影、剧集
- 若同步失败：检查地址是否带端口、账号是否过期、网络是否可达
# 没有 Xtream 怎么办？
| 情况 | 做法 |
|---|---|
| 只有 M3U 链接 | 使用「添加 M3U / Playlist」 |
| 什么都没有 | 需合法授权源，或自建 M3U |
| 仅想测试播放器 | 用测试 M3U（见下） |
测试用 M3U 示例（仅验证播放器能否工作，不保证长期有效）：
#EXTM3U
#EXTINF:-1,Test Stream
https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8
2
3
将上述内容保存为 test.m3u，在 OwnTV 中选本地文件导入，或在支持 URL 的 App 中托管后填入链接。
# 合规与风险提示
- 版权：公开流传的 IPTV 源可能涉及未授权内容，请仅使用合法授权或自有源。
- 安全：勿使用来源不明的「免费 Xtream 账号」，存在泄露隐私、恶意重定向风险。
- 稳定性：第三方源可能随时失效，App 无法保证频道长期可用。
- 许可证：Fork 开源项目前请阅读 LICENSE（M3UAndroid 为 GPL，StreamVault 限制商业用途，OwnTV 为 MIT）。
# 结语
若你的目标是 Android TV + 用户自己换源 + 无后台：
- 直接给用户用：优先试 M3UAndroid (opens new window)
- Fork 做自己的 mytv：优先基于 OwnTV (opens new window)
- 功能要最全：试 StreamVault (opens new window)
Xtream 是服务商给的登录方式，不是独立软件；有 M3U 用 M3U，有 Xtream 用 Xtream，两者往往指向同一套内容。播放器只解决「怎么播」，源仍需用户或运营方自行解决。
# 参考链接
- M3UAndroid (opens new window)
- OwnTV (opens new window)
- StreamVault IPTV (opens new window)
- iptv-org/awesome-iptv (opens new window)（IPTV 工具与播放器清单）
- 我的电视 my-tv (opens new window)（内置源，不支持用户换源，作对比参考）
文档版本：2026-06 · 适用于 mytv 项目选型记录