VsTV

面向电视与盒子的直播观看应用 · 遥控器 / 触屏均可操作

GitHub repo size GitHub Repo stars GitHub all releases

VsTV 让你在 智能电视、电视盒子、平板或手机 上收看直播频道：选台、换台、多线路、节目单、收藏、比例与音量等常见需求都可在应用内完成。首次打开即可使用内置默认配置；也可在设置或浏览器访问 http://设备IP:1616 更换直播源与节目单。

公开发布以 Releases 为准：首个下载版本为 1.0.0 起；后续可在应用内检查更新或手动下载新版 APK 覆盖安装（需系统允许安装未知应用）。

仓库与发行文件名常用标识 vstv，与包名、应用展示名一并区分于其他同名产品。

特色功能

性能与体验：精简冗余逻辑与无用代码路径，降低维护面与包体负担，冷启动与日常操作更轻快。
直播源兼容：面向 M3U 等主流 IPTV 订阅，兼容社区常用的稳定列表（如 Mursor、裤佬等相对稳定的公开源思路）；也可在设置或网页中换成你自己的地址。订阅中带 tvg-logo 时，选台列表与信息条会 自动加载台标（Coil 缓存）。
节目单开箱即用：内置 APTV 的 EPG 与 老张的 EPG 两套默认模板；支持 XML 与 gzip（.gz） 拉取，无需手工解压。开启 EPG 后由 WorkManager 在后台按间隔自动刷新缓存（需联网），与「未到设定钟点前不拉取」的规则一致。
老人 / 儿童友好模式：把常看的台加入收藏，在设置中开启 「只看收藏」 后，界面与换台顺序仅保留收藏夹内频道，隐藏其余列表，减少误操作。
在线升级：应用内 检查更新，新版本可直接下载安装，省去 U 盘拷贝（请在系统中允许本应用安装未知来源应用）。

其他亮点（节选）：收藏会固化 播放地址与拉流请求头快照，删除订阅后仍可从收藏直接播放；多线路 失败自动尝试下一条；同网段 网页配置（http://设备IP:1616） 与电视端设置实时同步。

内置与默认（可改）

已内置 默认直播源 与 默认节目单，便于开箱试用；你可在设置中改为自己的订阅地址与 EPG。
内置地址均来自网络公开资源，仅作连通性与功能演示，请遵守当地法律法规与权利人要求。

致谢（资源提供方）

能顺利看直播，离不开下列分享与维护（排名不分先后，逐条鸣谢）：

裤佬（直播列表资源）— 经由 APTV 代理访问，特此感谢
老张的 EPG（节目单数据）— 特此感谢
APTV 的 EPG（节目单数据）— 特此感谢

以及项目演进中参考或受益的开源与社区（见文末「其他致谢」）。

适用环境

设备：国产及常见品牌电视 / 盒子（如 TCL、海信、酷开、华为智慧屏、荣耀、小米电视等），多为厂商定制 Android；部分鸿蒙设备通过 Android 兼容层运行。
网络：不依赖 Google Play 或谷歌账号；常见环境无 GMS，多通过 U 盘、远程推送、网页或文件管理器 安装 APK。
系统要求：Android 5 及以上；实际播放效果依赖设备解码能力与片源质量。

使用本应用时建议了解

说明
在电视桌面出现图标：已同时适配电视与手机类桌面入口
允许 http 明文地址，便于常见 IPTV / 节目单链接
应用内检查更新会从本仓库 Release 拉取与当前安装包类型匹配的 APK
1616 端口提供网页配置页；网页依赖公共 CDN（如 jsDelivr），请确保网络可访问
Android 11+ 需在系统中允许本应用安装未知应用，否则更新或外部 APK 可能无反应
开机自启依赖系统广播；部分品牌需在系统设置中允许自启动 / 后台活动才可能生效

播放协议与地址格式

应用内播放器基于 Media3（ExoPlayer），根据 播放地址的 URL 自动判断类型（Util.inferContentType）。订阅（M3U）里每一行的 频道流地址 若符合下表，一般会走对应协议；若服务端返回的容器与推断不一致，播放器会 在同一 URL 上依次尝试 HLS → DASH → Smooth Streaming → 渐进式，以兼容部分后缀标错的源。

协议	常见后缀 / URL 特征	说明
HLS	`.m3u8`，或路径中含 `m3u8` 等	IPTV 直播最常见
DASH	`.mpd`	MPEG-DASH 清单
Smooth Streaming	`.ism`、`.isml`，或常见 `Manifest` 路径	微软平滑流
RTSP	`rtsp://`	如监控或部分广电 RTSP 源
渐进式（单文件）	无上述特征时的直链，如 `.mp4`、部分 `.mkv` 等	整文件渐进下载播放

解码：使用带 扩展渲染器 的工厂，便于在部分设备上启用 软件解码 兜底（例如部分 H.265/HEVC 场景），实际能否播放仍取决于 片源编码 与 机型硬件/系统。

当前未接入：UDP/RTP 组播（如 udp://）等需独立组播协议栈的地址；应用侧 HTTP(S) 拉流为主。

功能一览

上下换台、数字选台、换台顺序可设置
节目单（当天）、多节目单与历史切换
多订阅源、多线路、失败自动试下一线路
频道收藏
画面比例、播放器相关选项
浏览器网页配置（同网段访问 http://设备IP:1616）
应用内检查更新（常规包）
开机自启（视系统策略）

下载与安装

在 Releases 下载 APK（从 1.0.0 起提供公开构建）。每个版本通常包含两个安装包，请按需选择：

文件	适用说明
`vstv-<版本>-all-sdk21.apk`	默认选择：桌面显示 VsTV，包名 `com.vesaa.mytv`，适合大多数电视 / 盒子 / 手机。
`vstv-<版本>-all-sdk21-HarmonyOS.apk`	华为智慧屏 / 需不同包名时使用：桌面名 Z视介，包名 `com.chinablue.tv`，与上表数据与更新通道不互通，请勿混用升级包。

应用内 检查更新 仅匹配 常规包；若安装的是 HarmonyOS 变体，请自行到 Release 页下载带 HarmonyOS 后缀的包升级。

使用说明（摘要）

遥控器：上下换台，左右切多线路，OK 确认，菜单/帮助/长按 OK 或双击屏幕打开设置等（与常见视频应用习惯接近）。触屏：滑动模拟方向键，点击为确认，长按 / 双击对应长按 OK / 菜单。

设置：在播放界面按上述手势进入；关于位于设置网格最后一项，内含本机 网页配置地址、切换扫码用 IP 与 二维码。

网页配置：浏览器打开 http://<电视IP>:1616，可修改直播源、节目单等（与电视端设置写入同一配置）。

更细的操作项（多源、多线路规则、节目单格式等）与历史版本变更见 CHANGELOG.md。

更新日志

CHANGELOG.md

声明与免责

VsTV（仓库标识 vstv）按 「现状」 提供，作者及贡献者不对因使用本软件造成的任何直接、间接、偶然或后果性损害承担责任，包括但不限于：设备故障、数据丢失、流量费用、版权纠纷、服务中断或内容不合规等。
应用内 默认或内置的直播源、节目单等链接均抓取自互联网公开信息，仅供个人学习、研究与连通性测试；不保证 合法性、稳定性、完整性或持续可用。你必须自行判断 并确保在当地法律允许范围内使用；请勿将内置地址用于任何商业或侵权用途。
播放内容由 第三方地址 提供，本应用 不存储、不二次分发 节目流；不提供 破解、绕权或任何违法内容获取方式。
更换为你自己的订阅地址后，你应对该地址及播放内容承担全部责任。
本声明不排除适用法律规定的强制性责任条款；若你不同意上述内容，请 不要使用 本软件。

其他致谢

以下为对有关开源项目及作者的致谢与参考来源（与「内置资源致谢」区分）。VsTV 本仓库独立维护，与下列项目之间不构成 Git 意义上的上游/下游或自动同步关系；此处仅表达感谢与说明灵感来源。