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 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.mdnew file mode 100644index 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.jsonnew file mode 100644index 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.txtnew file mode 100644index 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 projectordiff --git a/examples/xgimi-rs10-ultra/tv.json b/examples/xgimi-rs10-ultra/tv.jsonnew file mode 100644index 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)"+}