登录 注册

aerial-tv (tvOS风格电视桌面)

曾爆款
去点 Star
其他
11,091
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
Kotlin
语言
创建时间
最近更新

项目能做什么

参照 tvOS 设计的 Android TV 桌面,无广告与推荐流,支持开机接管,适配国产电视、盒子与投影仪。
来源:AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 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 首页](site/img/home.jpg)

| 电视自带的桌面 | 换上 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端拓展周期长,电视厂商商用固件生态可能存在专属壁垒
依据 尚需验证的假设
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 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
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度创建于 ,最近推送 ,发布过 82 个 Release
社区活跃Star 11,091 / Fork 0 / Issue 0(数据支持,可自行核实)
许可证未检测到(需人工确认)
主要风险上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价

安装与使用

快速开始(以仓库 README 为准)
git clone https://github.com/pengchujin/aerial-tv.git
cd aerial-tv
# 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
阅读原仓库文档
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。