pengchujin/aerial-tv

选用指南

AI 根据 README 整理 · 2026/10/20 19:46:40

适用场景

适用于小米、TCL 等国产电视，希望替换自带广告桌面、获得更简洁美观的桌面体验。

查看 README 依据

<div align="center"> <img src="docs/brand/icon.png" width="96" alt="Aerial 图标"> # Aerial **给国产电视的一块干净桌面。** 参照 tvOS 设计的 Android TV 桌面：没有广告位，没有推荐流，只有你的 App、你选的壁纸，和 Apple TV 式的航拍屏保。 为小米、TCL 等国内电视而做，开机自动接管，不怕被系统清理。 <a href="https://aerial.qust.me"><img alt="官网" src="https://img.shields.io/badge/%E5%AE%98%E7%BD%91-1f6feb?style=for-the-badge&logo=safari&logoColor=white"></a> <a href="https://github.com/pengchujin/aerial-tv/releases/latest"><img alt="下载 APK" src="https://img.shields.io/badge/%E4%B8%8B%E8%BD%BD%20APK-34a853?style=for-the-badge&logo=android&logoColor=white"></a>

使用方式

通过 ADB 安装 APK，支持一键脚本安装或手动安装，也可使用 Agent 自动安装。

查看 README 依据

| **小米 / Redmi**（PatchWall、HyperOS） | 设置 → 账号与安全 → **ADB 调试** 打开；同一页的 **安装未知来源的应用** 也打开 | | **TCL / 雷鸟** | 设置 → 关于 → **本机信息**，进入后在遥控器上依次按 **上、下、左、右**（每次间隔不超过 1 秒），页面底部会出现隐藏的「更多」分组，选中 **ADB** 按确认打开 | | **原生 Android TV / Google TV**、海信等 | 设置 → 设备偏好设置 → 关于 → 连续按 **版本号**（Build）7 次，打开开发者选项；再到 开发者选项 → **USB 调试**（有的叫「网络调试」/「ADB 调试」）打开 | 电脑第一次连接时，电视上会弹出「允许 USB 调试吗？」，选 **允许**（勾上「始终允许」）。 ### 用 Agent 安装（推荐） 把下面这段复制给 Claude Code、Codex、Cursor 之类能在你电脑上运行命令的 Agent，把 `<电视IP>` 换成你的电视 IP： ```text 请帮我把开源电视桌面 Aerial（https://github.com/pengchujin/aerial-tv）安装到我的电视上，并让它成为开机自动启动的桌面。 我的电视 IP 是：<电视IP> 请按这个顺序做：

### 一行命令安装（macOS / Linux） ```bash curl -fsSL https://raw.githubusercontent.com/pengchujin/aerial-tv/main/tools/get.sh | KEEP_ADB=1 TV=192.168.1.20 bash ``` 脚本会做这些事： 1. 下载最新版 APK 并安装。 2. 授予只有 ADB 能给的权限（用途见下表）。 3. 预编译 App，让它在电视上更流畅。 4. 接管桌面和屏保。 5. 放行开机自启。 `KEEP_ADB=1` 表示电视每次关掉 ADB 调试后，Aerial 都会立刻重新打开（小米待机唤醒后会关）。不需要可以去掉。 - **拒绝安装桌面类 App 的固件**：在命令最后加 `-s guard`，改装不声明 HOME 的版本，由桌面守护接管。 - **TCL**：TCL 拒绝一切 ADB 安装，脚本会改用 TCL 自带的「多屏互动」把 APK 推给电视，你只需要在电视上选一次「同意」。没有多屏互动时，会退回用当贝市场的「安装包管理」。 还原成原来的桌面： ```bash

curl -fsSL https://raw.githubusercontent.com/pengchujin/aerial-tv/main/tools/get.sh | TV=192.168.1.20 bash -s restore ``` ### 手动安装 到 [Releases](https://github.com/pengchujin/aerial-tv/releases/latest) 下载 `aerial-standard.apk`（拒绝安装桌面类 App 的固件用 `aerial-guard.apk`），然后： ```bash adb connect 192.168.1.20:5555 adb install -r aerial-standard.apk adb shell pm grant app.orchard.tv android.permission.WRITE_SECURE_SETTINGS adb shell cmd notification allow_listener app.orchard.tv/app.orchard.tv.guard.RevivalListener adb shell appops set app.orchard.tv SYSTEM_ALERT_WINDOW allow

部署要求

需要 Android TV 8.0 或更高版本，电脑与电视在同一网络，并开启电视的 ADB 调试。

查看 README 依据

<a href="LICENSE"><img alt="许可证 MIT" src="https://img.shields.io/badge/%E8%AE%B8%E5%8F%AF%E8%AF%81-MIT-555555?style=flat-square"></a> <img alt="Android TV 8.0+" src="https://img.shields.io/badge/Android%20TV-8.0%2B-3ddc84?style=flat-square&logo=android&logoColor=white">  | 电视自带的桌面 | 换上 Aerial 之后 | |:---:|:---:| | <img src="site/img/stock-xiaomi.jpg" alt="电视自带的桌面：满屏剧集推荐、会员和限免角标"> | <img src="site/img/home.jpg" alt="Aerial 首页"> | </div> ## 功能 ### 首页 <p align="center"> <img src="site/img/focus.jpg" width="49%" alt="聚焦在 Netflix 上">

### 壁纸与手机设置 <p align="center"> <img src="site/img/wallpaper.jpg" width="74%" alt="壁纸与屏保面板"> <img src="site/img/phone.jpg" width="20%" alt="手机上的设置页"> </p> - **每日精选**：必应每日图片（国内直连），保留最近 8 张，也可以选「每日自动更新」。 - **内置**：8 组在电视上实时生成的柔光渐变，不含任何素材文件。 - **我的照片**：用手机扫码上传，传完立刻生效。 - **用手机设置**：扫描面板右侧的二维码，会打开一个 iOS 风格的网页，可以上传照片、挑选壁纸、切换屏保。这个页面只在壁纸面板打开时开放，关闭后再保留 5 分钟；地址里带随机令牌，同一网络里的其他设备猜不到。 ## 安装 全程不需要 root，**不卸载、不停用任何系统应用**，可以随时一条命令还原。 ### 第一步：打开电视的 ADB 调试 电脑和电视要连在同一个网络里。先在电视上找到 IP 地址（一般在「设置 → 网络」或「关于」里），再打开 ADB： | 电视 | 怎么打开 | |---|---|

已知限制

航拍影片和每日精选需要联网；TCL 调音量时会弹出系统音量条；小米上在别的 App 中空闲时仍会出现小米屏保；不支持网页直接安装。

查看 README 依据

| TCL `APP_AUTO_START` / `APP_ASSOC_START` | 允许开机自启（只有 TCL 固件有这两项） | ## 已验证的电视 | 机型 | 系统 | 状态 | 笔记 | |---|---|---|---| | 小米 MiTV-MFTR0 | Android 14 / HyperOS TV | 日常使用中 | [docs/devices/xiaomi-mitv-mftr0.md](docs/devices/xiaomi-mitv-mftr0.md) | | TCL MT5879 国行 | Android 11 | 日常使用中 | [docs/devices/tcl-mt5879-cn.md](docs/devices/tcl-mt5879-cn.md) | 其他品牌（海信、创维、索尼等）按同样的思路应该可以工作，但还没在真机上验证。欢迎[提交 Issue](https://github.com/pengchujin/aerial-tv/issues) 或 PR 补充你的机型。 ## 已知限制 - **网络**：航拍影片和每日精选都需要联网。航拍按 1080p H.264 实时播放，码率约 15–20 Mbps。 - **HDMI 设备名**：真实名称（如「Apple TV」）只有系统权限才读得到，所以统一显示为「已连接」。

- **TCL 音量条**：TCL 调音量时会同时弹出它自己的音量条，这是让音量真正生效的必要条件。 - **小米屏保**：在小米上，如果停在别的 App 里空闲，仍然会出现小米自己的屏保。 - **网页安装**：浏览器不能直接连接电视的网络 ADB（没有原生 TCP），电视的 USB 口也不能作为设备被电脑连接，所以没有提供「打开网页就能装」的方式。最接近的是上面的 Agent 提示词和一行命令。 ## 开发 需要 JDK 17、Android SDK 36。 ```bash ./gradlew assembleStandardRelease assembleGuardRelease BUILD=1 KEEP_ADB=1 TV=<电视IP> tools/install.sh # 用本地编译的 APK 安装 ``` - [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)：代码结构与关键数据流 - [docs/HANDOFF.md](docs/HANDOFF.md)：现状、调试技巧、必须遵守的规则 - [docs/devices/](docs/devices/)：各机型的实测笔记，包括 TCL 多屏互动的推送协议 - [AGENTS.md](AGENTS.md)：给 AI 代理的开发说明