Kc's blog

Appearance

kc_shen2026-06-29
2125
8.5m

Android TV 开源 IPTV 播放器选型指南：M3UAndroid、OwnTV、StreamVault 与 Xtream 说明 ​

面向需要在 Android TV 上让用户自行添加、更换播放源的场景。本文对比三款可直接安装使用的开源播放器，并说明 Xtream Codes 是什么、从哪里获取、如何在 App 中配置。

前言：为什么不是 my-tv？ ​

国内很火的 我的电视（my-tv） 主打「安装即用」，频道由项目维护，用户无法自行换源。若你的需求是：

  • 用户自己粘贴 M3U 链接；
  • 或通过 Xtream 账号登录换源；
  • 无需自建后台；

则应选择通用 IPTV 播放器，而不是内置频道的直播 App。下面三款均满足「用户自助换源 + 无后台 + 可直接装 APK」。

三款播放器总览 ​

项目仓库能否直接用换源方式协议适合谁
M3UAndroidoxyroid/M3UAndroid✅ Release APKM3U URL、XtreamGPL v3想最省心、社区最大
OwnTVahXN00/OwnTV✅ Release APKM3U URL、本地文件、XtreamMIT纯 Android TV、可 Fork
StreamVaultDavidona/StreamVault-IPTV✅ Release APKM3U、Xtream、Stalker、Jellyfin非商业 Source-Available功能最全、个人深度用

三者都是纯客户端：不自带频道，源由用户在设置里配置；也不需要你搭建服务器。

1. M3UAndroid ​

一句话：社区最成熟、最稳妥的默认选择。

  • Stars：1200+（三款中最高）
  • 技术栈：Kotlin + Jetpack Compose + ExoPlayer
  • 平台：Android 手机、平板、Android TV
  • 下载：GitHub Releases

优点 ​

  • 维护时间长，Issue 和教程多
  • 无广告，界面简洁
  • 支持 M3U、Xtream、EPG、分组、收藏、搜索
  • Release 稳定，适合直接给用户用

缺点 ​

  • 协议为 GPL v3：若 Fork 改代码并发布，衍生作品需开源
  • UI 偏通用 Android，不如 OwnTV / StreamVault 那么「TV 专用感」

典型使用流程 ​

  1. 安装 APK
  2. 打开 设置 → 添加播放列表
  3. 粘贴 M3U URL，或填写 Xtream 服务器 + 用户名 + 密码
  4. 可选：添加 EPG（节目单） 地址
  5. 保存后自动加载频道列表

2. OwnTV ​

一句话：专为 Android TV 设计，MIT 协议，最适合二次开发。

  • Stars：约 100+
  • 技术栈：Kotlin + Jetpack Compose for TV + Room
  • 平台：仅 Android TV（Leanback 启动器、D-Pad 优先）
  • 下载：GitHub Releases

优点 ​

  • MIT 许可证：改 UI、改包名、商用相对自由
  • 双播放引擎：直播用 ExoPlayer（秒开），点播/难播流用 libmpv
  • 支持 M3U URL 与本地 .m3u 文件
  • 遥控器导航、焦点体验针对电视优化

缺点 ​

  • 社区规模小于 M3UAndroid
  • 不支持手机端（若需要手机 + TV 同一 App，选 M3UAndroid 或 StreamVault）

典型使用流程 ​

  1. 在 Android TV 上安装 APK
  2. 进入 设置 → 添加源
  3. 选择 M3U（网络或本地文件） 或 Xtream 登录
  4. 浏览分组 → 全屏播放

3. StreamVault ​

一句话：功能最接近「专业 IPTV 客户端」，适合不满足于「能播就行」的用户。

  • Stars：约 400+
  • 技术栈：Kotlin + Jetpack Compose + Room + Media3
  • 平台：Android TV 优先（也支持手机、平板）
  • 下载：GitHub Releases（也可直接下 StreamVault.apk）

优点 ​

  • 源类型最全：M3U、Xtream、Stalker Portal、Jellyfin
  • 高级功能：EPG、DVR 录制、时移、多画面、多源合并
  • 大列表性能、换台速度针对 TV 场景优化
  • 支持应用内检测更新

缺点 ​

  • 许可证为 非商业 Source-Available，禁止商业用途（Fork 做产品前务必阅读 LICENSE）
  • 功能多，上手略复杂
  • 相对更新策略更保守（Release 多为手动触发）

典型使用流程 ​

  1. 安装 APK
  2. 设置 → 添加 Provider（M3U / Xtream / Stalker / Jellyfin）
  3. 可添加多个源，在 Provider 之间切换
  4. 可选配置 EPG、录制、多画面等

横向对比 ​

功能 ​

功能M3UAndroidOwnTVStreamVault
M3U URL✅✅✅
本地 M3U 文件✅✅✅
Xtream Codes✅✅✅
EPG 节目单✅✅✅
Stalker Portal❌❌✅
Jellyfin❌❌✅
DVR / 时移❌❌✅
多源 / 多 Provider基础基础✅ 强
仅 Android TV❌✅TV 优先

直接使用 vs 二次开发 ​

维度M3UAndroidOwnTVStreamVault
直接装 APK 用✅✅✅
Fork 改品牌⚠️ GPL 需开源✅ MIT 推荐⚠️ 非商业
社区与文档⭐⭐⭐⭐⭐⭐⭐

怎么选？ ​

只想最快用起来、给用户换源     → M3UAndroid
要做自己的 TV App（mytv）      → OwnTV
要录播、多源、Stalker 等高级功能 → StreamVault

安装方式（三款通用） ​

方法一：U 盘 ​

  1. 在电脑上下载对应 Release 的 .apk
  2. 拷贝到 U 盘根目录
  3. U 盘插入电视/盒子
  4. 用文件管理器打开 APK 安装（需在设置中允许「未知来源」）

方法二：ADB ​

bash
adb connect <电视IP>:5555
adb install M3UAndroid.apk

方法三：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 账号只能由内容/服务提供方给你，常见来源：

  1. 购买的 IPTV 订阅
    订阅后，商家在邮件、后台或客服处提供 Server、Username、Password。

  2. 自建 Xtream 面板
    若你自己部署了 Xtream UI、XUI One 等，在面板里创建用户即可得到账号。

  3. 同一服务商往往同时提供 M3U 和 Xtream
    很多套餐会发两种形式，内容通常是同一套源，任选 App 支持的一种即可。

重要：开源播放器（包括上述三款）只负责播放，不提供、也不应提供任何 Xtream 账号或频道源。GitHub 上找不到「官方免费 Xtream」。

M3U 与 Xtream 的关系 ​

M3UXtream
形态一条 .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？ ​

以通用流程为例（三款类似）：

  1. 打开 App → 设置 / Settings
  2. 选择 添加 Provider / 添加源 / Xtream Codes
  3. 填写 Server URL、Username、Password
  4. 保存 → 等待同步频道、电影、剧集
  5. 若同步失败：检查地址是否带端口、账号是否过期、网络是否可达

没有 Xtream 怎么办？ ​

情况做法
只有 M3U 链接使用「添加 M3U / Playlist」
什么都没有需合法授权源，或自建 M3U
仅想测试播放器用测试 M3U（见下）

测试用 M3U 示例（仅验证播放器能否工作，不保证长期有效）：

m3u
#EXTM3U
#EXTINF:-1,Test Stream
https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8

将上述内容保存为 test.m3u，在 OwnTV 中选本地文件导入，或在支持 URL 的 App 中托管后填入链接。

合规与风险提示 ​

  1. 版权：公开流传的 IPTV 源可能涉及未授权内容，请仅使用合法授权或自有源。
  2. 安全：勿使用来源不明的「免费 Xtream 账号」，存在泄露隐私、恶意重定向风险。
  3. 稳定性：第三方源可能随时失效，App 无法保证频道长期可用。
  4. 许可证：Fork 开源项目前请阅读 LICENSE（M3UAndroid 为 GPL，StreamVault 限制商业用途，OwnTV 为 MIT）。

结语 ​

若你的目标是 Android TV + 用户自己换源 + 无后台：

Xtream 是服务商给的登录方式，不是独立软件；有 M3U 用 M3U，有 Xtream 用 Xtream，两者往往指向同一套内容。播放器只解决「怎么播」，源仍需用户或运营方自行解决。

参考链接 ​

文档版本：2026-06 · 适用于 mytv 项目选型记录

最近更新