Skip to content

Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

3.1 KB
Raw Blame

HY320 Projector — CleanYourTV Setup

Device

  • Model: HY320 projector (t950s_be311, Google-certified Android TV)
  • Android: 13 (SDK 33)
  • Firmware: be311-13 TQ2A.20250729 06:21:20.E1
  • Resolution: 1280x720, 213dpi

What was done

  1. Debloated 23 packages — ad services, app stores, background junk, unused preloaded apps
  2. Installed Apple TV-style launcher (com.gathin.tvhome) with dock: Netflix, YouTube, Wave IPTV, MX Player
  3. Set launcher as default home, disabled stock launcher (com.htc.htclauncherhighenglishd08)
  4. Enabled AdGuard Private DNS for ad blocking

Re-enable an app

TV_HOST=<tv ip> tools/venv/bin/python tools/tv.py 'pm enable --user 0 <package>'

Restore everything (undo the debloat)

TV_HOST=<tv ip> tools/restore.sh examples/hy320/debloat.txt com.htc.htclauncherhighenglishd08

The stock launcher is passed because tools/restore.sh otherwise gives Home back to com.google.android.tvlauncher, the Android TV default, which this projector does not ship - so the set would come back from an undo with no Home at all.

Rebuild and reinstall the launcher

cd launcher
JAVA_HOME=/opt/homebrew/opt/openjdk@17 ANDROID_HOME=/opt/homebrew/share/android-commandlinetools \
  TV_HOST=<tv ip> STOCK_LAUNCHER=none bash build-and-install.sh

STOCK_LAUNCHER=none because this set's stock launcher, com.htc.htclauncherhighenglishd08, is not one of the launchers build-and-install.sh recognises: without it the script stops at "not a stock launcher this script knows". Home is then set by hand, and the stock launcher stays as a fallback:

TV_HOST=<tv ip> tools/venv/bin/python tools/tv.py 'cmd package set-home-activity com.gathin.tvhome/.MainActivity'

Change dock apps or order

Edit launcher/app/src/main/res/values/config.xml, the dock_apps array, then rebuild. Or push a theme: edit examples/hy320/config.json and run:

TV_HOST=<tv ip> tools/theme.sh examples/hy320/config.json

Change wallpaper

Set wallpaper: true in config.json and add a wallpaper image, or use a theme folder under themes/.

AdGuard Private DNS works on this TV.

Firmware note: HOME.JM

This projector's firmware routes the Home key through a custom android.intent.category.HOME.JM category, from the JM launcher that was preloaded. The launcher in this repository does not declare it: MainActivity answers android.intent.category.HOME, DEFAULT and LEANBACK_LAUNCHER, and grep -rn HOME.JM launcher/ finds nothing - so from a clean checkout the Home key does not reach the launcher and lands on FallbackHome. The unit in this folder ran with a filter of its own added to the manifest, which is not in this repository; making such a filter part of the launcher is a change to the Home path and is open as #1799, and when it lands this note goes away.

Security

This TV has ro.adb.secure unset, meaning port 5555 accepts any device on the network without a prompt. ADB was left open during setup. When done, turn off USB debugging and Network/ADB debugging on the TV (Settings > Developer Options), revoke USB debugging authorisations, and reboot. Verify with:

tools/adb-closed.py <tv ip>