TVBox 类空壳聚合播放器 · Flutter 跨平台 · Android TV / 电视盒子 / iOS / iPadOS / macOS · 提供 APK / IPA / DMG 直接下载
A TVBox-style shell media player built with Flutter for Android TV, iOS and macOS — no built-in content, bring your own subscription and live sources.
| 平台 | 下载 | 说明 |
|---|---|---|
| Android / TV（arm64-v8a） | GitHub 原链 · GHFast（第三方加速） · GH-Proxy（第三方加速） | 绝大多数手机与电视盒子 |
| Android / TV（armeabi-v7a） | GitHub 原链 · GHFast（第三方加速） · GH-Proxy（第三方加速） | 按设备架构选择 |
| Android / TV（x86_64） | GitHub 原链 · GHFast（第三方加速） · GH-Proxy（第三方加速） | 按设备架构选择 |
| iOS / iPadOS | 自签名 IPA（GitHub） · GHFast（第三方加速） · GH-Proxy（第三方加速） | 需自行签名侧载（如爱思、巨魔、AltStore、自签 API） |
| macOS（Apple Silicon） | DMG（GitHub） · GHFast（第三方加速） · GH-Proxy（第三方加速） | 首次打开需在「隐私与安全性」中放行 |
GitHub 下载慢时可尝试表中的第三方加速；速度因地区和运营商而异，失败可切换线路。下载后请核对文末 SHA-256。
扫码加入 TG 群，获取使用交流、问题反馈与更新通知。
全部版本见 Releases 页面；最新版 SHA-256 校验值见文末最新版本。 也可以访问下载页：https://yuluoos.github.io/TVBox-tvs/
安装与配置指南（下载页子页面）： iOS / iPadOS 侧载 IPA · 电视盒子 / Android TV 装 APK · macOS 安装 DMG · 羊壳（PeekPro）订阅导入 · 直播源导入（M3U / TXT / JSON）
TVS 是一款跨平台空壳聚合播放器，支持 Android 手机、Android TV / 电视盒子、iPhone、iPad 和 macOS（Apple Silicon）。在同一个应用中浏览站点、聚合搜索、观看点播与直播，也可以后台听剧、听音乐，或浏览源提供的云盘目录和文件。
应用本体不内置任何内容、频道或数据源。使用前需自行导入羊壳（PeekPro）订阅或直播源；支持通过链接或本地文件导入订阅配置。内容、可用线路及云盘功能取决于导入的源。
本仓库用于管理 TVS 的打包产物（IPA / APK / DMG），最新版本信息见文末。
有功能建议或使用中遇到问题，欢迎通过 Issues 反馈问题，或到 Discussions 提想法与交流使用经验。
- 首次启动无任何内容，需在"订阅"页导入订阅配置；仅支持羊壳（PeekPro）订阅，其他格式的订阅不保证可用。
- 站点、分类、搜索结果、直播频道等全部来自用户导入的源，卸载配置即恢复空壳状态。
- 应用不提供、不推荐、不分发任何内容源，仅作为个人学习与技术研究用途。
- 支持通过链接或本地文件导入羊壳（PeekPro）订阅，多订阅管理与切换。
- 内嵌本地服务运行 Node.js 类型 spider 站点，支持独立悦听音频源。
- 应用前后台切换时检测并恢复本地服务。
- 首页：按当前配置的站点展示分类与推荐列表。
- 聚合搜索：跨站点并发搜索，统一展示结果。
- 详情页：剧集解析与展示，支持多线路 / 多集数结构。
- 解析播放：支持播放地址解析（parse 接口），自动处理嗅探与防盗链请求头。
- 视频播放采用 yl_player 原生播放组件，支持点播与直播；具体媒体格式兼容性取决于设备、平台与源。
- 片头片尾跳过：按剧集记忆片头 / 片尾跳过秒数，本地持久化。
- m3u8 广告过滤：对适用的点播播放列表过滤疑似广告分片，不保证所有源均可过滤。
- 播放历史与断点续播：自动记录观看进度，随时接续播放。
- 支持倍速、画面比例切换、亮度 / 音量手势调节和播放时屏幕常亮。
- 加载与缓冲时显示播放状态和下载速度，全屏轻点空白区域可收起控制层。
- 支持导入直播源，自动识别 M3U / TXT（#genre# 分组）/ JSON 三种格式。
- 频道分组浏览、台标显示、独立直播播放器，支持多线路切换与播放模式选择。
- 支持脚本与 RTMP 直播来源；刷新失败时保留已有频道，并提供错误提示。
- 独立音频播放页与全局迷你播放条，可后台播放（audio_service），息屏听剧。
- 支持音频选集、播放模式切换与小说定时停止；音乐可展示匹配到的封面与歌词。
- 支持浏览源提供的云盘目录、打开媒体文件。
- 支持图片、PDF 与文本文件预览，具体内容由导入的源提供。
- 内置本地 HTTP 代理：图片防盗链代理、请求头转发、m3u8 过滤。
- 支持 D-pad 遥控器按键导航、焦点选择和播放菜单操作，适配 Android TV 与电视盒子。
- 播放历史管理页、设置中心（含各功能项细分设置）。
- 订阅配置与播放记录保存在设备上；在线播放和内容查询需要网络连接。
基于 Flutter（Dart）开发；视频播放使用 yl_player，音频播放使用 just_audio 与 audio_service，源运行依托本地 Node.js 服务，配置与记录使用 Isar 数据库和安全存储。
TVBox、tvbox 类客户端、空壳播放器、聚合播放器、电视盒子应用、Android TV 播放器、ATV apk、TV 版播放器、遥控器 D-pad 适配、羊壳、PeekPro 订阅、直播源播放器、M3U / IPTV 播放器、Flutter 播放器、yl_player、后台听剧、云盘浏览、nodejs spider 爬虫源、自签名 IPA、iOS 侧载、macOS DMG。
tvbox android-tv iptv-player m3u flutter yl-player ipa apk dmg self-signed-ipa shell-player
- 报告 Bug / 提交问题：GitHub Issues（请附上系统版本、应用版本与复现步骤）
- 功能建议 / 使用交流：GitHub Discussions
本应用为空壳聚合播放器，不含任何内容与数据源。仅供个人学习、技术研究使用，请在遵守当地法律法规的前提下使用。
| 版本 | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|
| 1.2.7 (build 12) | tvs-selfsign-1.2.7.ipa | 34 MB | 8820acbe04c0f900e569eef4a9a82b3bfd43be1e0e652fc8bdb6e740411f2cf3 |
2026-11-04 |
- IPA 为自签名（selfsign）Release 构建
- 每个发布版本均对应一个 git tag
- 所有产物统一发布在 GitHub Releases，仓库内不再存放二进制文件
按 ABI 分包，请按设备架构选择；绝大多数手机与电视盒子用 arm64-v8a。
| 版本 | ABI | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|---|
| 1.2.7 (build 10012) | arm64-v8a | tvs-1.2.7-build10012-arm64-v8a.apk | 33 MB | af9cb75fc84c33d36f68fc8e16420ed21549ac2450a8581723d5122a68aed65f |
2026-11-04 |
| 1.2.7 (build 10012) | armeabi-v7a | tvs-1.2.7-build10012-armeabi-v7a.apk | 31 MB | 9ab32d1e85e77b86239ffa418cf003373aba24c16c7280c907a4784ecf2088b2 |
2026-11-04 |
| 1.2.7 (build 10012) | x86_64 | tvs-1.2.7-build10012-x86_64.apk | 34 MB | 592c95b478909ab3568ac6585e838730345f5b5ca7fa6fcfa36d2cddebc2e921 |
2026-11-04 |
- 最低支持 Android 7.0（API 24），targetSdk 36
- APK 为 Release 构建，使用调试密钥签名，仅供侧载安装
- nodejs-mobile 上游无 32 位 x86 产物，故不提供 x86 包
- native 库采用压缩打包（
useLegacyPackaging），安装时由系统解压，设备上会额外占用约 80 MB
| 版本 | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|
| 1.2.7 (build 12) | tvs-1.2.7.dmg | 37 MB | 28652c5b16628d70c4ee1bdff5e35acafc0dd36ea15f32b6d73d97f6b039e1fe |
2026-11-04 |
- 仅提供 Apple Silicon（arm64）版本：内置的 Node 运行时上游只有 darwin-arm64 产物，Intel Mac 无法运行爬虫源
- DMG 使用 LZMA（ULMO）压缩，需 macOS 10.15+ 挂载
- 应用为 ad-hoc 自签名，首次打开会被 Gatekeeper 拦截；请在「访达」中右键点击 → 打开，或到「系统设置 → 隐私与安全性」中允许
- Android 安装包重新打包，提高内部版本号，显示版本仍为 1.2.7；请重新检查更新或下载新安装包。
- 修复退出播放页或切换剧集时可能卡住的问题。听剧准备超时或播放失败后，可重新选择音频；快速切集时，旧请求不会覆盖最新选择。
- 调整底部播放控件的位置，避免被系统安全区域遮挡。视频播放失败后，仍可打开选集、切换线路或调整设置；无法打开 MP4 时会提示检查文件或更换片源。
- 改善 iOS 播放 DASH 视频时的网络中断处理：优先播放已缓冲的内容，短暂中断后可恢复播放。
- 兼容性提示：部分媒体格式、iOS 解码输出和自动码率切换尚未完成全设备验证，播放效果取决于设备和片源。