项目能做什么
使用说明 查看原始 README 原仓库文档
项目简介
Aerial 是一款参照 Apple TV(tvOS)界面风格设计的开源 Android TV 桌面。针对国产电视广告多、推荐流繁杂的问题设计,界面仅保留应用、壁纸与航拍屏保,无广告插件。支持开机自动进入接管系统桌面,待机唤醒不被后台清理,无需 root,不破坏原有系统。
核心功能
- tvOS 风格桌面:常用 App 陈列于底部玻璃底板,向下滚动展示全部 App(支持展示米家、应用中心等隐藏系统应用)。
- 图标与信号源管理:长按遥控器 OK 键或按菜单键,支持移动、归类文件夹、隐藏、卸载或设为「开机时打开」。HDMI 信号源可固定在主页,并支持切换为 Apple TV、PlayStation、Switch、Xbox、电脑等对应图标。
- 手机扫码协同管理:电视端扫码后在手机网页端直接拖拽排序、重命名、更换图标、分组或添加信号源。
- 控制中心:首排按「上」键呼出,快速调节信号源、网络、设置、音量、亮度与个性化外观。
- 航拍屏保与动态壁纸:内置 114 段 Apple TV 航拍视频(硬件支持下可开启 4K / 杜比视界),支持必应每日壁纸、自定义照片/视频上传,以及桌面静止 10 秒后背景播放航拍。
- 个性化设置:支持单排/双排布局、每排 4/5/6 列、时钟样式/位置、按键音效及焦点样式调整。
适合谁用
- 使用小米/Redmi、TCL/雷鸟、海尔、OPPO、索尼 BRAVIA 等国产电视、投影仪或电视盒子设备。
- 厌烦电视自带商业广告和繁杂推荐流,追求极简、流畅 tvOS 交互体验的用户。
安装步骤
确保电脑与电视连接在同一局域网下:
1. 开启电视 ADB 调试
根据机型开启调试开关并记录电视 IP: - 小米 / Redmi:设置 → 关于 → 连续点击「产品型号/产品类型」进入开发者模式;再到 设置 → 账号与安全,开启「ADB 调试」与「安装未知来源的应用」。 - TCL / 雷鸟:设置 → 关于 → 本机信息,遥控器依次按「上、下、左、右」,在底部「更多」中开启 ADB。 - 海尔 / 模卡:按机身信号源键,遥控器按「左、左、上、右」进入工厂菜单,开启「ADB 调试开关」(切勿修改其他项)。 - OPPO:设置 → 系统 → 关于本机 → 设备型号,按「上、上、右、右、确认」;到 设置 → 系统 → 开发者选项 打开「USB 调试」。 - 其他 Android TV:设置 → 设备偏好设置 → 关于 → 连续点击「内部版本号」7 次,在开发者选项中开启「USB 调试」。
注:仅提供「无线调试」的 Android 11+ 电视(如索尼),需在「开发者选项 → 无线调试 → 使用配对码配对设备」获取 IP、端口与配对码后,在电脑端执行:
adb pair 192.168.1.20:37115 # 端口以电视配对码界面为准,输入 6 位配对码
adb connect 192.168.1.20:39201 # 端口以无线调试主页面为准
2. 执行安装
-
方式一:通过命令行一键安装(macOS / Linux)
bash curl -fsSL https://aerial.qust.me/install.sh | KEEP_ADB=1 TV=192.168.1.20 bash(请将192.168.1.20替换为您电视的实际 IP) -
方式二:让支持命令行的 AI Agent 执行(推荐) 可将带有电视 IP 的提示词发送给具备本地终端执行权限的 Agent(如 Claude Code、Trae 等),引导其阅读
https://aerial.qust.me/agent.md并自动完成 ADB 部署与验收。 -
方式三:手动下载 APK 安装 可下载
aerial-standard.apk手动通过 ADB 命令推送。(后续手动安装命令细节原文未完整提供,请查看原仓库说明)
配置说明
桌面无需手动编写配置文件,安装后通过以下方式配置: - 遥控器直调:通过首排右上角「控制中心」调整布局网格(4/5/6 列)、时钟及焦点样式。 - 手机扫码微调:电视端调出二维码后,使用手机扫码即可在线重命名应用、拖动排序或指定 HDMI 图标。
常见问题
此部分原文未说明,请查看原仓库。
原始 README 摘录(英文原文,节选前 3000 字符)
<div align="center"> <img src="docs/brand/icon.png" width="96" alt="Aerial 图标"> # Aerial **给国产电视的一块干净桌面。** 参照 Apple TV 做的 Android TV 桌面:没有广告,没有推荐流,只有你的 App、壁纸和航拍屏保。<br> 适合小米、TCL、创维、索尼等国产电视,也能装在盒子和投影仪上。开机自动进入,待机也不会被清理。 **中文** · [English](README.en.md) <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> <a href="#安装"><img alt="安装" src="https://img.shields.io/badge/%E5%AE%89%E8%A3%85-d97757?style=for-the-badge&logo=gnubash&logoColor=white"></a> <a href="https://github.com/pengchujin/aerial-tv/releases/latest"><img alt="版本" src="https://img.shields.io/github/v/release/pengchujin/aerial-tv?style=flat-square&label=%E7%89%88%E6%9C%AC&color=2997ff"></a> <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 5.0+" src="https://img.shields.io/badge/Android%20TV-5.0%2B-3ddc84?style=flat-square&logo=android&logoColor=white"> <a href="#lite"><img alt="Lite 4.0–4.4 测试版" src="https://img.shields.io/badge/Lite-4.0%E2%80%934.4%20%E6%B5%8B%E8%AF%95%E7%89%88-f5a623?style=flat-square&logo=android&logoColor=white"></a>  | 电视自带的桌面 | 换上 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="第一排的玻璃底板"> <img src="site/img/grid.jpg" width="49%" alt="往下滚动后的应用网格,中间有一个文件夹"> </p> - **首页**:常用的一排 App 放在屏幕下方的玻璃底板上,往下是全部 App。小米「应用中心」「米家」这类藏起来的系统 App 也在。 - **整理**:长按 OK 键(或按菜单键)可以移动、放进文件夹、隐藏、卸载,或者设成「开机时打开」(开机、待机醒来直接进这个 App 或信号源)。固定到主屏幕的 HDMI 可以选接的是 Apple TV、PlayStation、Switch、Xbox、电脑等,换成对应的图标,也能在手机上起名字。 - **用手机整理**:扫电视上的二维码,手机上就是和电视一样的图标网格:按住拖动排序,点一下改名、换图标、放进文件夹或隐藏,也能把 HDMI 等信号源加到主屏幕。 - **控制中心**:在第一排按上键到右上角打开,有信号源、网络、设置、音量、亮度和个性化。 - **屏保**:Apple TV 的 114 段航拍影片,电视支持时播 4K 或 4K 杜比视界,也可以换成照片、时钟或从手机添加的本地视频([说明](docs/SCREENSAVER_VIDEOS.md))。 - **壁纸**:必应每日精选、14 张内置壁纸、用手机扫码传的照片和视频,或者航拍:停在主屏幕 10 秒后在磁贴后面播放,按任意键停在当前画面。 - **个性化**:每排 4、5 或 6 个 App,单排或双排、时钟大小和位置、App 名称、焦点样式、按键声音,都能改。 <p align="center"> <img src="site/img/folder.jpg" width="49%" alt="打开的文件夹"> <img src="site/img/control-center.jpg" width="49%" alt="控制中心"> </p> <p align="center"> <img src="site/img/screensaver-aerial.jpg" width="49%" alt="航拍屏保"> <img src="site/img/columns.jpg" width="49%" alt="个性化:每排 App 选 4、5 或 6 个"> </p> ## 安装 不用 root,不动系统应用,随时能还原。电脑和电视连同一个网络。 ### 1. 打开电视的 ADB 调试 | 电视 | 怎么打开 | |---|---| | **小米 / Redmi** | 设置 → 关于 → 连续按「产品型号/产品类型」进入开发者模式,再到 设置 → 账号与安全,打开「ADB 调试」和「安装未知来源的应用」 | | **TCL / 雷鸟** | 设置 → 关于 → 本机信息,快速按遥控器「上下左右」,在底部的「更多」里打开 ADB | | **海尔 / 模卡** | 按电视机身上的信号源键,再用遥控器按「左左上右」,在工厂阅读完整原文
商业机会分析 AI 生成
一键装机辅助套件(移动端免电脑安装器)
| 产品构想 | 针对普通用户不会配对ADB、不会敲命令的痛点,开发配套的手机端App(Android/iOS网页配合WebADB),局域网自动扫描电视IP并完成一键激活开机接管与权限配置,免去电脑与终端操作。 |
| 核心功能 | 局域网自动组网发现、无线ADB配对码自动引导、一键静默安装APK、开机自启策略一键激活、系统原生桌面屏蔽助手 |
| 目标用户 | 没有电脑或不懂终端命令行的小白电视用户、家庭数码改装者 |
| 难度/周期 | 中等 · 3 - 5 周 · 成本:极低(仅需Android端开发或WebADB前端适配) |
| 收费模式 | 工具软件买断制收费(如 9.9 - 19.9 元/次或终身),提供小白级包教包会售后 |
| 竞争风险 | 电视厂商系统固件持续收紧无线调试权限;依赖电视品牌开放ADB端口 |
| 依据 | 已验证事实 |
精品航拍/艺术画框屏保与云端媒体增值服务
| 产品构想 | 在基础免费的Apple TV航拍之外,推出高清4K HDR/杜比视界全球地标壁纸包、博物馆艺术画作(模仿三星The Frame)、动态天气实时背景及云端同步服务。 |
| 核心功能 | 杜比视界/HDR10+ 高码率流媒体源CDN加速、艺术画框时钟排版、每日名画同步与作者讲解、手机端快捷相册投屏屏保 |
| 目标用户 | 对客厅视听审美有高要求的品质生活人群、高端电视(OLED/MiniLED)拥有者 |
| 难度/周期 | 低至中等 · 2 - 4 周 · 成本:中等(高码率4K视频CDN带宽和对象存储成本) |
| 收费模式 | 订阅制(如 6 元/月或 48 元/年)或壁纸包内购买断 |
| 竞争风险 | 视听内容版权合规风险;高画质视频带宽成本较高 |
| 依据 | AI推测 |
民宿、酒店与企业展厅定制版商业桌面系统
| 产品构想 | 基于Aerial为B端客户(中高端精品民宿、连锁酒店、会议室显示器)提供企业级Launcher解决方案,支持后台集中下发欢迎词、服务菜单、品牌广告和HDMI特定信号锁定。 |
| 核心功能 | 云端集中设备管理看板、个性化客房欢迎词轮播、酒店内部设施引导菜单、信号源开机直达防篡改、应用白名单锁定模式 |
| 目标用户 | 精品民宿主、智慧酒店工程商、企业前台/展厅IT管理员 |
| 难度/周期 | 较高 · 2 - 3 个月 · 成本:低(云端控制台开发及多租户服务器部署) |
| 收费模式 | 按设备授权数收费(如每台终端 30 - 80 元/年或一次性买断) |
| 竞争风险 | B端拓展周期长,电视厂商商用固件生态可能存在专属壁垒 |
| 依据 | 尚需验证的假设 |
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| JohnCoates/Aerial | 适用于 Mac 的 Apple TV 空中鸟瞰动态屏保。 | 21,244 | Swift |
| cDima/Aerial | 适用于 Windows 的 Apple TV 空中鸟瞰动态屏保。 | 1,988 | C# |
| 3ximus/aerial-sddm-theme | 采用 Apple TV 鸟瞰视频的 SDDM 登录管理器主题。 | 558 | QML |
| Null9797/halo-tv | Aerial 的 Android TV 非官方衍生版本,提供安装包与指南。 | 347 | HTML |
| danderfer/Comp_Sci_Sem_2 | 中文介绍暂未生成 According to all known laws of aviation, there is no way tha |
222 | Python |
| Jimu888/home-tv-cn | 中文介绍暂未生成 简居 TV:面向中国大陆常用视频应用的简约 Android TV 桌面,基于 Aerial 定制。 |
127 | Kotlin |
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 ,发布过 82 个 Release |
| 社区活跃 | Star 11,091 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
git clone https://github.com/pengchujin/aerial-tv.git cd aerial-tv # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)