quiet-tv
Quiet TV
一个简洁、可自定义的 Android 电视桌面。
常用应用、信号源、壁纸和应用管理，用遥控器轻松操作。
Android 原生界面，无广告、无推荐信息流，无需账号、root 或刷机。
|
常用应用、时间与天气，首页一目了然。 
|
经典布局与艺术画廊，设置实时预览。 
|
|
每日壁纸自动更新，也可上传图片和视频。 
|
自动定位或手动选城，天气来源按需选择。 
|
|
应用分类筛选与详情，集中查看管理。 
|
查看当前版本，一键检查应用更新。 
|
功能
以下为 1.3.1 测试版的核心功能。下载以实时发布索引为准，按电视系统与实际安装包选择适配版本。
| 功能 | 可以做什么 |
|---|---|
| 常用应用与排序 | 首页最多 5 个常用应用；长按移动、添加、替换、隐藏及发起卸载，隐藏应用可在应用管理恢复。 |
| 桌面个性化 | 经典／艺术画廊布局，自定义问候语和头像，各项信息与快捷按钮独立显隐。 |
| 天气 | 自动定位、手动选城和手机扫码选城，首页显示当地天气。 |
| 壁纸 | 默认颜色主题、必应每日壁纸、自定义图片和视频；胶囊下拉设置轮播频率，视频声音开关，手机上传可改名。 |
| 桌面屏保 | 与壁纸共用素材，独立选择屏保、空闲进入时间，以及时间和天气显示。 |
| 文件传输 | 进入自动开启局域网收发，浏览本地与 U 盘，预览并导入壁纸；来源方向键直接切换。 |
| 应用管理 | 分类筛选、应用详情、自定义封面；本机 TCP ADB 连接后，按规则和固件能力提供禁用、重新启用、卸载与恢复安装。 |
| 儿童模式 | 隐藏或锁定应用、设置单次或每日使用时长，家长验证与到时休息提醒。 |
| 应用自启 | 开机或待机唤醒进入 Quiet TV 后启动指定应用，按 HOME 返回不重复启动。 |
| 信号源与桌面配置 | 按本机能力打开输入和系统设置；电脑 AI 配置默认桌面或兼容接管，保留原桌面恢复路径。 |
| 应用内更新 | 检查版本、多源下载、完整性与签名校验，由用户确认安装。 |
| 遥控器与本地使用 | 方向键、确定、返回操作，可选按键音；电脑 AI 可按实际能力逐键校准，无需云端账号。 |
从“全部应用 → 桌面设置”进入“桌面显示／看电视／天气设置／应用管理／儿童模式／文件传输／版本更新／诊断日志”。日常桌面、排序、壁纸、天气和封面设置无需 ADB。首次连接配置、授权、机型适配与开机广告处理由电脑 AI 按需执行；电视端保留已配置的本机 TCP ADB 日常管理，不提供无线配对界面，电脑已连接不代表应用已获授权。详见应用管理。
1.3.1 新增文件传输、独立屏保、顶部轮播频率、手机上传改名和首页长按管理，完善电脑校准与维护；修正壁纸选择、家长验证、儿童计时状态和安装预检，改善视频资源交接与返回桌面黑闪。完整内容见 1.3.1 Release。
应用内更新清单已上线，首页前台每 24 小时自动检查，可在“桌面设置 → 版本更新 → 检查更新”主动查询（1.3.0 入口为“应用管理”，更旧版本为“关于”）。旧版没有更新入口时先手动安装；同版本不会因构建号不同重复提示升级。详见应用内更新。
安装方式
1. 使用 Skill
安装仓库中的电视桌面切换助手，在支持 Skill 和终端操作的 AI 工具中输入：
请用 $quiet-tv-switch 帮我安装 Quiet TV 并切换电视桌面，保留原桌面和恢复方法。
2. 使用安装指令
打开安装指引，复制唯一 AI 指令，交给电脑上的 AI 工具执行。安装、升级、修复共用统一入口，恢复时补充“恢复原桌面”；中断后提供原任务目录继续。页面会自动读取最新版索引，无需填写版本号或随新版本修改指令。
3. 手动安装 APK
从 GitHub Releases 下载适合电视系统和架构的 APK，按安装指南完成安装和桌面设置。
1.3.1 测试版提供安卓 5 及以上通用包（146，最低 API21）和安卓 4.0 至 4.4 统一兼容包（147，最低 API14），均无原生库，无需区分 ARM32／ARM64；按电视系统选包。兼容包不提供标准桌面守护、HOME 代理或标准 TV Input 列表，信号源使用系统设置或实体遥控器。
已安装 1.3.0 标准版或 legacy14 兼容版的用户可检查应用内更新；旧 legacy19 客户端不能自动跨到 legacy14，需从索引手动下载匹配包。安装前核对包名、签名和递增构建号，不卸载、不清数据。
两包同源同签名，构建、Lint、元数据及校验通过，31 项轮播和文件传输单测通过，公开 Validate 检查通过。本批最终 146/147 未进行设备安装，新增功能、覆盖升级数据保留、真实 Android 4.x 运行及厂商真机验收经确认延期；开发阶段模拟器结果不代替本批最终包验收。
安装时保留原桌面；不同厂商的桌面切换能力可能有所不同。
已知兼容性问题与样机验证
更新于 2026-10-29。以下结果适用于记录中的机型、固件与软件版本。
已知问题
| 问题 | 当前情况 | 待验证项 |
|---|---|---|
| 桌面接管 | 创维 E6100（Android 4.4.2）试用模式下，HOME 键仍返回原桌面 | 桌面接管方案、重启、冷启动与待机唤醒 |
| 信号源与菜单键 | 创维 55H6 / 1.3.0 反馈开机先显示信号源、切源异常及菜单键无响应 | 修复后的真机复测 |
| 天气与每日壁纸 | 海信 VIDAA_TV（Android 4.4.2）旧版联网失败，后续已发布兼容修复，见 #68 | 升级后分别复测天气与每日壁纸 |
| ADB 连接 | 部分固件的调试入口或授权受限 | 可用连接方式，以及重启、待机后的连接情况 |
样机验证结果
| 样机与版本 | 已有结果 | 待验证项 |
|---|---|---|
| 酷开／创维 55G20，Android 8，1.2.9 | 用户确认实体 HOME 与重启进入 Quiet TV，见 #35 | 冷启动、待机、信号源和原桌面恢复 |
| 小米盒子 2 增强版，Android 4.4.2，1.2.4 | 用户反馈安装成功、正常使用，见 #81 | 分项功能验收、后续版本升级与 Dock 开关复测 |
| 索尼 BRAVIA VH1，Android 12，历史 1.2.4（64） | 已完成覆盖安装及页面核对 | 完整功能、全部数据保留、实体 HOME、冷启动、重启与待机 |
详细机型、固件和证据见样机记录。可通过机型适配反馈补充脱敏实测结果。
文档与参与
| 我想…… | 查看 |
|---|---|
| 浏览全部文档与目录职责 | 文档索引 |
| 安装桌面、更新 APK 或切回原桌面 | 安装指南 |
| 调整常用应用、壁纸和遥控器操作 | 使用指南 |
| 按需配置桌面或恢复原桌面 | 桌面配置与恢复 |
| 了解机型适配与已验证功能 | 兼容性 · 验收记录 |
| 开发、构建或贡献代码 | 贡献指南 · 版本与安装包规则 |
| 了解安全与仓库设置 | 安全政策 · 贡献指南 |
仓库、文档和测试包下载已公开；提交反馈需要登录 GitHub。
参与开发与维护
欢迎贡献 Android 原生功能、遥控器交互、文档翻译、新机型验证和测试。可以从新人任务或需要帮助的任务开始，先留言认领，再通过 Fork 提交 PR。
贡献指南提供开发环境、检查命令与评审流程；Discussions用于问答、方向讨论和长期维护意愿交流。参与协作请遵守行为准则。
本地构建需要 Git、Python 3、JDK 17、Android SDK platform 36 和 build-tools 36.0.0。先设置 ANDROID_HOME，或在 local.properties 配置自己的 sdk.dir，然后运行：
git clone https://github.com/BeatsAD/quiet-tv.git
cd quiet-tv
./gradlew :app:assembleDebug --console=plain
Debug APK 位于 app/build/outputs/apk/debug/app-debug.apk。构建与离线检查不需要连接电视或准备 device.json；安装到自己的电视时，按安装指南使用 ADB，保留已有配置和备份。正式交付 APK 的归档、签名与版本要求见版本规则。
原生源码位于 app/，公开构建工具位于 scripts/；prototypes/about/ 是 APK 的实际打包输入。设备数据、独立网页演示和宣传视频不随当前源码分发，完整目录说明见文档索引。
致谢与许可
Quiet TV 基于 Gathin23/cleanyourtv 开发，感谢 Gathin 的原始工作。本项目独立维护，与上游及电视、应用品牌方无官方关联。
项目代码采用 MIT 许可证，保留 Gathin 与 Quiet TV 修改者 BeatsAD 的版权、许可条件及免责声明。第三方代码、字体、图标、天气数据和图片视频分别遵循各自许可或服务条款，详见第三方项目与资源说明。
保持联系
