Skip to content

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

examples: add Haier MatrixTV BE TV list and remote notes

Moeez Nadeemd62b3ce551f4
diff --git a/examples/haier-matrixtv-be/README.md b/examples/haier-matrixtv-be/README.md
new file mode 100644
index 000000000..3345766b9
--- /dev/null
+++ b/examples/haier-matrixtv-be/README.md
@@ -0,0 +1,94 @@
+# Haier MatrixTV BE (Google TV 14)
+
+One Haier MatrixTV BE on firmware `UKNV.260313.001` was checked from 31 October to
+1 November 2026. This was a short trial with one reboot, not a multi-day soak.
+The owner reported that Home, streaming, Live TV, HDMI, Wi-Fi and the physical
+remote buttons used below were working after the cleanup. The package list and
+the CleanYourTV launcher both worked on this set.
+
+| File | Purpose |
+|---|---|
+| `debloat.txt` | The 9 TV packages confirmed disabled, with choices and restore notes |
+| `config.json` | Four dock apps and the two physical remote-button mappings |
+
+The stock Home is `com.google.android.apps.tv.launcherx`; Live TV is
+`com.mediatek.wwtv.tvcenter`. The install script disables stock Home only after
+the replacement launcher starts. The list does not disable Live TV, HDMI/input
+services, remote pairing, Play Store, voice search, Chromecast or firmware updates.
+The owner kept TV Housekeeper. HaiCast/Miracast was disabled by owner choice;
+comment out that line if you use screen mirroring. Chromecast was left enabled,
+but casting itself was not separately tested.
+
+## Apply and undo
+
+Run commands from the repository root. First check whether
+`com.google.android.tungsten.setupwraith` owns any saved Wi-Fi network: disabling
+it may remove that network and cut off ADB. The connected Wi-Fi remained usable
+on the tested set. Keep the TV's own recovery path available before changing Home.
+
+```bash
+TV_HOST=YOUR_TV_IP tools/disable.sh examples/haier-matrixtv-be/debloat.txt
+INPUT_KEY_SERVICE=1 TV_HOST=YOUR_TV_IP launcher/build-and-install.sh
+TV_HOST=YOUR_TV_IP tools/theme.sh examples/haier-matrixtv-be
+```
+
+The last line pushes the example dock and key mappings. A pushed theme replaces
+the previous theme; the owner used a private copy of `themes/scenes` with these
+mappings and `dock_glass: true` for the final look.
+
+To restore the recorded package and Home state, turn off CleanYourTV's
+InputKeyService under the TV's Accessibility settings, then run:
+
+```bash
+TV_HOST=YOUR_TV_IP tools/restore.sh examples/haier-matrixtv-be/debloat.txt com.google.android.apps.tv.launcherx
+```
+
+The original stock Home is passed explicitly because it is disabled by
+`launcher/build-and-install.sh`, not by `debloat.txt`. The service can otherwise
+keep filtering keys even after stock Home returns. The test set's private
+recovery record also covers the few personally chosen apps that are not in
+this shareable list.
+
+## Physical remote keys
+
+These results came from the real remote and a temporary Android key listener,
+which was removed after measurement. The Linux events alone were not enough:
+two buttons have the same Android scancode but different Android keycodes.
+
+| Button | Raw event on this set | Android key | Tested result |
+|---|---|---|---|
+| TV | `MSC_SCAN 000c006f`, Linux `KEY_BRIGHTNESSUP` / scan 225 | Scan 225 in the launcher mapping | Opens `com.mediatek.wwtv.tvcenter` (Live TV) |
+| Settings gear | `MSC_SCAN 000c009f`, Linux `KEY_UNKNOWN` | `KEYCODE_NOTIFICATION` (83), scan 240 | Opens CleanYourTV's quick settings panel |
+| Three-line button | `MSC_SCAN 000c0071`, Linux `KEY_UNKNOWN` | `KEYCODE_3D_MODE` (206), scan 240 | Distinct from gear; leave unmapped here |
+
+Do **not** map Android scan 240 to Settings or Live TV: both gear and
+three-line buttons use it. The working configuration maps keycode 83 to
+`com.gathin.tvhome/.QuickSettingsActivity` and Linux scan 225 to Live TV in
+`app_keys`. `settings_key_panel: true` is also set. A mapping to the
+`settings` action opened full TV Settings instead of the quick panel while
+InputKeyService was the active helper.
+
+With InputKeyService filtering keys, holding Volume Up or Down moved volume
+only one step on this set. `consume_volume_keys: true` was tried and did not
+restore held repeat. The owner chose to keep the working TV and Settings
+shortcuts and press Volume repeatedly. Turning the key helper off restores
+held repeat but removes these two shortcuts.
+
+The on-screen Home Settings chip was separately fixed in the owner's local
+launcher build to honor `settings_key_panel`. That one-line launcher fix is
+not in this TV-list folder; on the unmodified upstream launcher, the chip
+still opens full TV Settings. The physical gear mapping above works with
+the upstream launcher and the example config.
+
+## Other observations
+
+- The new Home remained selected after one reboot. Haier TV+ /
+ `com.haier.launcher.haiermatrix` was re-enabled by the firmware during that
+ reboot and was disabled again at the owner's request. It may need rechecking
+ after later reboots; it is not Google TV's stock Home.
+- The launcher opened YouTube and Netflix from the dock, HDMI 1 and Live TV
+ from Inputs, and Settings and Wi-Fi from its top bar.
+- `com.release.aryzaptv` was disabled in the initial run but appeared enabled
+ in a later check, so its persistence is unknown and it is excluded here.
+ A user-installed game was also disabled by personal choice and excluded.
+- TalkBack was already disabled before cleanup and is not in this list.
\ No newline at end of file
diff --git a/examples/haier-matrixtv-be/config.json b/examples/haier-matrixtv-be/config.json
new file mode 100644
index 000000000..743793e63
--- /dev/null
+++ b/examples/haier-matrixtv-be/config.json
@@ -0,0 +1,16 @@
+{
+ "dock_apps": [
+ "com.netflix.ninja",
+ "com.amazon.amazonvideo.livingroom",
+ "com.google.android.youtube.tv",
+ "com.spotify.tv.android"
+ ],
+ "columns": 4,
+ "fill_dock": false,
+ "live_tv_package": "com.mediatek.wwtv.tvcenter",
+ "settings_key_panel": true,
+ "app_keys": [
+ "scan:225:com.mediatek.wwtv.tvcenter",
+ "KEYCODE_NOTIFICATION:com.gathin.tvhome/.QuickSettingsActivity"
+ ]
+}
\ No newline at end of file
diff --git a/examples/haier-matrixtv-be/debloat.txt b/examples/haier-matrixtv-be/debloat.txt
new file mode 100644
index 000000000..112d1f0e6
--- /dev/null
+++ b/examples/haier-matrixtv-be/debloat.txt
@@ -0,0 +1,44 @@
+# Haier MatrixTV BE, Google TV 14, firmware UKNV.260313.001.
+# Tested on one set from 31 October to 1 November 2026, including one reboot and real remote checks.
+# Short trial, not a multi-day soak. Re-check this list against your own firmware and app choices.
+#
+# Apply: TV_HOST=YOUR_TV_IP tools/disable.sh examples/haier-matrixtv-be/debloat.txt
+# Undo: TV_HOST=YOUR_TV_IP tools/restore.sh examples/haier-matrixtv-be/debloat.txt com.google.android.apps.tv.launcherx
+# Every active line disables one package for user 0; nothing is uninstalled.
+#
+# Stock Home: com.google.android.apps.tv.launcherx (.home.HomeActivity).
+# The launcher install script disables stock Home only after the new Home starts; it is not in this list.
+# Live TV: com.mediatek.wwtv.tvcenter.
+#
+# Check saved Wi-Fi ownership before disabling setupwraith. On the tested set, the connected
+# Wi-Fi remained available after this package was disabled. A different network created by
+# setupwraith could be removed with it, cutting off network ADB.
+#
+# KEEP: com.haier.appmanager.dispatcher, com.haier.hkcfac, com.haier.tv.hmagicboard
+# (remote hot keys/sound settings); com.mediatek.wwtv.tvcenter, com.mediatek.tvinput and
+# com.mediatek.tv.service (Live TV and inputs); com.mediatek.autopair and
+# com.haier.bt_pair_tips (remote pairing); com.telink.lt.ota (remote firmware).
+# The owner also kept TV Housekeeper, voice search, Chromecast, Play Store and firmware updates.
+#
+# Haier content and smart-device service.
+com.haierubic.usmartdevice # Haier smart-device / IoT service, unused by owner
+com.haier.apps # Haier content/promo app
+com.haier.emanual # on-TV manual
+com.haier.launcher.haiermatrix # Haier TV+ / Zeasn launcher, not Google TV Home; re-enabled itself after one reboot
+
+# Casting choice: this is HaiCast/Miracast, not Google's Chromecast package.
+# Comment this out if you use phone screen mirroring.
+com.mediatek.androidbox # HaiCast/Miracast, unused by owner
+
+# Stock-home partner rows, feedback and retail demo.
+com.mediatek.android.leanbacklauncher.partnercustomizer # partner rows on stock Home
+com.google.android.feedback # usage feedback
+fusion.android.tv.demo # retail demo
+
+# Google TV setup recovery claims HOME alongside the stock launcher. Disable only after
+# checking Wi-Fi ownership; tools/disable.sh applies that guard.
+com.google.android.tungsten.setupwraith
+
+# Excluded: com.release.aryzaptv was disabled initially but appeared enabled in a later check;
+# its persistence was not established. A user-installed game was also disabled only by choice.
+# TalkBack was already disabled before cleanup. None belongs in this tested model list.
\ No newline at end of file
diff --git a/examples/haier-matrixtv-be/tv.json b/examples/haier-matrixtv-be/tv.json
new file mode 100644
index 000000000..029482759
--- /dev/null
+++ b/examples/haier-matrixtv-be/tv.json
@@ -0,0 +1,6 @@
+{
+ "tv": "Haier MatrixTV BE",
+ "os": "Google TV 14",
+ "brand": "Haier",
+ "notes": "Haier content and IoT, partner rows and demo off; HaiCast off by owner choice, Chromecast kept; gear keycode 83 and three-line keycode 206 share scan 240, TV key is Linux scan 225; InputKeyService restores gear/TV shortcuts but held volume moves one step; short trial"
+}
\ No newline at end of file