TVBox-tvs

项目概述

TVS 是一款基于 Flutter 开发的跨平台聚合播放器，覆盖 Android TV、电视盒子、iOS、iPadOS 与 macOS。它采用「空壳」设计，应用本体不内置任何内容、频道或数据源，安装后由用户自行导入订阅配置与直播源后才可使用。应用只提供解析、聚合与播放能力，内容的可用性由用户导入的源决定。

自带播放内核、内容全靠用户导入的跨平台空壳播放器

主要功能

• 订阅管理：导入羊壳（PeekPro）订阅配置，支持多订阅切换当前生效项
• 爬虫源支持：内嵌本地服务运行爬虫源，支持 nodejs 类型 spider 站点
• 聚合搜索：跨站点并发搜索，在统一列表展示结果
• 点播播放：基于 media_kit（libmpv）播放主流格式与 m3u8 流，支持片头片尾跳过与 m3u8 广告过滤
• 直播播放：导入 M3U、TXT 或 JSON 直播源，支持频道分组浏览与台标显示
• 遥控器适配：支持 D-pad 遥控器按键导航与焦点管理，适配 Android TV

适用人群

• 电视用户：希望在 Android TV 或电视盒子上使用聚合播放器的人
• 自备源用户：手中有羊壳订阅或直播源、需要通用播放端的用户
• 多端用户：在手机、平板与 Mac 上都希望使用同一应用的用户

快速上手

1. 从 Releases 页面按设备架构下载对应安装包（APK、IPA 或 DMG）
2. 在设备上完成安装并首次打开应用
3. 进入「订阅」页导入羊壳（PeekPro）格式的订阅配置
4. 如需直播，在直播页导入 M3U、TXT 或 JSON 直播源

核心优势

• 内容自主：应用不绑定任何内容源，订阅与直播源均可自由替换
• 跨端一致：同一套应用覆盖电视、手机与桌面设备
• 本地存储：数据保存在设备本地，无云端账号体系，隐私数据不出设备

系统要求

项目	要求
操作系统	Android 7.0 及以上、iOS、iPadOS、macOS
支持架构	Android 支持 arm64-v8a、armeabi-v7a、x86_64；macOS 为 Apple Silicon

注意事项

• 应用不含任何内容与数据源，需自行导入订阅后才可使用
• 订阅仅适用于羊壳（PeekPro）格式，其他格式不保证可用
• iOS 版为自签名 IPA，需自行签名侧载；macOS 首次打开需在「隐私与安全性」中放行
• 请仅将本应用用于个人学习，并在遵守当地法律法规的前提下使用