Skip to content

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

examples: add XGIMI RS10 Ultra projector (pig_chivalrous, MediaTek m7642), Android 9

jandyx9a490e4ef0fb
diff --git a/examples/xgimi-rs10-ultra/README.md b/examples/xgimi-rs10-ultra/README.md
new file mode 100644
index 000000000..119c96cfe
--- /dev/null
+++ b/examples/xgimi-rs10-ultra/README.md
@@ -0,0 +1,148 @@
+# XGIMI RS10 Ultra projector (Android 9)
+
+Tested on an XGIMI RS10 Ultra projector (`ro.product.model=XGIMI TV`, `ro.product.device=pig_chivalrous`)
+on the MediaTek m7642 board, Android 9 / SDK 28, build `PPR2.180905.006.A1` (`xgimi10101741`), China
+GMUI 6 firmware. 4 GB RAM (`dumpsys meminfo` reports 3,714,636 kB total), 106 packages, none disabled
+from the factory.
+
+**How much testing is behind it:** one session on 2026-10-31 with four reboots, not the several days
+[CONTRIBUTING](../../CONTRIBUTING.md) asks for. Every package was applied in five batches with a
+screenshot between them; the launcher, HDMI 1/2, Settings, Wi-Fi and the app library were checked after
+the reboot.
+
+## What this folder contains
+
+| File | What it is |
+|---|---|
+| `debloat.txt` | The 21 packages that were disabled, grouped and commented; `com.xgimi.upgrade` is commented out so the default list keeps OTA |
+| `config.json` | The author's dock (SmartTube, Netflix, VidHub), 4 columns, no fill, `stock_home_redirect`, `key_filter` false, the HDMI input action and the two LAUNCHER-only tiles |
+| `tv.json` | Entry for the supported-TV index |
+| `README.md` | Notes for this firmware: ADB, Settings, Home handover, dock |
+
+## Critical notes for this TV
+
+1. **No working ADB toggle.** Developer options and the factory menu do not expose a working ADB
+ switch on this build. ADB was opened with a local helper running the two `setprop` commands below.
+ Do not launch the factory packages (`mediatek.factorymenu.ui`, `com.xgimi.minitvfactory`) to look
+ for one; the repository's rules forbid starting factory/test packages. The firmware reports
+ `ro.adb.secure=0`: while adbd runs, any device on the LAN has a shell. Stop it with
+ `setprop ctl.stop adbd` or a reboot when you are done.
+2. **The stock home comes back.** `com.xgimi.xrmservice` re-enables `com.xgimi.home` on its remote
+ keys. `stock_home_redirect=com.xgimi.home` with `HOME_KEY_SERVICE=1` sends its home screen back to
+ the new launcher; the stock launcher itself is disabled by `launcher/build-and-install.sh`.
+3. **`HomeKeyService` is dropped on every boot.** `restore_key_services: true` did not put it back
+ (four reboots); the author's BOOT_COMPLETED helper re-adds it. Without that helper, re-add it over
+ ADB after a reboot (command below).
+4. **Settings is a service window, not an Activity.** The launcher's Settings pill needs a small
+ helper activity in `settings_fallback_components`; that key is `config.xml` only, so a theme push
+ cannot carry it.
+5. **HDMI:** `input_action=com.xgimi.action.hdmiPlayer` opens
+ `com.xgimi.xhplayer/.InputActivity`. `xhplayer` is hidden from Home in `config.json` but the
+ Inputs menu still opens it.
+6. **LAUNCHER-only apps:** 极米投屏 and File Manager have a LAUNCHER entry but no LEANBACK entry;
+ `library_apps` seeds them or the launcher does not list them.
+7. **OTA:** `com.xgimi.upgrade` is commented out so the default list keeps updates; the author's TV
+ disables it by choice (uncomment it to match).
+8. **Screensaver:** `com.xgimi.atmosphere` is disabled in the list; the author uses Aerial Views, with
+ the launcher's Clock screensaver as the fallback.
+
+## Apply
+
+```sh
+TV_HOST=<tv ip> tools/disable.sh examples/xgimi-rs10-ultra/debloat.txt
+```
+
+Windows:
+
+```powershell
+tools\disable.ps1 -TvHost <tv ip> examples\xgimi-rs10-ultra\debloat.txt
+```
+
+## Launcher and Home
+
+Install the launcher after the list. The stock home is disabled by the install script, not by the list:
+
+```sh
+TV_HOST=<tv ip> HOME_KEY_SERVICE=1 RESTORE_KEY_SERVICES=1 STOCK_LAUNCHER=com.xgimi.home launcher/build-and-install.sh
+```
+
+`stock_home_redirect=com.xgimi.home` in `config.json` and `HOME_KEY_SERVICE=1` hold Home:
+`com.xgimi.xrmservice` re-enables `com.xgimi.home` on its remote keys, and the redirect sends its home
+screen back to the new launcher. The stock home is
+`com.xgimi.home/com.xgimi.module.cellview.home.ui.HomeActivity`.
+
+## ADB on this firmware
+
+Developer options and the factory menu do not expose a working ADB switch on this build. ADB was
+opened by running these two commands from a small local helper activity (not part of this repository):
+
+```sh
+setprop service.adb.tcp.port 5555
+setprop ctl.start adbd
+```
+
+The unit then answers `adb connect <projector ip>:5555` and `tools/tv.py`. Do not launch the factory
+packages (`mediatek.factorymenu.ui`, `com.xgimi.minitvfactory`) to look for a switch; the repository's
+rules forbid starting factory/test packages. The firmware reports `ro.adb.secure=0`: while adbd is
+running, any device on the LAN has a shell. Stop it with `setprop ctl.stop adbd` or a reboot when you
+are done.
+
+## Settings is a service window
+
+`com.android.newsettings` has no `android.settings.SETTINGS` activity; its Settings UI is a floating
+service window:
+
+```sh
+am startservice -n com.android.newsettings/com.xgimi.newsettings.SettingService \
+ -a com.xgimi.settings.SETTINGS -d 'Settings://com.xgimi.settings/main'
+```
+
+The launcher's Settings pill falls back to `settings_fallback_components`; that key is `config.xml` only,
+so set it to a small helper activity that starts the service above before building. The author used a
+local helper; the app library still lists the Settings app, and the XGIMI settings entry can also be
+opened from the app library.
+
+## HomeKeyService on every boot
+
+GMUI 9 drops `com.gathin.tvhome/.HomeKeyService` from `enabled_accessibility_services` on every boot.
+`restore_key_services: true` did not put it back (tested across four reboots); the author's helper
+re-adds it from a BOOT_COMPLETED receiver. Without that helper, after a reboot re-enable it over ADB:
+
+```sh
+settings put secure enabled_accessibility_services "com.xgimi.duertts/com.xgimi.duertts.MonitorService:com.gathin.tvhome/.HomeKeyService"
+settings put secure accessibility_enabled 1
+```
+
+`com.xgimi.duertts` is the existing voice/TTS service; keep it in the list.
+
+## Inputs and the dock
+
+- HDMI 1 (connected) and HDMI 2 open in `com.xgimi.xhplayer/.InputActivity`;
+ `input_action=com.xgimi.action.hdmiPlayer`.
+- `config.json` pins SmartTube, Netflix and VidHub; `fill_dock=false` leaves the fourth 4-column slot
+ empty. Dangbei Market is not in the dock.
+- `library_apps` seeds 极米投屏 (`com.xgimi.wirelessscreen`) and File Manager
+ (`com.xgimi.filemanager`): both have a LAUNCHER entry but no LEANBACK entry, so the launcher would
+ otherwise not list them.
+- The author uses Aerial Views as the system screensaver; `com.xgimi.atmosphere` is disabled in the
+ list. The launcher's own Clock screensaver remains a fallback.
+
+## OTA
+
+`com.xgimi.upgrade` is commented out in `debloat.txt` so the default list keeps firmware updates. The
+author's TV disables it by choice; uncomment the line and re-run `tools/disable.sh` for the same. The
+XGIMI store/account/payment packages are disabled by the owner's choice in the list.
+
+## Restore
+
+```sh
+TV_HOST=<tv ip> tools/restore.sh examples/xgimi-rs10-ultra/debloat.txt com.xgimi.home
+```
+
+Windows:
+
+```powershell
+tools\restore.ps1 -TvHost <tv ip> examples\xgimi-rs10-ultra\debloat.txt -Stock com.xgimi.home
+```
+
+The Undo line in `debloat.txt` passes the same `com.xgimi.home`.
diff --git a/examples/xgimi-rs10-ultra/config.json b/examples/xgimi-rs10-ultra/config.json
new file mode 100644
index 000000000..b96c04c7d
--- /dev/null
+++ b/examples/xgimi-rs10-ultra/config.json
@@ -0,0 +1,51 @@
+{
+ "dock_apps": [
+ "org.smarttube.stable",
+ "com.netflix.ninja",
+ "com.oumi.utility.media.hub"
+ ],
+ "columns": 4,
+ "fill_dock": false,
+ "live_tv_package": "",
+ "input_action": "com.xgimi.action.hdmiPlayer",
+ "stock_home_redirect": "com.xgimi.home",
+ "key_filter": false,
+ "restore_key_services": true,
+ "app_library": true,
+ "tile_menu": true,
+ "rows_below_dock": 0,
+ "library_apps": [
+ "com.xgimi.wirelessscreen",
+ "com.xgimi.filemanager"
+ ],
+ "hidden_apps": [
+ "com.xgimi.home",
+ "com.android.newsettings",
+ "com.xgimi.newappmarket",
+ "com.xgimi.account",
+ "com.xgimi.user",
+ "com.xgimi.payview",
+ "com.xgimi.upgrade",
+ "com.xgimi.adservice",
+ "com.xgimi.instruction30",
+ "com.xgimi.bootwizard",
+ "com.xgimi.minitvfactory",
+ "mediatek.factorymenu.ui",
+ "com.xgimi.atmosphere",
+ "com.xgimi.doubanfm",
+ "com.netease.cloudmusic.tv",
+ "com.ktcp.tvvideo",
+ "com.hunantv.license",
+ "cn.com.wasu.main",
+ "com.gitv.dvb.live",
+ "com.xgimi.gimiplayer",
+ "com.xgimi.xhplayer",
+ "com.xgimi.stream.video",
+ "com.smarttv.manager"
+ ],
+ "library_excluded_apps": [
+ "mediatek.factorymenu.ui",
+ "com.xgimi.minitvfactory",
+ "com.xgimi.bootwizard"
+ ]
+}
diff --git a/examples/xgimi-rs10-ultra/debloat.txt b/examples/xgimi-rs10-ultra/debloat.txt
new file mode 100644
index 000000000..e992667c3
--- /dev/null
+++ b/examples/xgimi-rs10-ultra/debloat.txt
@@ -0,0 +1,71 @@
+# XGIMI RS10 Ultra projector (device pig_chivalrous, MediaTek m7642), China, Android 9, firmware PPR2.180905.006.A1
+# Build PPR2.180905.006.A1 (incremental xgimi10101741), fingerprint MediaTek/m7642_db/m7642:9/PPR2.180905.006.A1/xgimi10101741:user/release-keys
+#
+# Apply: TV_HOST=<tv ip> tools/disable.sh examples/xgimi-rs10-ultra/debloat.txt
+# Undo: TV_HOST=<tv ip> tools/restore.sh examples/xgimi-rs10-ultra/debloat.txt com.xgimi.home
+# Everything is DISABLED, not uninstalled. Comment out any line you want to keep.
+#
+# Stock launcher: com.xgimi.home (com.xgimi.module.cellview.home.ui.HomeActivity). It is disabled by
+# launcher/build-and-install.sh, not by this list; the Undo above re-enables it. Install with
+# HOME_KEY_SERVICE=1 RESTORE_KEY_SERVICES=1 STOCK_LAUNCHER=com.xgimi.home and set
+# stock_home_redirect=com.xgimi.home: com.xgimi.xrmservice re-enables the stock launcher on its remote
+# keys, and the redirect sends its home screen back to the new launcher.
+#
+# Live TV: none (no tuner). HDMI inputs are com.xgimi.tvinput and com.xgimi.xhplayer; config.json sets
+# input_action=com.xgimi.action.hdmiPlayer.
+#
+# ADB: this GMUI 6 build has no working ADB switch in Developer options or the factory menu. On this unit
+# adbd was started by running `setprop service.adb.tcp.port 5555` and `setprop ctl.start adbd` from a
+# small local helper app (not part of this repository). Do not launch the factory packages
+# (mediatek.factorymenu.ui, com.xgimi.minitvfactory) to look for a switch; the repository's rules forbid
+# starting factory/test packages.
+#
+# XGIMI Settings is a service window, not an Activity: com.android.newsettings/.SettingService, action
+# com.xgimi.settings.SETTINGS, data Settings://com.xgimi.settings/main. The launcher's Settings pill needs
+# a small helper activity in settings_fallback_components (config.xml only; see README.md).
+#
+# HomeKeyService is dropped from the accessibility list on every boot of this firmware; restore_key_services
+# alone did not put it back. A BOOT_COMPLETED helper re-adds it on this unit (not shipped); without it,
+# re-enable it over ADB after a reboot (README.md).
+#
+# OTA: com.xgimi.upgrade is commented out below, so the default list keeps firmware updates. The author's
+# TV disables it by choice; uncomment the line to do the same.
+#
+# Kept on purpose: com.xgimi.xgimiservice, xrmservice, windowsystem, autokst, tof, tvinput, xhplayer,
+# remote, bluetoothservice, mateservice, baidu.oases, duertts, smartaccessories, ota.accessories,
+# wirelessscreen, smartconnect, screensaver, filemanager; the XGIMI store/account/payment packages are
+# disabled by the owner's choice below, not because they are unsafe.
+#
+# Tested on 2026-10-31 in one session with four reboots, not the several days CONTRIBUTING asks for.
+
+# Telemetry, ads, help and the H5 page host
+com.xgimi.adservice # XGIMI ad service
+com.xgimi.datareporter # usage/telemetry reporter
+com.xgimi.bugreportsender # bug report uploader
+com.xgimi.msgcenter # push message/notification center
+com.xgimi.instruction30 # help/instruction content
+com.xgimi.activitypage # H5 web page host used by help/account/store pages
+
+# Streaming apps the owner does not use (VidHub only)
+cn.com.wasu.main # 华数TV
+com.gitv.dvb.live # 宽带电视
+com.hunantv.license # 芒果TV
+com.ktcp.tvvideo # 云视听极光
+
+# Music, karaoke, XGIMI video content and the dynamic atmosphere screensaver
+com.xgimi.doubanfm # 酷狗音乐极米定制版
+com.netease.cloudmusic.tv # 网易云音乐
+com.tencent.qqmusicjimisdk # QQ Music SDK used by the music apps
+com.xgimi.karaokesdk # karaoke SDK (microphone/pay/MV)
+com.xgimi.stream.video # XGIMI video/VIP content app
+com.xgimi.atmosphere # dynamic/ambient screensaver; the owner uses a third-party aerial screensaver
+
+# XGIMI app store, account/VIP, payment and OTA (owner's aggressive scope)
+com.xgimi.newappmarket # XGIMI app store; Dangbei Market stays installed
+com.xgimi.account # account stub
+com.xgimi.user # account/VIP/backup UI and provider
+com.xgimi.payview # VIP/payment UI
+# com.xgimi.upgrade # OTA updater; kept enabled by default, disabled on the author's TV by choice
+
+# Misc
+com.android.printspooler # printing; nothing prints from a projector
diff --git a/examples/xgimi-rs10-ultra/tv.json b/examples/xgimi-rs10-ultra/tv.json
new file mode 100644
index 000000000..26cc4fc13
--- /dev/null
+++ b/examples/xgimi-rs10-ultra/tv.json
@@ -0,0 +1,6 @@
+{
+ "tv": "XGIMI RS10 Ultra projector (device pig_chivalrous, MediaTek m7642), China",
+ "os": "Android 9",
+ "brand": "XGIMI",
+ "notes": "GMUI 6 China; no working ADB toggle (local setprop helper); stock home com.xgimi.home re-enabled by xrmservice, held with stock_home_redirect; XGIMI Settings is a service window; HomeKeyService dropped on boot; 21 packages disabled by default (OTA kept)"
+}