Aerial icon # Aerial **A calm home screen for Android TV.** A home screen modeled on Apple TV, with no ads and no recommendation feeds: just your apps, your wallpaper and aerial screensavers.
Made for Xiaomi, TCL, Skyworth, Sony and other TVs sold in China, and runs on boxes and projectors too. It starts at boot and survives standby. [中文](README.md) · **English** Website Download APK Install Version License: MIT Android TV 5.0+ Lite 4.0–4.4 beta ![Aerial's home screen](site/img/home.jpg) | The TV's stock home screen | With Aerial | |:---:|:---:| | The stock home screen, covered in show recommendations and membership badges | Aerial's home screen |
## Features

The glass shelf under the top row The app grid, with a folder in it

- **Home**: your favorite apps in one row on a glass shelf at the bottom, every app below it. Hidden system apps like Xiaomi's App Store and Mi Home show up too. - **Organize**: hold OK (or press Menu) to move an app, put it in a folder, hide it, uninstall it, or have the TV open it at power on and wake. An HDMI input pinned to Home can say what is plugged in (Apple TV, PlayStation, Switch, Xbox, a computer...) and take its icon, or a name you type on your phone. - **Arrange from your phone**: scan the code on the TV and your phone shows Home as the TV lays it out. Drag tiles into place; tap one to rename it, change its icon, put it in a folder or hide it; add HDMI and other inputs to Home. - **Icon library**: popular apps get ready-made 16:9 tile pictures, several for some apps, picked on your phone, each named with where it came from: a set drawn by [le5inioo](https://github.com/le5inioo) ([#706](https://github.com/pengchujin/aerial-tv/issues/706)), the apps' own tvOS icons, Aerial's own for system apps, and Dangbei Launcher's. - **Control Center**: press Up from the top row to the top right. Inputs, network, settings, volume, brightness and Personalize. - **Screensaver**: Apple TV's 114 aerial films, in 4K or 4K Dolby Vision where the TV supports it, your photos, a clock, or local videos sent from your phone ([guide, Chinese](docs/SCREENSAVER_VIDEOS.md)). - **Wallpaper**: Bing's photo of the day, fourteen built-ins, photos and videos you upload by scanning a code with your phone, or aerial films that play behind the apps after ten still seconds on Home and stop on the frame showing at any key. - **Personalize**: four, five or six apps a row, one or two rows, clock size and corner, app names, focus style and key sounds.

An open folder Control Center

Aerial screensaver Personalize, with four, five or six apps per row

## Install No root, no system apps touched, and you can undo it. Your computer and TV need to be on the same network. ### 1. Turn on ADB debugging The menus on Chinese firmware are in Chinese; their names are in brackets. | TV | How | |---|---| | **Xiaomi / Redmi** | Settings (设置) → About (关于) → press Model (产品型号) until developer mode is on, then Settings → Account & Security (账号与安全): turn on ADB debugging (ADB 调试) and Install unknown apps (安装未知来源的应用) | | **TCL / FFALCON** | Settings (设置) → About (关于) → Device info (本机信息), quickly press Up Down Left Right, then turn on ADB under More (更多) | | **Haier / MOOKA** | Press Source on the TV itself, then Left Left Up Right on the remote; in the factory menu turn on ADB 调试开关 and change nothing else | | **Hisense / Vidda** | Settings (设置) → Sound (声音): turn off Dolby Atmos (杜比全景声). In Pro audio settings (专业音响设置) → Balance (声音平衡), quickly alternate OK and Menu until an M shows at the top left, then press Menu for the factory menu. Under Options (选项) change To Fac from U to M, change nothing else, and restart. Then Settings → All settings (全部设置): press Menu repeatedly for the stock Android settings, press Build 7 times, and turn on USB debugging and Wireless debugging in Developer options. The factory menu is risky if pressed wrong, and changing To Fac repeatedly can stop USB working until the TV is reset: change it once ([details](docs/devices/adb-by-brand.md)) | | **OPPO (S1 included)** | Settings (设置) → System (系统) → About (关于本机) → Model (设备型号), press Up Up Right Right, then OK. Then Settings → System → Developer options (开发者选项): turn on USB debugging (USB 调试). The IP address is at the bottom of Settings → Network → the connected network | | **Other Android TVs** | Settings → Device Preferences → About → press Build 7 times, then turn on USB debugging in Developer options | The TV's IP address is under Settings → Network → the connected network. The first time you connect, a TV with a USB debugging switch asks whether to allow debugging: choose Always allow. TVs that only offer Wireless debugging show no such prompt; see the next paragraph. **TVs that only offer Wireless debugging (no USB/network debugging toggle) on Android 11 and later pair before connecting** (such as Sony BRAVIA on Android 14; #747): these TVs have no plain port, so `adb connect :5555` alone does not work. On the TV open Settings → System → Developer options → **Wireless debugging** → **Pair device with pairing code**, then enter the IP:port from the pairing screen and the 6-digit code on the computer: ```bash adb pair 192.168.1.20:37115 # the port on the TV's pairing screen (example; use the TV's) # when it asks for the pairing code, type the 6 digits shown on the TV adb connect 192.168.1.20:39201 # the other IP:port, on the main Wireless debugging screen (example) ``` Then install as usual. To use plain `:5555` from now on, run `adb tcpip 5555` once connected; a computer that has paired does not pair again. `install.sh` and the agent in the [install guide](site/en/agent.md) walk through this step. Some TCL firmwares (Q10M, Q10L, Crane 6 Ultra and similar) have no pairing-code entry at all; there, authorize once over a USB cable as in the by-brand guide below. A more detailed guide by brand, including TVs that cannot open ADB, is in [docs/devices/adb-by-brand.md](docs/devices/adb-by-brand.md) (Chinese). ### 2. Install **With an agent (recommended)**: paste this into an agent that can run commands on your computer (Claude Code, Codex, WorkBuddy, Trae, Cursor, Doubao for desktop…): ```text Please install Aerial, an open-source home screen for Android TV, on my TV, and make it the home screen the TV starts into. TV IP address: Keep ADB debugging on: yes The install guide is here: https://aerial.qust.me/en/agent.md (If you can't open it, use https://raw.githubusercontent.com/pengchujin/aerial-tv/main/site/en/agent.md) Read the whole guide before you start. Then run the commands yourself on my computer; don't just tell me the steps. Tell me when I need to do something on the TV. At the end, paste the raw output of these commands from the "Check" section, not just "it worked": - adb shell "cmd package resolve-activity --brief -a android.intent.action.MAIN -c android.intent.category.HOME" - adb shell settings get secure enabled_accessibility_services - adb shell "dumpsys window | grep mCurrentFocus" after pressing Home ``` Phone apps and web chats, including Doubao on a phone, only tell you the steps; they can't run anything. Use a desktop build that can (Doubao for desktop or Doubao Work, WorkBuddy, Qwen for desktop, Trae, Claude Code, Codex…). When the agent says it's done, check that the `mCurrentFocus` output it pastes includes `app.orchard.tv`. **USB drive (no computer)**: copy an APK to a USB drive and open it with the TV's file manager. | Download | For | |---|---| | [aerial-standard.apk](https://aerial.qust.me/download/aerial-standard.apk) | Android 5.0 and later; try this first | | [aerial-guard.apk](https://aerial.qust.me/download/aerial-guard.apk) | when standard is refused because the TV won't install home-screen apps | | [aerial-lite.apk](https://aerial.qust.me/download/aerial-lite.apk) | Android 4.0-4.4 (see [Aerial Lite](#lite) below) | Then press Home: if Android asks which app to use, choose Aerial, then Always, and you're done (stock Android TV usually works this way). If Home goes straight back to the old launcher without asking (most Chinese-brand TVs), open Aerial from the app list; it shows "Make Aerial Your Home Screen", whose entries open the TV's settings for the home guard (Accessibility) and notification access. If the TV's settings don't have them, Aerial works only as an ordinary app; to take over Home, run the command below or hand it to an agent once (it installs over, settings stay). **Without a computer**: users have installed Aerial with the phone apps Beetle ADB (甲壳虫 ADB 助手) and Super Xiaoai (超级小爱); we haven't tested each one. The steps are the same as the Windows ones above; once it's installed, run the check from a computer if you can (see [Check](site/en/agent.md#check-required)). **One command (macOS / Linux)**: ```bash curl -fsSL https://aerial.qust.me/install.sh | KEEP_ADB=1 TV=192.168.1.20 bash ``` On a TV that only offers Wireless debugging (step 1), `export ADB_PAIR= ADB_CODE=<6-digit code> ADB_CONNECT=` before running that command; one with no pairing-code entry (TCL Q10M, Q10L, Crane 6 Ultra and similar) first follows the [by-brand guide](docs/devices/adb-by-brand.md), authorizing once over a USB cable and running `adb tcpip 5555`, then runs the command as usual. **By hand**: download [aerial-standard.apk](https://aerial.qust.me/download/aerial-standard.apk). On a TV that only offers Wireless debugging (step 1), do one of these first, then run the commands: - **With a pairing-code entry** (Sony BRAVIA on Android 14 and similar): pair as in step 1 and run `adb tcpip 5555` once connected, so the first line of the commands is 5555; without that, use the IP:port from the main Wireless debugging screen on the first line; the rest is the same. - **Without a pairing-code entry** (TCL Q10M, Q10L, Crane 6 Ultra and similar): follow the [by-brand guide](docs/devices/adb-by-brand.md) to connect the TV to a computer with a USB cable, then run `adb tcpip 5555` once authorized; until then, the first line's `adb connect :5555` does not work. ```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 adb shell am start -n app.orchard.tv/.MainActivity adb shell cmd package compile -m speed -f app.orchard.tv ``` The last line makes Aerial smoother on the TV: run it about 5 seconds after Aerial shows, and it takes some tens of seconds. Without it, Aerial is only compiled at its next update from Control Center. On Windows, use an agent, or follow the Windows steps in the [install guide](site/en/agent.md). **Updating**: from 1.32, Control Center shows New Version when there is one; choose Download and Install there and confirm in the TV's own installer (checked on Xiaomi and TCL). Aerial comes back afterwards with every setting kept. On TVs that do not let apps install apps, updating means running the install command again: the update page has a QR code that opens this TV's command on a phone, ready to copy or to hand to an agent. 1.31 and earlier have no such button, so this once, run the install command again. ### Android 4.0–4.4: Aerial Lite (beta) TVs and boxes on Android 4.0–4.4 cannot run the full app (its UI framework needs Android 5.0), so there is a separate **Aerial Lite**: package `app.orchard.tv.lite`, looking the same as the full app. > **Lite is at its first release (1.0), a beta.** It was tested on Android 4.0.4 / 4.4.4 emulators and on newer Xiaomi and TCL TVs, not yet on a real 4.x TV, and may still have many small problems. **It is for Android 4.0–4.4 only**; on Android 5.0 and later use the full app above. Report problems with the [device support form](https://github.com/pengchujin/aerial-tv/issues/new?template=device.yml), with Lite in the title. **One command (macOS / Linux)**: the same command as the full app; the script installs Lite by itself on an Android 4.x TV. To ask for it: ```bash curl -fsSL https://aerial.qust.me/install.sh | TV=192.168.1.20 bash -s lite ``` **By hand**: download [aerial-lite.apk](https://aerial.qust.me/download/aerial-lite.apk), then: ```bash adb connect 192.168.1.20:5555 adb install -r aerial-lite.apk adb shell pm grant app.orchard.tv.lite android.permission.WRITE_SECURE_SETTINGS # for brightness; Android 4.0 refuses it, which is fine adb shell am start -n app.orchard.tv.lite/.HomeActivity ``` **USB drive**: copy `aerial-lite.apk` to a drive and open it with the TV's file manager. **Afterwards**: press **Home** on the remote; when Android asks which app to use, choose **Aerial Lite**, then **Always**. If no question comes and the old launcher opens, the firmware keeps Home for its own launcher: open Lite from the app list. **Differences from the full app**: no Home Guard (accessibility takeover), so Home and boot depend on Android's default home; no aerial wallpaper, My Videos wallpaper, input tiles (4.x has no TV input framework; the Inputs button opens the TV's own input panel) or in-app updates (update by installing again; settings are kept). The aerial screensaver, photos and the daily picture, clocks, folders, the press-and-hold menu, Control Center, Personalize and the phone page are all there. More in [docs/LITE.md](docs/LITE.md) (Chinese). **Undo**: on the TV, Settings → Apps → Aerial Lite → Clear defaults, then press Home and pick the old launcher; or uninstall it: `adb uninstall app.orchard.tv.lite` (the one command's `bash -s restore --uninstall` removes it too). ### Undo ```bash curl -fsSL https://aerial.qust.me/install.sh | TV=192.168.1.20 bash -s restore ``` Add `--uninstall` (`bash -s restore --uninstall`) to remove Aerial as well. Without bash (Windows), the adb commands one by one are under [Undo in the install guide](site/en/agent.md#undo). To have an AI do it (it needs to run commands on a computer), paste this: ```text Please follow the "Undo" section of https://aerial.qust.me/en/agent.md to give my TV (IP address: ) its original home screen back, without uninstalling Aerial. Run the commands yourself on my computer, and at the end paste the raw output of settings get secure enabled_accessibility_services and of dumpsys window | grep mCurrentFocus after pressing Home. ``` ### Troubleshooting - **Will it work on my TV?** See [Supported TVs](#supported-tvs) below. - **Installed only the APK from a USB stick**: from 1.32 Aerial has an icon in the TV's app list and, when opened, shows how to make it the Home screen. With the APK alone, Home, power-on and wake still go to the old launcher; run the command above or hand it to an agent once more (it installs over, settings stay). - **TCL shows a 多屏互动 prompt**: press Right, then OK, to choose 同意 (Agree). - **Skyworth: `adb install` fails with `INSTALL_FAILED_USER_RESTRICTED`**: run `adb shell settings put global verifier_verify_adb_installs 0`, then install again (from a user's report; see the [agent guide](site/en/agent.md#common-cases)). - **The firmware won't install home-screen apps**: add `-s guard` to the end of the command, or use [aerial-guard.apk](https://aerial.qust.me/download/aerial-guard.apk). - **What `KEEP_ADB=1` does**: Xiaomi turns ADB off after standby; with it, Aerial turns it back on so you can update later. - **Do my apps, subscriptions, Xiaoai, account and cable TV stay?** Yes. Aerial only replaces the home screen. The old home screen is in the app list (Xiaomi Video and PatchWall open from the 桌面 tile), and Xiaoai, the Xiaomi account and cable TV work as before. A boot ad comes from the firmware and stays. ## How it stays your home screen Most TVs sold in China only accept their own home screen and clear third-party apps in standby. So Aerial uses an accessibility service to switch back whenever the stock home screen appears (it only looks at which window is in front, never at what's on screen), and a notification listener to get the system to restart it after a kill (it reads no notifications). Old Xiaomi sets on Android 6 report no window changes from their home screen, so there the guard reads the system's usage stats; it also knows the home screens some Coocaa and Skyworth firmware start in their own way. Stock Android TV needs none of this: Aerial is simply the default home screen. ## Supported TVs ✅ works ⚠️ works with limits ❌ can't take over yet. Mostly from user reports; the linked notes (Chinese) have details. | Brand | Models | System | Status | |---|---|---|---| | Xiaomi / Redmi | MiTV-MFTR0 (Redmi X65 2026), MFFU0, MTSU0 (S65 Mini LED 2026) | Android 14 | ✅ In daily use ([MFTR0](docs/devices/xiaomi-mitv-mftr0.md), [MFFU0](docs/devices/xiaomi-mitv-mffu0.md), [MTSU0](docs/devices/xiaomi-mitv-mtsu0.md)) | | Xiaomi / Redmi | MiTV-ASTR0 (Redmi A Pro 75, HyperOS 2) | Android 11 | ✅ Home, reboot, standby wake, volume and brightness work ([#1042](https://github.com/pengchujin/aerial-tv/issues/1042)); two HDMI ports on the set but four registered by the firmware, the next version lists two; the real remote's Home shows Xiaomi's launcher for a moment first ([#1517](https://github.com/pengchujin/aerial-tv/issues/1517)) | | Xiaomi | MiTV-ASTP0, ASTP1, NSOP0, MFTP0 | Android 9 | ✅ MFTP0 takes 30–60 s to come back after the system clears it ([notes](docs/devices/xiaomi-mitv-mftp0.md)) | | Xiaomi | Mi TV 4 / 4A / 4X / 3S, Mi Box 4 | Android 6 | ✅ From 1.43; Home takes a few seconds to return to Aerial ([notes](docs/devices/xiaomi-android6.md)) | | Xiaomi | Mi TV 2S (MIUITV 1.3.33) | Android 5.1 | ✅ Full app installed from USB; with Home Guard turned on from Control Center, Home, power cycle and standby wake return to Aerial ([#1237](https://github.com/pengchujin/aerial-tv/issues/1237)) | | Xiaomi | Mi TV 2 (MiTV2-49) | Android 4.3 | ❌ Aerial Lite installs and runs, but the system opens Xiaomi's launcher by component on Home, so it cannot be the home screen ([#770](https://github.com/pengchujin/aerial-tv/issues/770)) | | Huawei | M330 box | Android 4.4 | ❌ Aerial Lite installs, but the firmware sets its own launcher back as the default at every boot ([#850](https://github.com/pengchujin/aerial-tv/issues/850)) | | Xiaomi (Fengmi) | Ultraman series projector | Android 9 | ✅ ([notes](docs/devices/xiaomi-ultraman-projector.md)) | | TCL | MT5879 (China), 98T8H | Android 11 | ✅ In daily use ([notes](docs/devices/tcl-mt5879-cn.md); 98T8H: [#803](https://github.com/pengchujin/aerial-tv/issues/803)) | | TCL | Q9L Pro | Android 14 | ⚠️ ADB over a USB cable only; allow Aerial to auto-start in the TV manager; inputs switch from 1.77 on ([#792](https://github.com/pengchujin/aerial-tv/issues/792)) | | TCL | 85T7L Pro (MT9655_4K_CN) | Android 14 | ⚠️ adb over a USB cable only (network adb listens on IPv6 alone and can't be reached); standard won't install, guard with `boot_app_componentname` set to Aerial boots into Aerial and the guard stays ([#1398](https://github.com/pengchujin/aerial-tv/issues/1398)) | | TCL | 65T7L (MT9655_4K_CN) | Android 14 | ✅ Guard build; after authorizing over a USB A-to-A cable `adb install` was refused, so it went through 多屏互动 (screen sharing); Home and wake work, a restart not yet tried ([#1547](https://github.com/pengchujin/aerial-tv/issues/1547)) | | TCL | 65V8E (tc8000 ay30a2) | Android 11 | ✅ After a power cut the stock launcher shows for 6–8 s first ([#1137](https://github.com/pengchujin/aerial-tv/issues/1137)) | | TCL | 65V8M Pro (T966D5, V066) | Android 14 | ⚠️ The TV booted into Aerial with the guard build. Pressing Home in TCL Settings returned to Aerial. Home Guard was briefly unbound after boot. [Device notes](docs/devices/ffalcon-t966d5.md#tcl-65v8m-pro) | | Thunderbird | 75S78A Plus (FFALCON T966D5) | Android 14 | ❌ The firmware clears accessibility about once a minute, so Home cannot be taken over; `boot_app_componentname` boots into Aerial ([notes](docs/devices/ffalcon-t966d5.md)) | | Thunderbird | He 6 2027, 55" (T966D5 / AU01) | Android 14 | ⚠️ guard flavor; with `boot_app_componentname` set to Aerial it booted into Aerial with the guard running; one reboot tried ([#1185](https://github.com/pengchujin/aerial-tv/issues/1185)) | | TCL | 75V2 (m7221) | Android 8 | ✅ Starts straight into Aerial, no root ([notes](docs/devices/tcl-m7221-cn.md)) | | TCL | 55Q9 (X5, m7221) | Android 8 | ✅ Guard build: Home, restart, standby, volume and brightness, screensaver and the phone page work; the ADB switch is hidden in Settings and has to be opened with the remote ([#1371](https://github.com/pengchujin/aerial-tv/issues/1371)) | | TCL / FFALCON | 60A730U, 55V2 Pro (x32a0), 65Q10E and Crane 6 (m7642), 75S365C, 75Q10L | Android 5.1–14 | ✅ 60A730U only takes the guard build; 55V2 Pro needs `setprop persist.tcl.debug.installapk 1` before adb installs ([#620](https://github.com/pengchujin/aerial-tv/issues/620)) | | FFALCON | FF55S515D-E674 (tcl_m7642) | Android 9 | ✅ guard installed through Multi-screen Interaction; Home works. After reboot and screen-on, stock Home appears before Aerial; wake sometimes briefly shows stock Home too ([observations and limits](docs/devices/ffalcon-55s515d.md)) | | FFALCON | Crane 7 Pro 65R675C (tcl_mt5879_cn) | Android 11 | ✅ standard refused (`INSTALL_FAILED_VERIFICATION_FAILURE`), guard through Multi-screen Interaction; with the boot component set to Aerial a reboot goes straight to Aerial, Home returns to Aerial ([#1432](https://github.com/pengchujin/aerial-tv/issues/1432)) | | FFALCON | 55S595C Ultra, Crane 6 2025 Ultra | Android 11+ | ❌ Without a wireless debugging connection it installs but can't take over Home ([notes](docs/devices/tcl-mt9655-cn.md)) | | FFALCON | 855S595C Ultra (MT9655, firmware V8-0015T11) | Android 14 | ✅ ADB authorized over a USB A-to-A cable (C-to-A did not work), guard build pushed with 多屏互动; Home and boot both reach Aerial; after a restart, plug in again and `adb tcpip 5555` ([#1473](https://github.com/pengchujin/aerial-tv/issues/1473)) | | Sony | A80J (China), BRAVIA VH1 | Android 10 / 12 | ✅ | | Sony | BRAVIA BF1 (China, BRAVIA 3, Dangbei firmware) | Android 12 | ✅ Control Center's brightness item opens the TV's picture settings ([#1355](https://github.com/pengchujin/aerial-tv/issues/1355)) | | Sony | BRAVIA 4K VH2 | not given | ✅ ([#1193](https://github.com/pengchujin/aerial-tv/issues/1193)) | | Sony | KD-55X8000E (China, BRAVIA 4K GB) | Android 9 | ✅ The firmware locks Home; with `filterHomeAlways` written on that TV by an agent, Home goes to Aerial; the stock launcher shows first at boot ([#1351](https://github.com/pengchujin/aerial-tv/issues/1351)) | | Sony | 49X7500E (China, BRAVIA 4K GB) | Android 9 | ✅ Choosing an input flashed back to the stock launcher because of corrupted app data on the TV; fine after clearing it ([#1493](https://github.com/pengchujin/aerial-tv/issues/1493)) | | Sony | KD55X7000D (China) | Android 8 | ✅ Brightness only in the TV's own settings ([#757](https://github.com/pengchujin/aerial-tv/issues/757)) | | Skyworth / Coocaa | K3 Pro, 75A7D | Android 11 | ✅ 75A7D inputs work from 1.45; at power-on Coocaa's launcher shows for 3–6 s, which the reporter removed by changing firmware properties ([#894](https://github.com/pengchujin/aerial-tv/issues/894)) | | Skyworth / Coocaa | 65G60, 8R134 / 8R145, aigc models (C10 projector, P60, 7T863) | Android 8–11 | ⚠️ Boots into Coocaa's home first, or takes 20–30 s to come back after the system clears it ([notes](docs/devices/skyworth-coocaa.md)) | | Skyworth / Coocaa | 55K5C (8R39_K5C) | Android 8 | ✅ From 1.95 Home no longer flashes Coocaa's launcher first, with `filterHomeAlways` written by an agent ([#1462](https://github.com/pengchujin/aerial-tv/issues/1462)) | | Skyworth / Coocaa | 5S21 (50K2, 7626K2), 5S05 (60U2), 8H66 H7 | Android 5.x | ⚠️ Aerial after boot and standby, but Home does not return to it; no inputs listed | | Skyworth / Coocaa | 8S26 14U (sky918_14U, MStar) | Android 4.3 | ❌ Aerial Lite installs and runs, but the firmware's `com.tianci.uiservice` opens Coocaa's launcher on Home with no chooser, so it is a plain app there ([#1529](https://github.com/pengchujin/aerial-tv/issues/1529)) | | Skyworth / Coocaa | 8H83 M6 (Hi3751V500) | Android 4.4 | ❌ Aerial Lite installs and runs, but the firmware opens its own launcher by component on Home and at power-on, and its chooser lists no third-party launcher ([#903](https://github.com/pengchujin/aerial-tv/issues/903)) | | Skyworth / Coocaa | 8H57_H5 | Android 5.1 | ⚠️ Spins for a dozen seconds at boot before Aerial ([#785](https://github.com/pengchujin/aerial-tv/issues/785)) | | Skyworth | 65M9 (8H26_M9, Hi3751V553, 1 GB) | Android 5.1.1 | ✅ Home and a power cycle return to Aerial; Coocaa's launcher shows for 15–25 s at boot; standby, inputs and the screensaver untested ([#1613](https://github.com/pengchujin/aerial-tv/issues/1613)) | | Skyworth | 1AA46_D4 (T963) | Android 9 | ✅ ([#796](https://github.com/pengchujin/aerial-tv/issues/796)) | | Skyworth | 43H30 (1MC02, MT5862) | Android 9 | ✅ On a cold boot the stock launcher shows for 1–2 s; the backlight is set only in the TV's own picture settings ([#1192](https://github.com/pengchujin/aerial-tv/issues/1192)) | | Skyworth | 55A5F Pro (8R702_A5FP) | Android 13 | ✅ Use the standard build, opened the way Home opens it (the guard build is black there) ([#1349](https://github.com/pengchujin/aerial-tv/issues/1349)) | | Skyworth / Coocaa | K3 (7T634_P3H) | Android 13 | ⚠️ 1.87 standard: picture, physical Home and a short Volume Down press work after allowing auto-start and background retention. With HDMI connected, reboot tests with Aerial alone still stayed on the input; standby untested ([notes](docs/devices/skyworth-coocaa.md), [#864](https://github.com/pengchujin/aerial-tv/issues/864)) | | Skyworth | 7T641, 75A6E, 8R721_A6FP | Android 13 | ❌ Black screen, or no window focus and stopped by the system ([#839](https://github.com/pengchujin/aerial-tv/issues/839)) | | Skyworth | Xiaopai P3 (Q5001 / cupid-p2) box | Android 10 | ⚠️ Needs a renamed package to take over Home; boot broadcasts are all blocked ([notes](docs/devices/skyworth-p3-box.md)) | | Panasonic | TH-55HX560C (built by Skyworth) | Android 8 | ⚠️ No inputs listed; the remote's input key shows the TV's own input page (from 1.95); Home pressed twice flashes the stock launcher until an agent writes `filterHomeAlways` ([#1468](https://github.com/pengchujin/aerial-tv/issues/1468)) | | Konka | KKTV U86V9, 2861 | Android 9 | ✅ U86V9 brightness does not work ([notes](docs/devices/konka-kktv-u86v9.md)) | | Haier | L55F5 (LRM9633, AliOS) | Android 13 | ✅ Guard build: Home and waking from standby ([#1131](https://github.com/pengchujin/aerial-tv/issues/1131)) | | Konka | Android TV 551 (Hi3751V551) | Android 5.1.1 | ✅ Boots straight into Aerial once it is chosen under Konka's Settings → General → Shortcuts → Boot to; Home Guard takes Home; the firmware has no `cmd` ([#1089](https://github.com/pengchujin/aerial-tv/issues/1089)); Hi3751V551E works with 1.95 guard, the wallpaper takes over ten seconds to appear after a boot ([#1504](https://github.com/pengchujin/aerial-tv/issues/1504)) | | LeTV | Super4 X55 (f608) | Android 6 | ✅ Installs, starts at boot, takes over Home; force-stopped ~4 s after switching apps, Back shows the stock launcher for ~4 s; the native boot ad remains ([notes](docs/devices/letv-x4-55.md), [#510](https://github.com/pengchujin/aerial-tv/issues/510)) | | LeTV | Super3 X65 (X65-168CQ) | Android 5.0.1 | ⚠️ Installs and draws; the firmware kills third-party launchers on Home, so takeover is unreliable ([notes](docs/devices/letv-x3-65.md)) | | LeTV | C1S box (reflashed with the c1s v3.0.35s lite firmware) | Android 4.x | ✅ Aerial Lite installs; the stock firmware has no ADB, so it takes a firmware with ADB on ([#1554](https://github.com/pengchujin/aerial-tv/issues/1554)) | | Hisense / Vidda | VIDAA models | Android 5–14 | ⚠️ Home works, most boot into Hisense's home first; VIDAA C1 projector can't be taken over ([notes](docs/devices/hisense-vidaa.md)) | | Hisense | 27GX monitor (MT9655) | Android 14 | ✅ ADB needs To Fac set to M in the factory menu first; the UI is drawn at 1080p ([#1466](https://github.com/pengchujin/aerial-tv/issues/1466) [#1461](https://github.com/pengchujin/aerial-tv/issues/1461)) | | Hisense | 65E52D | Android 8 | ✅ Boots straight into Aerial ([#672](https://github.com/pengchujin/aerial-tv/issues/672)) | | Hisense | 75E3F (VIDAA_TV, n62016) | Android 9 | ✅ Boots straight into Aerial ([#847](https://github.com/pengchujin/aerial-tv/issues/847)) | | Hisense | E5Q Pro | Android 11 | ✅ ([#790](https://github.com/pengchujin/aerial-tv/issues/790)) | | Hisense | 85U7G-PRO (MT9652) | Android 9 | ✅ After installing the APK, the first Home press offers Aerial; pick it and "Always", and the TV boots into Aerial without ADB ([#886](https://github.com/pengchujin/aerial-tv/issues/886)) | | Hisense | VIDAA_TV (MSD6A348) | Android 4.4 | ✅ Aerial Lite from a USB drive; pick it with "Always" at the Home prompt; no brightness ([#769](https://github.com/pengchujin/aerial-tv/issues/769)) | | Hisense | LED47K600X3D (VIDAA_TV, MT5880) | Android 4.0.4 | ⚠️ Aerial Lite installs and boots straight in; the remote's Home, APP and VOD keys open Hisense's own screens through a private path Aerial cannot catch ([#913](https://github.com/pengchujin/aerial-tv/issues/913)) | | Hisense | VIDAA_TV (MT9603 / mt5873) | Android 11 | ✅ Boot, Home, HDMI and wake all land on Aerial ([#1266](https://github.com/pengchujin/aerial-tv/issues/1266)) | | Hisense | VIDAA_TV (MT9655, VX5SPRO) | Android 14 | ✅ Boots straight into Aerial once `persist.sys.boot.source_pkg` is set as in the [notes](docs/devices/hisense-vidaa.md) ([#1495](https://github.com/pengchujin/aerial-tv/issues/1495)) | | Hisense | VIDAA_TV (HZ55E3D-J, Hi3751V551) | Android 7 | ✅ The standard build from a USB drive works ([#1298](https://github.com/pengchujin/aerial-tv/issues/1298)) | | Hisense | HZ55A65 | Android 7 | ✅ Standard build from a USB drive: Home, power-on, standby, inputs, screensaver and the phone page work; volume and brightness not confirmed ([#1545](https://github.com/pengchujin/aerial-tv/issues/1545)) | | Vidda | 65V1R-Pro | Android 14 | ✅ Home, boot, wake, inputs, brightness and the screensaver work ([#1295](https://github.com/pengchujin/aerial-tv/issues/1295)) | | Vidda | VL7R-PRO 4K laser projector (MT9655, mt5877) | Android 14 | ✅ Home managed by guard; boots to stock launcher for ~2s then switches to Aerial; leave com.hisense.screen alone (focus motor) ([notes](docs/devices/hisense-vidaa.md#vidda-vl7r-pro-激光投影仪mt9655mt5877安卓-141605报告人-agent-实测-199), [#1605](https://github.com/pengchujin/aerial-tv/issues/1605)) | | Xiaomi | MiTV-MTTP0 (low RAM) | Android 9 | ✅ Home, boot, wake and inputs pass; a few seconds back to Aerial when memory is tight ([#1285](https://github.com/pengchujin/aerial-tv/issues/1285)) | | Sharp | LCD-50SU671A | Android 6 | ✅ Needs QuickShortcutMaker to open ADB | | Changhong | CHiQ 43Q5T (ZLS70Hi5) | — | ❌ ADB connects but never asks to authorize, and there is no accessibility setting, so Home can't be taken over; installed from a USB drive it works as a plain app ([#1262](https://github.com/pengchujin/aerial-tv/issues/1262)) | | Changhong | Android TV (mst838) | Android 6 | ❌ No `tv_input`, so no inputs; the TV's settings are an overlay on the app in front; the firmware ignores ADB's simulated Home, the real remote was not tried; the owner uninstalled Aerial ([#1531](https://github.com/pengchujin/aerial-tv/issues/1531)) | | Changhong | 65D7H Ultra (MT9655) | Android 14 | ⚠️ ADB never asks to authorize; the reporter made Aerial the default Home through Changhong's own system interface, and Home and wake from standby work; allow Aerial to run in the background in the TV manager, or Back lands on Changhong's launcher ([#1409](https://github.com/pengchujin/aerial-tv/issues/1409)) | | OPPO | K9 | Android 9 | ⚠️ Needs a renamed package ([notes](docs/devices/oppo-coloros-tv.md)) | | XGIMI | Z7X, m7642 | Android 9 | ✅ Z7X needs a third-party tool to open ADB ([notes](docs/devices/xgimi-z7x.md)) | | XGIMI | RS20 Pro Max (XGIMI TV DOHKO, horse_popular) | Android 14 | ✅ Guard takes over Home; standby, restart and Home all return to Aerial; from 1.98 HDMI 1 / 2 switch in one press; the firmware takes the overlay grant back at restart, which does not stop the boot into Aerial; an input as the wallpaper shows no picture (the firmware feeds only its own player) ([#1483](https://github.com/pengchujin/aerial-tv/issues/1483)) | | XGIMI | Z9X 4K Bright (goat_elegant) | Android 13 | ⚠️ Limited test on 1.76: first launch, UID app-op and the front after reboot; boot screen and standby not yet ([notes](docs/devices/xgimi-z9x-4k.md)) | | XGIMI | Lamp L1 (m7642, pig_chivalrous) | Android 9 | ✅ The default Home is lost at boot; the reporter's two-rule fix is in the [notes](docs/devices/xgimi-z7x.md) ([#767](https://github.com/pengchujin/aerial-tv/issues/767)) | | XGIMI | H3S, AG111 (Product_ym01, m7642, pig_chivalrous) | Android 9 | ✅ Standard build with the two-rule fix in the [notes](docs/devices/xgimi-z7x.md) boots straight in; the guard build reaches Aerial about a minute after a restart ([#1336](https://github.com/pengchujin/aerial-tv/issues/1336)) | | XGIMI | H5 (AG122, m7642, pig_chivalrous, firmware xgimi02292304) | Android 9 | ⚠️ After the install command the next restart stays black (the firmware drops the default Home record and the boot stalls); opening XGIMI's launcher once over ADB recovers it. The reporter boots into Aerial with only the rule without DEFAULT plus the guard ([notes](docs/devices/xgimi-z7x.md), [#1357](https://github.com/pengchujin/aerial-tv/issues/1357)) | | XGIMI | Z6X Gen 4 (XK03U / ironman / m7221) | Android 8 | ⚠️ HDMI 1 listing and switching verified, video output not tested; on 2 GB units Aerial is killed in about 15–45 s in the background and the stock Home returns at boot ([notes](docs/devices/xgimi-xk03u-android8.md)) | | XGIMI | H3, m7221 | Android 8 | ✅ Needs a third-party tool to open ADB; boot handover and screensaver match Z7X ([notes](docs/devices/xgimi-h3.md)) | | OBE | X7, X7D projectors | Android 9 / 5.1 | ✅ Home inside HDMI can go to the Apple TV's home screen ([notes](docs/devices/obe-x7.md)) | | OBE | OBE_R3Ultra high-brightness projector (MT5879) | Android 11 | ✅ Developer options show only "USB debugging", and turning it on opens ADB on port 5555; Home first goes to the firmware's Youku launcher, the guard brings Aerial back about 13 s later ([notes](docs/devices/obe-r3-ultra.md)) | | OBE | C2 Ultra projector | Android 9 | ✅ Reported working: Home, power cycle, standby, inputs, volume and brightness, screensaver; ADB is turned on in the stock Android settings, reached from Aerial's Control Center "Settings" once Aerial is installed (#1642) | | Tencent Aurora box | 6 / 6SE / 7S | Android 10 / 14 | ✅ 6 works; ⚠️ 7S stays on the stock home at boot ([notes](docs/devices/tencent-aurora-box.md)) | | Dangbei | Box Max1, H5, HAQU K2 (Dangbei OS) | Android 9 | ✅ | | Dangbei | H3S box (RK3566) | Android 11 | ⚠️ The firmware stops third-party apps on Home; Aerial comes back after 7–12 s ([#849](https://github.com/pengchujin/aerial-tv/issues/849)) | | Dangbei | Box Max1 (DBBOX5C) | Android 11 | ⚠️ Like the H3S, the firmware stops third-party apps on Home; Aerial comes back after about 10 s ([#1245](https://github.com/pengchujin/aerial-tv/issues/1245)) | | Dangbei | DBX5S Pro projector (MT5879) | Android 11 | ⚠️ The network goes down in standby; a cold boot stops on the TV input screen until Home is pressed ([#1453](https://github.com/pengchujin/aerial-tv/issues/1453) [#1454](https://github.com/pengchujin/aerial-tv/issues/1454)) | | Dangbei | F3 projector | Android 6 | ⚠️ Everything works on firmware V2.1.5.2 ([#1145](https://github.com/pengchujin/aerial-tv/issues/1145)); later firmware refuses third-party launchers and has no accessibility service ([#789](https://github.com/pengchujin/aerial-tv/issues/789)) | | China Mobile | CM101s box (Hi3798MV100) | Android 4.4.2 | ✅ Aerial Lite, installed with the one-line command ([#1052](https://github.com/pengchujin/aerial-tv/issues/1052)) | | JMGO | S621 | Android 13 | ❌ The firmware refuses writes to the accessibility setting; Home cannot be taken over ([#793](https://github.com/pengchujin/aerial-tv/issues/793)) | | Epson | DTP9733 projector | Android 11 | ✅ | | Yingke | T8 projector (KKTV-Android-TV-350, RK3128) | Android 7.1 (firmware says 9.0) | ✅ No ADB; standard installed from a USB drive, then press Home, pick Aerial and choose "Always" ([#1706](https://github.com/pengchujin/aerial-tv/issues/1706)) | | Toshiba | 55U3800C (tsbU6800C, MStar m7221) | Android 8 | ✅ Guard build, everything works; if the USB debugging prompt never shows, restart the TV once and turn ADB on again ([#1687](https://github.com/pengchujin/aerial-tv/issues/1687)) | | ZHIYING / RIGAL | HS350 projector (HiSilicon, YunOS) | Android 9 | ⚠️ The firmware stops apps sent to the background; Home from another app takes 10–30 s back to Aerial; installed without the script it needs two grants ([#853](https://github.com/pengchujin/aerial-tv/issues/853)) | | Other boxes | CM311-1 (modified ATV), PPTV K55U27, HK1 Box (S905X3) | Android 9 | ✅ HK1 Box: set Aerial as the default home ([#838](https://github.com/pengchujin/aerial-tv/issues/838)) | | Phicomm | T1 box (S912) | Android 7.1.2 | ✅ Moving down from the first row into all apps stutters a little; Personalize → Effects → Smooth helps ([#876](https://github.com/pengchujin/aerial-tv/issues/876)) | - **Android 4.0–4.4**: [Aerial Lite](#lite) (first release, a beta). - **Not supported**: LG webOS, Samsung Tizen, Huawei Vision (HarmonyOS), and Android older than 4.0. - **Can't open ADB**: old LeTV sets, Honor Vision, old Konka models (no version number to tap). - **Slow or low-memory TVs**: from 1.48 Aerial picks Lite effects on its own (solid panels, no highlights); you can also choose it in Personalize → Effects. ### Installed, but something is off? Help adapt Aerial to your TV Home goes back to the old launcher, standby or a restart ends there, an input opens the wrong port, the brightness slider does nothing. Pick one: **1. Hand it to an agent (easiest)**: send this to an agent that can run commands on your computer. It tests the TV, fixes on the spot what it can (input numbers, say), and writes a report for you to read before it is posted. ```text Please adapt Aerial to my TV, following https://aerial.qust.me/en/adapt.md TV IP: What is wrong: Read the whole guide first, then run the commands on my computer yourself instead of listing them. Ask me before a standby test or restarting the TV; do not uninstall or disable any system app. Show me the finished report, and post it to GitHub only once I agree. ``` **2. Send it from your phone**: Control Center → Personalize, scan the QR code, and at the bottom of the phone page choose Report a Problem → Show Diagnostics → Report on GitHub. The model and the version fill the [device support form](https://github.com/pengchujin/aerial-tv/issues/new?template=device.yml), and the diagnostics are copied for you to paste. On a computer you can also run `curl -fsSL https://aerial.qust.me/tools/report.sh | TV= bash` (reads only) and `curl -fsSL https://aerial.qust.me/tools/selftest.sh | TV= bash` (presses Home, opens the settings, checks that Aerial comes back) and paste both into the form. The diagnostics hold no accounts, addresses, Wi-Fi names or app lists. If your TV just works, tell others with the [works-on-my-TV form](https://github.com/pengchujin/aerial-tv/issues/new?template=works.yml). ## Development Needs JDK 17 and Android SDK 36. ```bash ./gradlew assembleStandardRelease assembleGuardRelease BUILD=1 KEEP_ADB=1 TV= tools/install.sh ``` See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for the code, [HANDOFF.md](docs/HANDOFF.md) for the current state and rules, and [docs/devices/](docs/devices/) for notes on each TV. ## License [MIT](LICENSE). The Inter font is under the [SIL Open Font License](FONT-LICENSE-OFL.txt). System app icons use [Material Symbols](https://github.com/google/material-design-icons) (Apache 2.0). The icon library's pictures belong to their authors: the set by [le5inioo](https://github.com/le5inioo) comes from [#706](https://github.com/pengchujin/aerial-tv/issues/706) (originals and names in his [aerial-mitv-mftr0](https://github.com/le5inioo/aerial-mitv-mftr0/tree/main/docs/tile-icons), MIT); the tvOS icons and Dangbei Launcher's pictures belong to each app and to Dangbei. The phone page names the source of every picture. The list of Chinese cities for the weather is from [GeoNames](https://www.geonames.org) (CC BY 4.0), the weather from [Open-Meteo](https://open-meteo.com). Aerial is an independent open-source project, not affiliated with Apple, Xiaomi, TCL or any other company. The aerial films belong to Apple and play from Apple's servers; the photo of the day comes from Bing.