pengchujin/aerial-tv

给国产电视的一块干净桌面。 参照 Apple TV 做的 Android TV 桌面：没有广告，没有推荐流，只有你的 App、壁纸和航拍屏保。 适合小米、TCL、创维、索尼等国产电视，也能装在盒子和投影仪上。开机自动进入，待机也不会被清理。 中文 · English 不用 root，不动系统应用，随时能还原。电脑和电视连同一个网络。 电视的 IP 在「设置 → 网络 → 已连接的网络」里。第一次连接时，有 USB 调试开关的电视会问是否允许调试，选「始终允许」；只有无线调试的电视不弹这个窗，见下一段。 只有无线调试、没有 USB 调试 / 网络调试（ADB 调试）开关的 Android 11+ 电视，第一次要先配对（例如索尼 BRAVIA 的 Android 14，#747）：这类电视不提供旧的明文端口，不能直接 adb connect :5555。在电视上打开 设置 → 系统 → 开发者选项 → 无线调试 → 使用配对码配对设备，把配对码屏幕上的 IP:端口和 6 位配对码输入电脑： 连上后照常安装。想让以后直接用 :5555，连上时再运行一次 adb tcpip 5555；配过对的电脑不用再配对。install.sh 和安装说明里的 Agent 会引导这一步。部分 TCL 固件（Q10M、Q10L、鹤 6 Ultra 等）没有配对码入口，只能先按下面的分品牌说明用数据线连电脑授权。 更细的分品牌说明（包括打不开 ADB 的机型）见 docs/devices/adb-by-brand.md。 让 Agent 装（推荐）：把下面这段发给能在电脑上运行命令的 Agent（WorkBuddy、豆包电脑版、千问电脑版、Trae、Claude Code、Codex 等）： 手机上的豆包、网页版聊天只会把步骤告诉你，不会执行；要用能跑命令的电脑版 / 工作版（豆包电脑版或豆包工作版、WorkBuddy、千问电脑版、Trae、Claude Code、Codex 等）。Agent 说装好了，看它贴出的 mCurrentFocus 输出里有没有 app.orchard.tv。 没有电脑：有用户用手机上的甲壳虫 ADB 助手、超级小爱装成功过，本仓库没有逐一实测。步骤和上面的 Windows 步骤一样，装好后建议再用电脑跑一遍验收。 一行命令（macOS / Linux）： 只有无线调试的电视（见第 1 步）先 export ADBPAIR= ADBCODE= ADBCONNECT=，再跑上面的命令；没有配对码入口的（TCL Q10M、Q10L、鹤 6 Ultra 等）先按分品牌说明用数据线连一次、运行 adb tcpip 5555，之后照常跑上面的命令。 手动：下载 aerial-standard.apk。只有无线调试的电视（见第 1 步）按下面两种情况之一先处理好，再运行命令： 最后一条让 Aerial 在电视上更流畅：等 Aerial 显示出来、过 5 秒再运行，要几十秒。不运行的话，Aerial 要等到下次从控制中心升级时才会编译。 Windows 用 Agent 装，或照安装说明里的 Windows 步骤。 U 盘（不用电脑）：下载 APK 拷进 U 盘，用电视的文件管理器打开安装。 装好后按主页键：系统问「使用哪个应用」时选 Aerial、再选「始终」就设好了（原生 Android TV 一般是这样）。直接回到原桌面、不问（国产电视大多这样）时，从「我的应用」打开 Aerial，它会弹出「设为主屏幕」，按里面的入口去电视设置里打开桌面守护（无障碍）和通知使用权；电视设置里没有这些入口时，Aerial 只能当普通 App 用，要接管主页键还得用上面的命令或 Agent 设置一次（覆盖安装，不丢设置）。 升级：1.32…