TVS — TVBox 类空壳聚合播放器（Android TV / iOS / macOS）
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.
下载（最新版 1.2.1）
| 平台 | 下载 | 说明 |
|---|---|---|
| Android / Android TV / 电视盒子 | arm64-v8a APK · armeabi-v7a · x86_64 | 绝大多数设备选 arm64-v8a |
| iOS / iPadOS | 自签名 IPA | 需自行签名侧载（如爱思、巨魔、AltStore、自签 API） |
| macOS（Apple Silicon） | DMG | 首次打开需在「隐私与安全性」中放行 |
加入 TG 群
扫码加入 TG 群，获取使用交流、问题反馈与更新通知。
全部版本见 Releases 页面；最新版 SHA-256 校验值见文末最新版本。 也可以访问下载页：https://yuluoos.github.io/TVBox-tvs/
安装与配置指南（下载页子页面）： iOS / iPadOS 侧载 IPA · 电视盒子 / Android TV 装 APK · macOS 安装 DMG · 羊壳（PeekPro）订阅导入 · 直播源导入（M3U / TXT / JSON）
TVS 是一款基于 Flutter 开发的跨平台（iOS / Android / macOS）聚合播放器，采用羊壳（PeekPro）一类的"空壳"设计：应用本体不内置任何内容、频道或数据源，安装后是一个空壳，所有内容均由用户自行导入订阅配置和直播源后才可用。订阅仅适用于羊壳（PeekPro）格式。应用只提供解析、聚合与播放能力，内容的可用性由用户导入的源决定。
本仓库用于管理 TVS 的打包产物（IPA / APK / DMG），最新版本信息见文末。
有功能建议或使用中遇到问题，欢迎通过 Issues 反馈问题，或到 Discussions 提想法与交流使用经验。
空壳设计说明
- 首次启动无任何内容，需在"订阅"页导入订阅配置；仅支持羊壳（PeekPro）订阅，其他格式的订阅不保证可用。
- 站点、分类、搜索结果、直播频道等全部来自用户导入的源，卸载配置即恢复空壳状态。
- 应用不提供、不推荐、不分发任何内容源，仅作为个人学习与技术研究用途。
功能介绍
订阅与源管理
- 支持导入羊壳（PeekPro）订阅配置，多订阅管理、切换当前生效配置。
- 内嵌本地服务运行爬虫源，完整支持 nodejs 类型 spider 站点。
- 应用前后台切换时自动检测并恢复本地服务，保证长时间使用稳定。
点播（VOD）
- 首页：按当前配置的站点展示分类与推荐列表。
- 聚合搜索：跨站点并发搜索，统一展示结果。
- 详情页：剧集解析与展示，支持多线路 / 多集数结构。
- 解析播放：支持播放地址解析（parse 接口），自动处理嗅探与防盗链请求头。
播放器
- 基于 media_kit（libmpv 内核）的高性能视频播放，支持主流格式与 m3u8 流。
- 片头片尾跳过：按剧集记忆片头 / 片尾跳过秒数，本地持久化。
- m3u8 广告过滤：本地代理层对 m3u8 分片做过滤处理。
- 播放历史与断点续播：自动记录观看进度，随时接续播放。
- 倍速、亮度 / 音量手势调节、播放时屏幕常亮。
直播（Live）
- 支持导入直播源，自动识别 M3U / TXT（#genre# 分组）/ JSON 三种格式。
- 频道分组浏览、台标显示、独立直播播放器。
听剧模式（音频播放）
- 独立音频播放页与全局迷你播放条，可后台播放（audio_service），息屏听剧。
本地代理服务
- 内置本地 HTTP 代理：图片防盗链代理、请求头转发、m3u8 过滤。
TV / 遥控器适配
- 支持 D-pad 遥控器按键导航与焦点管理，适配 Android TV 使用场景。
其他
- 播放历史管理页、设置中心（含各功能项细分设置）。
- 数据本地存储（Isar 数据库 + 安全存储），无云端账号体系，隐私数据不出设备。
技术栈
基于 Flutter 开发，覆盖 iOS / Android / macOS；播放内核为 libmpv（media_kit），数据全部本地存储。
关键词 / Keywords
TVBox、tvbox 类客户端、空壳播放器、聚合播放器、电视盒子应用、Android TV 播放器、ATV apk、TV 版播放器、遥控器 D-pad 适配、羊壳、PeekPro 订阅、直播源播放器、M3U / IPTV 播放器、Flutter 播放器、media_kit、libmpv、nodejs spider 爬虫源、自签名 IPA、iOS 侧载、macOS DMG。
tvbox android-tv iptv-player m3u flutter media-kit libmpv ipa apk dmg self-signed-ipa shell-player
反馈与建议
- 报告 Bug / 提交问题：GitHub Issues（请附上系统版本、应用版本与复现步骤）
- 功能建议 / 使用交流：GitHub Discussions
免责声明
本应用为空壳聚合播放器，不含任何内容与数据源。仅供个人学习、技术研究使用，请在遵守当地法律法规的前提下使用。
最新版本
iOS（IPA）
| 版本 | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|
| 1.2.1 (build 6) | tvs-selfsign-1.2.1.ipa | 30 MB | cffd88c23d566c9320215c404176c3959143dc6c39c926e99720a4dfe120829c |
2026-09-15 |
- IPA 为自签名（selfsign）Release 构建
- 每个发布版本均对应一个 git tag
- 所有产物统一发布在 GitHub Releases，仓库内不再存放二进制文件
Android（APK）
按 ABI 分包，请按设备架构选择；绝大多数手机与电视盒子用 arm64-v8a。
| 版本 | ABI | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|---|
| 1.2.1 (build 6) | arm64-v8a | tvs-1.2.1-arm64-v8a.apk | 30 MB | 66aec2ef0581cb79de5940b1f4b6bbceb38172a7bb560be7c97ab54cc6982ec3 |
2026-09-15 |
| 1.2.1 (build 6) | armeabi-v7a | tvs-1.2.1-armeabi-v7a.apk | 29 MB | fb9bac48e8a8cc76538a0c263c4e8d0b7908d88d5ea6d21d7831355460d0e007 |
2026-09-15 |
| 1.2.1 (build 6) | x86_64 | tvs-1.2.1-x86_64.apk | 32 MB | 5f7f16f5ef59fc2ea64250bc6ff6634330f95bc1c281bb9642e6173b3014a895 |
2026-09-15 |
- 最低支持 Android 7.0（API 24），targetSdk 36
- APK 为 Release 构建，使用调试密钥签名，仅供侧载安装
- nodejs-mobile 上游无 32 位 x86 产物，故不提供 x86 包
- native 库采用压缩打包（
useLegacyPackaging），安装时由系统解压，设备上会额外占用约 80 MB
macOS（DMG）
| 版本 | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|
| 1.2.1 (build 6) | tvs-1.2.1.dmg | 34 MB | e558f1f4248f21713089c446b5d459f1859767d157127d1b8fec7593f09e5541 |
2026-09-15 |
- 仅提供 Apple Silicon（arm64）版本：内置的 Node 运行时上游只有 darwin-arm64 产物，Intel Mac 无法运行爬虫源
- DMG 使用 LZMA（ULMO）压缩，需 macOS 10.15+ 挂载
- 应用为 ad-hoc 自签名，首次打开会被 Gatekeeper 拦截；请在「访达」中右键点击 → 打开，或到「系统设置 → 隐私与安全性」中允许
1.2.1 更新内容
- 听书播放器新增自定义分钟睡眠定时，到时自动停止播放。
- 直播播放期间保持屏幕常亮，减少观看过程中设备自动息屏。
- 直播全屏支持横向滑动切换线路，提升多线路切换效率。
- 优化手机端内容网格与直播频道抽屉，并改善电视端详情页初始焦点。