Skip to content

About

简居 TV:面向中国大陆常用视频应用的简约 Android TV 桌面,基于 Aerial 定制。

Resources

Stars

120 stars

Watchers

0 watching

Forks

Repository files navigation

简居 TV · 大陆应用版电视桌面

面向中国大陆常用视频应用的简约 Android TV 首页。基于 pengchujin/aerial-tv 1.16 定制,保留原作者 MIT 许可。非官方分支,与小米及视频平台无隶属关系。

电视实际运行画面

功能

  • 暗红与深蓝背景、统一玻璃卡片、小尺寸原应用图标、遥控器焦点高光。
  • 固定排序:云视听极光 → 银河奇异果 → CIBN 酷喵 → 芒果 TV → 云视听小电视 → Netflix → YouTube。
  • 只替换首页;点击卡片进入电视上已安装的原应用。不会附带、破解或自动安装这些应用。
  • 上方提供信号源、网络、系统设置;下方提供投屏、硬盘、全部应用。
  • 左右选择应用,上下进入工具栏,确认打开;返回回到第一张卡片,菜单键打开全部应用。
  • 未安装应用显示“待安装”。没有广告位、内容推荐流或重复的选中应用大标题。

兼容性与限制

项目 当前状态
小米 MiTV-MFTR0,Android 14,HyperOS 3.0.106.0 已真机验证首页、重启接管、五款国内应用启动及系统入口
投屏、硬盘、蓝牙 保留原厂功能;验证了入口及硬盘识别,未完成全流程媒体播放测试
其他小米、TCL、海信及其他品牌 未验证本定制版;上游兼容经验不等于本版通过验证
系统版本 构建最低 Android 5.0;不代表所有 Android 5.0+ 固件可安装或接管首页
Netflix / YouTube 仅预留入口;需自行安装兼容版本及准备电视自身可用的网络,Netflix 另受设备认证影响

投屏和硬盘快捷入口目前针对小米包名实现,其他品牌可能提示不可用。首页卡片按包名匹配,不同渠道版应用可能需要修改 HomeScreen.kt 中的映射。电视必须允许安装应用或开启 ADB;仅连接同一个 Wi-Fi 并不足以完成改造。

安装

从本仓库 Releases 下载 home-tv-standard.apk,不要下载上游包替代。当前包名仍为 app.orchard.tv,但签名与上游不同:不能直接覆盖上游 Aerial。如果已安装上游版,请先保存其配置,自行决定是否卸载;卸载会删除该应用的数据。

电脑准备 Android platform-tools(adb),电视与电脑处于同一局域网,在电视设置中启用 ADB 并允许电脑连接。以下命令适用于 macOS/Linux 的 Bash:

# 在项目根目录执行,填写电视自己的地址和 APK 路径
APK_FILE='/absolute/path/home-tv-standard.apk' TV='<电视IP>' bash tools/install.sh

安装脚本授予桌面接管所需的无障碍、通知监听、悬浮窗及写入系统设置等权限;尝试设置默认桌面,受固件限制时使用守护服务接管。不会卸载系统桌面,也不会自动修改 DNS、代理、广告开关或屏保。第三方固件可能拒绝授权,不能保证每次 Home 切换都完全无闪屏。

KEEP_ADB=1 是可选项,会在固件关闭调试后重新开启 ADB;默认不启用。仅在自己信任的局域网中按需使用。

恢复原厂首页、保留本应用和媒体文件:

TV='<电视IP>' bash tools/restore.sh

恢复脚本会撤销本应用的接管权限;支持默认桌面选择的系统可能需要重新选择原厂桌面。不要停用或删除原厂桌面。建议先手动记录原默认桌面及相关授权,便于按设备情况恢复。

广告处理的边界

本首页没有广告。应用内的开屏、片头、暂停广告仍由视频平台控制,本项目不是全机广告拦截器。示例小米电视上另行手动关闭了应用商店/小米商城通知和匿名设备标识符,开启了观影免打扰;这些是设备设置,不会随 APK 自动应用到别人的电视。关闭广告标识符也不等于减少广告数量。

构建

需要 JDK 17、Android SDK 36,并设置 JAVA_HOME 与 ANDROID_HOME:

./gradlew assembleStandardRelease lintStandardRelease

输出位于 app/build/outputs/apk/standard/release/。公开发布版使用维护者私钥签名;私钥不会提交。自行构建默认使用本机 debug key,不能覆盖不同签名的发布版。长期维护请使用自己的签名并妥善备份。

签名配置位于忽略版本控制的 local/signing.properties,字段为 storeFile(相对于 local/)、storePassword、keyAlias、keyPassword。不要分享该文件和密钥。

上游保留的 guard 构建供拒绝 HOME 声明的固件研究使用,本次未提供真机验收或二进制发布。安装脚本在 TCL 限制下可能尝试 guard 构建,应先阅读脚本并准备相应构建环境。

来源与许可

上游基线:pengchujin/aerial-tv 提交 5a91b87852f2a66139d207ec2942f2d6964726f9。感谢原作者提供桌面接管、系统入口及 UI 基础。

代码遵循 MIT License,字体遵循 OFL。应用名称、图标及商标归各自权利人所有。截图中的应用图标由电视上已安装应用提供,本仓库不分发对应商业应用 APK。

About

简居 TV:面向中国大陆常用视频应用的简约 Android TV 桌面,基于 Aerial 定制。

Resources

Stars

120 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages