Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.
Python adbadblockandroid-tvandroid-tv-launcherapple-tvbloatware-removalclaude-codedebloatfire-tvgoogle-tvlauncherprivacysmart-tvsony-braviatclvibe-codingxiaomi
examples: add TCL G06 (G06_2K_US, MT9221) on US firmware, Google TV 11, with the launcher
Adam Hansen3e118741e8d2
diff --git a/examples/tcl-g06-us-google-tv/README.md b/examples/tcl-g06-us-google-tv/README.mdnew file mode 100644index 000000000..efdd091b1--- /dev/null+++ b/examples/tcl-g06-us-google-tv/README.md@@ -0,0 +1,77 @@+# TCL Smart TV, G06 (Google TV 11, US firmware)++MediaTek MT9221 board (device `G06`, product `G06_2K_US`), build AR2101 / AR38, TCL software+V8-T221T04-LF1V122. Both halves work: the debloat list and the Clean Your TV launcher as Home, with+Google TV's home kept behind it for the remote's app buttons. Tested on 31 October 2026.++| File | What it is |+|---|---|+| `debloat.txt` | The 22 packages that were disabled, grouped and commented, with what to keep and why |+| `config.json` | Dock order, the hidden Live TV tile and the launcherx redirect; push it with `tools/theme.sh` |++All commands run from the repo root, with the TV's IP in `TV_HOST`.++## Turning ADB on++This firmware has no Wireless debugging. Settings → Device Preferences → About → press OK on **Build**+7 times, then Developer options → **USB debugging**. That alone opens port 5555 over Wi-Fi; no cable is+needed. Accept the "Allow USB debugging?" prompt on the TV the first time `tools/tv.py` connects.++## Install++1. **Move the Wi-Fi network away from the setup wizard first.** The network saved during first setup+ belongs to `com.google.android.tungsten.setupwraith`, and Android deletes it when setupwraith is+ disabled. On the TV: Settings → Network & Internet → your network → Forget, then join it again. Check+ with `tools/tv.py "dumpsys wifi | grep -o 'cname=[^ ]*'"`: setupwraith should no longer appear.+2. Run:++```bash+TV_HOST=<tv ip> tools/disable.sh examples/tcl-g06-us-google-tv/debloat.txt+TV_HOST=<tv ip> HOME_KEY_SERVICE=1 launcher/build-and-install.sh+TV_HOST=<tv ip> tools/theme.sh examples/tcl-g06-us-google-tv+TV_HOST=<tv ip> tools/tv.py 'pm enable com.google.android.apps.tv.launcherx'+```++Wait about a minute before rebooting: on this platform a reboot straight after `pm disable-user` can bring+the last batch back.++## Remote buttons (TCL_RC902N_M1, Bluetooth)++The YouTube and Prime Video buttons send TCL key codes (4065 and 4099) that only launcherx answers, and+the gear button opened the TV settings only with launcherx enabled. With launcherx disabled all three did+nothing. So `build-and-install.sh` disables launcherx, and the last command above enables it again.+`config.json` then sets `"stock_home_redirect": "com.google.android.apps.tv.launcherx"` and+`"key_filter": false`: the launcher's helper sends Home back to the new launcher whenever launcherx's+home comes up, without filtering keys.++Checked on the real remote with this setup: Home, Back, the D-pad, volume (holding Volume Up still ramps),+Input, the mic (voice search), YouTube, Prime Video and the gear (TV settings). Pressing Home can show+launcherx for a moment before the new launcher. The small TV (guide) button offered a picker for what it+should do; the owner set it to Plex there.++Still dead: the bookmark button (Google TV's watchlist, answered only on launcherx's own home screen) and+the buttons whose apps the list disables: Netflix, TCL Channel and the dashboard button. Mapping them with+`app_keys` needs `key_filter` on, which costs the held-key volume ramp on TCL sets like+[the G09](../../docs/devices/tcl-55p71b-g09-key-repeat.md); the owner kept the ramp.++## Re-enable an app++```bash+TV_HOST=<tv ip> tools/tv.py 'pm enable com.netflix.ninja'+```++To put everything back and give Home to launcherx again:++```bash+TV_HOST=<tv ip> tools/restore.sh examples/tcl-g06-us-google-tv/debloat.txt com.google.android.apps.tv.launcherx+TV_HOST=<tv ip> tools/theme.sh --reset+```++## When you are done++Revoke the USB debugging authorisations, switch **USB debugging** off in Developer options, restart, and+check that ADB is closed:++```bash+tools/venv/bin/python tools/adb-closed.py <tv ip>+```diff --git a/examples/tcl-g06-us-google-tv/config.json b/examples/tcl-g06-us-google-tv/config.jsonnew file mode 100644index 000000000..57c756a06--- /dev/null+++ b/examples/tcl-g06-us-google-tv/config.json@@ -0,0 +1,17 @@+{+ "dock_apps": [+ "com.plexapp.android",+ "com.google.android.youtube.tv",+ "com.collegehumor.chdropout",+ "com.spotify.tv.android"+ ],+ "hidden_apps": [+ "com.tcl.tv"+ ],+ "live_tv_package": "",+ "columns": 4,+ "rows_below_dock": 0,+ "reduced_motion": true,+ "key_filter": false,+ "stock_home_redirect": "com.google.android.apps.tv.launcherx"+}diff --git a/examples/tcl-g06-us-google-tv/debloat.txt b/examples/tcl-g06-us-google-tv/debloat.txtnew file mode 100644index 000000000..4430a36ae--- /dev/null+++ b/examples/tcl-g06-us-google-tv/debloat.txt@@ -0,0 +1,74 @@+# TCL Smart TV (device G06, product G06_2K_US, model "Smart TV"), US firmware: Google TV 11 (Android TV 11, SDK 30),+# build AR2101 / AR38, TCL software V8-T221T04-LF1V122, security patch 2026-03-05, kernel 4.19.116+.+# MediaTek MT9221 (ro.board.platform mt5867), 1.4 GB RAM (low_ram=true), 1280x720 UI, ro.adb.secure=1.+# Fingerprint: TCL/G06_2K_US/G06:11/AR2101/AR38:user/release-keys+#+# Apply: TV_HOST=<tv ip> tools/disable.sh examples/tcl-g06-us-google-tv/debloat.txt+# Undo: TV_HOST=<tv ip> tools/restore.sh examples/tcl-g06-us-google-tv/debloat.txt com.google.android.apps.tv.launcherx+# Everything is DISABLED, not uninstalled. Comment out any line you want to keep.+#+# Same G06 board as examples/tcl-g06-google-tv-indonesia, on the US (T04) firmware line, with the launcher+# half done too. Stock launcher: com.google.android.apps.tv.launcherx. HOME claimants on stock: launcherx,+# com.google.android.tungsten.setupwraith/.RecoveryActivity and com.android.tv.settings/.system.FallbackHome.+# Live TV / HDMI: com.tcl.tv + com.tcl.tvinput (four HDMI ports registered, AV, tuner).+#+# KEEP (left enabled and working on this unit):+# - com.tcl.tv com.tcl.tvinput: Live TV, HDMI and the source picker; com.tcl.tv also answers the guide button.+# - com.tcl.suspension (Input key / Quick Panel), com.tcl.system.server, com.tcl.keyhelp (remote keys),+# com.tcl.tcl_bt_rcu_service, com.tcl.autopair (Bluetooth remote), com.tcl.settings, com.tcl.providers.config,+# com.tcl.initsetup, com.tcl.factory.view (never launch it), com.tcl.common.shortcutmenu (not tried).+# - com.tcl.ttvs: firmware updater on AR2101 (it also logs remote key presses); kept by the owner.+# - Kept by the owner's choice: Chromecast (com.google.android.apps.mediashell), the voice assistant+# (com.google.android.katniss, com.google.android.tv.assistant, com.tcl.micmanager and+# com.google.android.tv.remote.service), Prime Video, YouTube, YouTube Music, the USB media player.+# - No com.mediatek.tv.service on this build, so the #2138 reason for keeping com.tcl.partnercustomizer+# does not apply here; it is disabled below, as on the Indonesia unit.+#+# Notes from this unit (one session on 2026-10-31, verified with screenshots; one day, shorter than+# CONTRIBUTING.md asks):+# - No Wireless debugging on this firmware: USB debugging alone opens port 5555 over Wi-Fi. The TV asks to+# allow the computer's key once.+# - The saved Wi-Fi belonged to setupwraith (dumpsys wifi showed four entries with+# cname=com.google.android.tungsten.setupwraith). The owner forgot the network and joined it again in Settings+# (owner became com.android.tv.settings); setupwraith was then disabled with Wi-Fi and ADB staying up.+# - Casting from a phone still worked after a reboot with setupwraith disabled.+# - Wait about a minute after the last batch before rebooting, as on the other AR2101 lists.+# - com.tcl.smartalexa and com.tcl.usercenter are switched back on at every boot (as on the 40S5400A and+# 32ES570F); both stay idle, so they are commented out below rather than disabled again at each boot.+# - Launcher: launcher/ became Home (mFocusedApp = com.gathin.tvhome after Home and after a reboot). The+# YouTube and Prime Video buttons are broadcasts only launcherx answers (as on examples/tcl-g03-google-tv), so+# launcherx is enabled again behind "stock_home_redirect" with "key_filter": false; see README.md.+# - Reboot-checked twice: everything listed stays disabled, Home and the helper survive, Wi-Fi stays connected.++# Batch 1: TCL promos, popups and telemetry; Google partner plumbing+com.tcl.esticker # store-demo sticker+com.tcl.partnercustomizer # promo rows (see KEEP note on #2138)+com.tcl.messagebox # TCL messages/popups+com.tcl.dashboard # TCL Home panel; the remote's dashboard button goes dead with it+com.tcl.useragreement+com.tcl.guard # TGuard cleaner+com.tcl.copydatatotv # copy-data utility+# com.tcl.usercenter # TCL account, switched back on at every boot (idle)+# com.tcl.smartalexa # Alexa bridge, switched back on at every boot (idle)+com.google.android.partnersetup # partner attribution+com.google.android.feedback+com.google.android.onetimeinitializer+com.google.android.syncadapters.calendar+com.google.android.apps.nbu.smartconnect.tv # data-saver VPN+android.autoinstalls.config.google.gtvpai # partner auto-installs++# Batch 2: preloads, off by the owner's choice+com.tcl.channelplus # TCL Live FAST channels (a Live TV input)+com.tcl.tv.tclchannel # TCL Channel; the remote's TCL Channel button goes dead with it+com.tcl.tv.plus # TCL TV+ free channels+com.netflix.ninja # Netflix; the remote's Netflix button goes dead with it+com.google.android.videos # Play Movies+com.google.android.play.games+com.google.android.marvin.talkback # TalkBack+com.tcl.t_solo # Bluetooth "listen alone"++# Disabling setupwraith gives Home to a new launcher but can break casting (Chromecast built-in) on some+# sets; casting kept working on this one. Comment out its line if you want to keep the stock setup.+# Batch 3: launcher handover. It owned the Wi-Fi saved at setup on this unit: forget the network and join it+# again in Settings first, or disabling it deletes the network.+com.google.android.tungsten.setupwraithdiff --git a/examples/tcl-g06-us-google-tv/tv.json b/examples/tcl-g06-us-google-tv/tv.jsonnew file mode 100644index 000000000..39968dc82--- /dev/null+++ b/examples/tcl-g06-us-google-tv/tv.json@@ -0,0 +1,6 @@+{+ "tv": "TCL Smart TV (G06, G06_2K_US, MediaTek MT9221 / T221, AR2101, V8-T221T04-LF1V122), US firmware",+ "os": "Google TV 11",+ "brand": "TCL",+ "notes": "Same G06 board as the Indonesia list, US T04 firmware, with the launcher half: TCL promos, popups, dashboard, TGuard, Google partner plumbing, TCL Live/Channel/TV+, Netflix, Play Movies, Play Games and TalkBack off; ttvs, Chromecast (still casts with setupwraith off), voice and Prime Video kept; USB debugging alone opens ADB; setupwraith owned the Wi-Fi (forget and re-join); launcherx kept behind stock_home_redirect so the YouTube and Prime Video buttons and the volume ramp work; config.json dock; reboot-checked"+}