Quiet TV
一个简洁、可自定义的 Android 电视桌面。
常用应用、信号源、壁纸和应用管理，用遥控器轻松操作。
Android 原生界面，无广告、无推荐信息流，无需账号、root 或刷机。
## 界面
|
常用应用、时间与天气，首页一目了然。
|
经典布局与艺术画廊，设置实时预览。
|
|
每日壁纸自动更新，也可上传图片和视频。
|
自动定位或手动选城，天气来源按需选择。
|
|
应用分类筛选与详情，集中查看管理。
|
查看当前版本，一键检查应用更新。
|
## 功能
以下为 1.3.1 测试版的核心功能。下载以[实时发布索引](https://beatsad.github.io/quiet-tv/latest.json)为准，按电视系统与实际安装包选择适配版本。
| 功能 | 可以做什么 |
| --- | --- |
| 常用应用与排序 | 首页最多 5 个常用应用；长按移动、添加、替换、隐藏及发起卸载，隐藏应用可在应用管理恢复。 |
| 桌面个性化 | 经典／艺术画廊布局，自定义问候语和头像，各项信息与快捷按钮独立显隐。 |
| 天气 | 自动定位、手动选城和手机扫码选城，首页显示当地天气。 |
| 壁纸 | 默认颜色主题、必应每日壁纸、自定义图片和视频；胶囊下拉设置轮播频率，视频声音开关，手机上传可改名。 |
| 桌面屏保 | 与壁纸共用素材，独立选择屏保、空闲进入时间，以及时间和天气显示。 |
| 文件传输 | 进入自动开启局域网收发，浏览本地与 U 盘，预览并导入壁纸；来源方向键直接切换。 |
| 应用管理 | 分类筛选、应用详情、自定义封面；本机 TCP ADB 连接后，按规则和固件能力提供禁用、重新启用、卸载与恢复安装。 |
| 儿童模式 | 隐藏或锁定应用、设置单次或每日使用时长，家长验证与到时休息提醒。 |
| 应用自启 | 开机或待机唤醒进入 Quiet TV 后启动指定应用，按 HOME 返回不重复启动。 |
| 信号源与桌面配置 | 按本机能力打开输入和系统设置；电脑 AI 配置默认桌面或兼容接管，保留原桌面恢复路径。 |
| 应用内更新 | 检查版本、多源下载、完整性与签名校验，由用户确认安装。 |
| 遥控器与本地使用 | 方向键、确定、返回操作，可选按键音；电脑 AI 可按实际能力逐键校准，无需云端账号。 |
从“全部应用 → 桌面设置”进入“桌面显示／看电视／天气设置／应用管理／儿童模式／文件传输／版本更新／诊断日志”。日常桌面、排序、壁纸、天气和封面设置无需 ADB。首次连接配置、授权、机型适配与开机广告处理由电脑 AI 按需执行；电视端保留已配置的本机 TCP ADB 日常管理，不提供无线配对界面，电脑已连接不代表应用已获授权。详见[应用管理](docs/APP_MANAGEMENT.md)。
1.3.1 新增文件传输、独立屏保、顶部轮播频率、手机上传改名和首页长按管理，完善电脑校准与维护；修正壁纸选择、家长验证、儿童计时状态和安装预检，改善视频资源交接与返回桌面黑闪。完整内容见 [1.3.1 Release](https://github.com/BeatsAD/quiet-tv/releases/tag/v1.3.1)。
应用内更新清单已上线，首页前台每 24 小时自动检查，可在“桌面设置 → 版本更新 → 检查更新”主动查询（1.3.0 入口为“应用管理”，更旧版本为“关于”）。旧版没有更新入口时先手动安装；同版本不会因构建号不同重复提示升级。详见[应用内更新](docs/UPDATES.md)。
## 安装方式
### 1. 使用 Skill
安装仓库中的[电视桌面切换助手](skills/quiet-tv-switch/SKILL.md)，在支持 Skill 和终端操作的 AI 工具中输入：
```text
请用 $quiet-tv-switch 帮我安装 Quiet TV 并切换电视桌面，保留原桌面和恢复方法。
```
### 2. 使用安装指令
打开[安装指引](https://beatsad.github.io/quiet-tv/)，复制唯一 AI 指令，交给电脑上的 AI 工具执行。安装、升级、修复共用[统一入口](docs/AGENT.md)，恢复时补充“恢复原桌面”；中断后提供原任务目录继续。页面会自动读取[最新版索引](https://beatsad.github.io/quiet-tv/latest.json)，无需填写版本号或随新版本修改指令。
### 3. 手动安装 APK
从 [GitHub Releases](https://github.com/BeatsAD/quiet-tv/releases) 下载适合电视系统和架构的 APK，按[安装指南](docs/INSTALL.zh-CN.md)完成安装和桌面设置。
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](https://github.com/BeatsAD/quiet-tv/issues/68#issuecomment-6430967402) | 升级后分别复测天气与每日壁纸 |
| ADB 连接 | 部分固件的调试入口或授权受限 | 可用连接方式，以及重启、待机后的连接情况 |
**样机验证结果**
| 样机与版本 | 已有结果 | 待验证项 |
| --- | --- | --- |
| 酷开／创维 55G20，Android 8，1.2.9 | 用户确认实体 HOME 与重启进入 Quiet TV，见 [#35](https://github.com/BeatsAD/quiet-tv/issues/35#issuecomment-6440081087) | 冷启动、待机、信号源和原桌面恢复 |
| 小米盒子 2 增强版，Android 4.4.2，1.2.4 | 用户反馈安装成功、正常使用，见 [#81](https://github.com/BeatsAD/quiet-tv/issues/81) | 分项功能验收、后续版本升级与 Dock 开关复测 |
| 索尼 BRAVIA VH1，Android 12，历史 1.2.4（64） | 已完成覆盖安装及页面核对 | 完整功能、全部数据保留、实体 HOME、冷启动、重启与待机 |
详细机型、固件和证据见[样机记录](docs/COMPATIBILITY.md#样机验证记录)。可通过[机型适配反馈](https://github.com/BeatsAD/quiet-tv/issues/new?template=device_adaptation.yml)补充脱敏实测结果。
## 文档与参与
| 我想…… | 查看 |
| --- | --- |
| 浏览全部文档与目录职责 | [文档索引](docs/README.md) |
| 安装桌面、更新 APK 或切回原桌面 | [安装指南](docs/INSTALL.zh-CN.md) |
| 调整常用应用、壁纸和遥控器操作 | [使用指南](docs/USAGE.zh-CN.md) |
| 按需配置桌面或恢复原桌面 | [桌面配置与恢复](docs/SETUP.md) |
| 了解机型适配与已验证功能 | [兼容性](docs/COMPATIBILITY.md) · [验收记录](docs/COMPATIBILITY.md) |
| 开发、构建或贡献代码 | [贡献指南](CONTRIBUTING.md) · [版本与安装包规则](docs/VERSIONING.md) |
| 了解安全与仓库设置 | [安全政策](SECURITY.md) · [贡献指南](CONTRIBUTING.md) |
反馈：[Bug](https://github.com/BeatsAD/quiet-tv/issues/new?template=bug_report.yml) · [功能建议](https://github.com/BeatsAD/quiet-tv/issues/new?template=feature_request.yml) · [新机型适配](https://github.com/BeatsAD/quiet-tv/issues/new?template=device_adaptation.yml)
仓库、文档和测试包下载已公开；提交反馈需要登录 GitHub。
## 参与开发与维护
欢迎贡献 Android 原生功能、遥控器交互、文档翻译、新机型验证和测试。可以从[新人任务](https://github.com/BeatsAD/quiet-tv/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22good%20first%20issue%22)或[需要帮助的任务](https://github.com/BeatsAD/quiet-tv/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22help%20wanted%22)开始，先留言认领，再通过 Fork 提交 PR。
[贡献指南](CONTRIBUTING.md)提供开发环境、检查命令与评审流程；[Discussions](https://github.com/BeatsAD/quiet-tv/discussions)用于问答、方向讨论和长期维护意愿交流。参与协作请遵守[行为准则](CODE_OF_CONDUCT.md)。
本地构建需要 Git、Python 3、JDK 17、Android SDK platform 36 和 build-tools 36.0.0。先设置 `ANDROID_HOME`，或在 `local.properties` 配置自己的 `sdk.dir`，然后运行：
```sh
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`；安装到自己的电视时，按[安装指南](docs/INSTALL.zh-CN.md)使用 ADB，保留已有配置和备份。正式交付 APK 的归档、签名与版本要求见[版本规则](docs/VERSIONING.md)。
原生源码位于 `app/`，公开构建工具位于 `scripts/`；`prototypes/about/` 是 APK 的实际打包输入。设备数据、独立网页演示和宣传视频不随当前源码分发，完整目录说明见[文档索引](docs/README.md)。
## 致谢与许可
Quiet TV 基于 [Gathin23/cleanyourtv](https://github.com/Gathin23/cleanyourtv) 开发，感谢 **Gathin** 的原始工作。本项目独立维护，与上游及电视、应用品牌方无官方关联。
项目代码采用 [MIT 许可证](LICENSE)，保留 Gathin 与 Quiet TV 修改者 BeatsAD 的版权、许可条件及免责声明。第三方代码、字体、图标、天气数据和图片视频分别遵循各自许可或服务条款，详见[第三方项目与资源说明](THIRD_PARTY_NOTICES.md)。
## 保持联系
