BeatsAD / quiet-tv

# Quiet TV
**一个简洁、可自定义的 Android 电视桌面。**
简体中文 · English
Quiet TV 面向国内 Android 电视的日常使用场景：把常用应用放在首页，用遥控器直接打开，方便地切换信号源、调整壁纸和管理已安装的应用。桌面没有广告和推荐信息流，无需注册账号。采用 Android 原生界面，无需 root 或刷机。
下载测试版 · 安装指南 · 使用指南 · 支持机型 · 已知问题与样机验证
## 界面
**常用应用，打开电视就能找到。**首页保留时钟、日期、常用应用和系统快捷入口。白色焦点框标出当前选中的项目，按下方向键可继续浏览全部应用。
**新增了壁纸功能**：可使用随应用焦点换色的默认主题，固定一张风景图，或开启每 5 分钟切换的壁纸轮播，目前没有做自定义壁纸更换，自由度还没那么高。
以上为 Sony 电视机真实截图，保留当时的界面状态；
## 功能
| 功能 | 可以做什么 |
| --- | --- |
| 常用应用 | 首页最多放 4 个应用，支持添加、替换、移除和排序；更新桌面时保留配置。 |
| 应用管理 | 查看应用名称、包名、版本和状态，按名称搜索、按类型筛选，逐个启用、禁用或卸载。关键系统组件保持只读。 |
| 首次设置 | 两步完成默认桌面设置与可选的预装应用管理；先选择操作，再按需授权。未知固件的系统包保持只读。 |
| 恢复原桌面 | 根据本机记录和已验证的设备能力，切回或启用原桌面；未开放的操作会显示原因。 |
| 信号源与设置 | 从电视实际提供的输入中选择 HDMI、AV 或电视直播，直接进入网络和系统设置。 |
| 壁纸 | 默认主题光晕、固定风景图或自动轮播，支持预览和取消。 |
| 遥控器操作 | 方向键移动、确定打开、返回上一级；回到首页时恢复上次焦点。 |
| 本地使用 | 设置保存在电视上，无需云端账号；应用管理按需连接电视本机 ADB。 |
| 关于与许可 | 首页可查看应用版本、项目与联系二维码；开源许可随包提供，可离线阅读。 |
应用管理入口位于“全部应用”，常用应用和壁纸可直接在电视上调整。系统包操作需要先完成本机 ADB 授权。禁用会保留数据，卸载会删除当前用户的应用数据；符合条件的预装应用可恢复安装，但无法恢复已删除的数据。预装应用卸载／恢复仍待实机验收，详见应用管理说明。
## 技术实现
**实现路径：Codex 编写原生桌面 → 构建 APK → 局域网 ADB 安装 → 设置默认 HOME → 真机调试。** Codex 在电脑上开发，电视运行 APK；无需 root 或刷机，日常使用无需电脑在线。
### 准备条件
| 条件 | 要求 |
| --- | --- |
| 电视 | Android 系统，允许安装 APK 和切换第三方桌面；具体能力取决于固件。 |
| 局域网 | 电脑与电视连接同一路由器，可一台用网线、一台用 Wi-Fi；关闭阻止互访的网络隔离。 |
| 调试权限 | 开启开发者选项及可用的 ADB 调试，在电视上确认电脑授权。 |
| Codex | 已登录、可联网，允许读写项目文件和执行终端命令。 |
| 构建工具 | Git、Python 3、JDK 17 或 21、Android SDK Platform 36、Build Tools 36.0.0、Platform Tools。 |
当前 b24 源码与公开通用测试包均最低要求 Android 6.0；下载包包含 ARM32、ARM64、x86 和 x86_64，具体机型与功能仍待真机验证。设备适配状态见兼容说明。
### 连接电视，读取真实设备能力
**先找到开发者选项。** 常见入口：
- Google TV：设置 → 系统 → 关于 → Android TV 操作系统版本号（Android TV OS build）。
- Android TV：设置 → 设备偏好设置 → 关于 → 版本号（Build）。
选中 **Build／编译版本号**，连续按遥控器确定约 **7 次**，看到开发者模式提示后返回，在“系统”或“设备偏好设置”中进入“开发者选项”。打开总开关（如有）及 USB／ADB 调试。菜单因品牌、固件而异，找不到时按完整型号查询官方说明。参考 Android 官方开启方法。
**再确认网络调试方式：**
| 可用入口 | 操作 |
| --- | --- |
| 网络 ADB／TCP 调试 | 开启后记录实际 IP、端口，在同一局域网连接并授权。 |
| 无线调试／配对码 | 按页面要求在同一 Wi-Fi 网络配对；配对端口与连接端口可能不同。 |
| 只有 USB 调试 | 不保证网络 ADB 可用；按固件说明确认是否支持 USB 数据连接或其他调试方式。 |
IP 通常在“设置 → 网络 → 当前连接详情”查看。连接后运行 `adb devices -l`：`device` 表示已连接，`unauthorized` 表示需在电视授权；`offline` 或无设备时检查网络、地址、端口和调试开关。USB ADB 不要求同一局域网。
连接成功后，让 Codex 读取系统版本、CPU 架构、应用列表和实际默认 HOME，并保存原桌面状态与恢复方法。多设备连接时明确指定目标电视。
### 核心技术
| 功能 | 实现 |
| --- | --- |
| 首页与应用列表 | Java 原生 View、RecyclerView；PackageManager 读取应用并启动。 |
| 遥控与焦点 | 处理方向键，维护行列位置；Canvas 和动画绘制焦点框、卡片缩放。 |
| 壁纸与配置 | 本地图片、渐变光晕、定时轮播；SharedPreferences 保存偏好。 |
| 默认桌面 | Activity 声明 HOME 入口，通过系统选择或固件支持的命令切换。 |
| 应用管理 | 按需授权本机 ADB，核对用户、包状态和保护规则后逐项操作。 |
电脑 ADB 用于开发和安装；Quiet TV 内置 ADB 用于电视端应用管理，两者分别授权。未知固件的系统包保持只读，详见应用管理说明。
### 用 Codex 实施
1. **检查设备**：确认环境、调试连接与电视能力，记录原桌面恢复基线。
2. **开发界面**：提供文字或参考图，先完成首页、四个常用应用、全部应用和遥控导航，再增加壁纸等功能。
3. **构建安装**：执行下方命令生成 APK；核对版本、架构和签名后，按授权安装。连接与安装命令见安装指南。
4. **真机调整**：结合截图、日志和真实遥控器反馈修改，重复构建与安装。
5. **设置并验收**：按授权切换默认 HOME，查询实际组件并按遥控器 HOME 键确认；重启、播放和长期运行分别验证。
 [code] 
Windows 使用 `gradlew.bat`。APK 输出到 `app/build/outputs/apk/debug/app-debug.apk`。升级保持签名一致；先保留原桌面，不处理无关系统应用。构建、安装和真机验收分别记录。
### 可复制的 Codex 提示词