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 / Android TV / 电视盒子 | arm64-v8a APK · armeabi-v7a · x86_64 | 绝大多数设备选 arm64-v8a |
| iOS / iPadOS | 自签名 IPA | 需自行签名侧载（如爱思、巨魔、AltStore、自签 API） |
| macOS（Apple Silicon） | DMG | 首次打开需在「隐私与安全性」中放行 |
扫码加入 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 站点。
- 应用前后台切换时自动检测并恢复本地服务，保证长时间使用稳定。
- 首页：按当前配置的站点展示分类与推荐列表。
- 聚合搜索：跨站点并发搜索，统一展示结果。
- 详情页：剧集解析与展示，支持多线路 / 多集数结构。
- 解析播放：支持播放地址解析（parse 接口），自动处理嗅探与防盗链请求头。
- 基于 media_kit（libmpv 内核）的高性能视频播放，支持主流格式与 m3u8 流。
- 片头片尾跳过：按剧集记忆片头 / 片尾跳过秒数，本地持久化。
- m3u8 广告过滤：本地代理层对 m3u8 分片做过滤处理。
- 播放历史与断点续播：自动记录观看进度，随时接续播放。
- 倍速、亮度 / 音量手势调节、播放时屏幕常亮。
- 支持导入直播源，自动识别 M3U / TXT（#genre# 分组）/ JSON 三种格式。
- 频道分组浏览、台标显示、独立直播播放器。
- 独立音频播放页与全局迷你播放条，可后台播放（audio_service），息屏听剧。
- 内置本地 HTTP 代理：图片防盗链代理、请求头转发、m3u8 过滤。
- 支持 D-pad 遥控器按键导航与焦点管理，适配 Android TV 使用场景。
- 播放历史管理页、设置中心（含各功能项细分设置）。
- 数据本地存储（Isar 数据库 + 安全存储），无云端账号体系，隐私数据不出设备。
基于 Flutter 开发，覆盖 iOS / Android / macOS；播放内核为 libmpv（media_kit），数据全部本地存储。
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
本应用为空壳聚合播放器，不含任何内容与数据源。仅供个人学习、技术研究使用，请在遵守当地法律法规的前提下使用。
| 版本 | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|
| 1.1.8 (build 3) | tvs-selfsign-1.1.8.ipa | 32 MB | e2d3ad6722815dea9f694488c8dfa2cc9c71fc75e9de61ad689f0cf5f7ad8f50 |
2026-09-02 |
- IPA 为自签名（selfsign）Release 构建
- 每个发布版本均对应一个 git tag
- 所有产物统一发布在 GitHub Releases，仓库内不再存放二进制文件
按 ABI 分包，请按设备架构选择；绝大多数手机与电视盒子用 arm64-v8a。
| 版本 | ABI | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|---|
| 1.1.8 (build 3) | arm64-v8a | tvs-1.1.8-arm64-v8a.apk | 33 MB | 097edecf0c54f68d1667e64f304cec3fa3abb911d7ae1c8a0104dac467f4b9dc |
2026-09-02 |
| 1.1.8 (build 3) | armeabi-v7a | tvs-1.1.8-armeabi-v7a.apk | 32 MB | 2ffeb375ab60955cd93430bb62d3f238730f1f501892c9235baf14ae0d1dc740 |
2026-09-02 |
| 1.1.8 (build 3) | x86_64 | tvs-1.1.8-x86_64.apk | 34 MB | cd2248102248ee8476e58f2b30ba8aa44b3f6646fbd624f3a53f6060e1fcad94 |
2026-09-02 |
- 最低支持 Android 7.0（API 24），targetSdk 36
- APK 为 Release 构建，使用调试密钥签名，仅供侧载安装
- nodejs-mobile 上游无 32 位 x86 产物，故不提供 x86 包
- native 库采用压缩打包（
useLegacyPackaging），安装时由系统解压，设备上会额外占用约 80 MB
| 版本 | 文件 | 大小 | SHA-256 | 打包日期 |
|---|---|---|---|---|
| 1.1.8 (build 3) | tvs-1.1.8.dmg | 41 MB | 984c2bd09037edd13ed2d808e27dd4b5c7c0297aa3abdfd877c74409036ff0e8 |
2026-09-02 |
- 仅提供 Apple Silicon（arm64）版本：内置的 Node 运行时上游只有 darwin-arm64 产物，Intel Mac 无法运行爬虫源
- DMG 使用 LZMA（ULMO）压缩，需 macOS 10.15+ 挂载
- 应用为 ad-hoc 自签名，首次打开会被 Gatekeeper 拦截；请在「访达」中右键点击 → 打开，或到「系统设置 → 隐私与安全性」中允许
- 播放内核迁移至 FVP 与 just_audio，强化原生硬件解码、会话管理和启动/退出稳定性。
- 优化点播、直播与 HLS 的代理、缓存和清晰度选择，并新增加载流量显示。
- 改善音频后台连续播放、自动切集与有声书上下文保留。
- 完善弹幕来源选择、LogVar 配置及电视端手机输入与遥控器交互。
- 优化深色主题、画面模式和播放器界面细节。