Skip to content

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

examples: Skyworth 7T861_A23 boot safety lifelines and native Office Mode best practice

jiantai9c3c6aafa92e
diff --git a/docs/devices/skyworth-7t861-a23.md b/docs/devices/skyworth-7t861-a23.md
index 355bc8c2e..56a5fd74e 100644
--- a/docs/devices/skyworth-7t861-a23.md
+++ b/docs/devices/skyworth-7t861-a23.md
@@ -23,41 +23,49 @@ Port 5555 opens over Wi-Fi without pairing prompts (`ro.adb.secure=0`). `persist
---
-## Safety Warning: Never disable `com.skyworth.officehomepage`
+## Safety Warning: Critical Packages to Keep
> [!CAUTION]
-> **Do not disable `com.skyworth.officehomepage` directly.**
-> On this firmware, disabling the stock home application (`pm disable-user --user 0 com.skyworth.officehomepage`) breaks the system boot chain and causes the TV to hang indefinitely at the SKYWORTH boot logo. The network stack does not initialize, leaving ADB and port 5555 unreachable.
+> **Do not disable any of these critical system packages:**
+> - **`com.skyworth.officehomepage`** & **`com.tianci.movieplatform`**: Stock launchers for Office Mode and Standard Mode. The Coocaa OS boot flow hard-depends on them; disabling either causes the system to hang indefinitely at the boot logo (network stack fails to start, ADB drops).
+> - **`com.loostone.tuning`**: Microphone tuning & audio HAL driver bridge. Disabling it triggers `AudioService`/HAL self-test timeouts and boot hangs.
+> - **`com.tianci.user`**: User authentication & token provider with strong IPC Binder dependencies across system framework daemons.
>
-> Recovery requires entering Recovery Mode and performing a hardware factory reset ("Wipe data / factory reset"). **Keep `com.skyworth.officehomepage` enabled at all times.**
+> Recovery requires entering hardware Recovery Mode and performing a factory reset ("Wipe data / factory reset"). **Keep all four enabled at all times.**
---
## Debloat verification: persistence across cold reboot
-The 16 packages in [`examples/skyworth-7t861-a23/debloat.txt`](../../examples/skyworth-7t861-a23/debloat.txt) remove telemetry, ad daemons, app store push services, and factory calibration background tools.
+The packages in [`examples/skyworth-7t861-a23/debloat.txt`](../../examples/skyworth-7t861-a23/debloat.txt) remove telemetry, ad daemons, app store push services, and factory background tools.
-### Verified safe to disable (16 packages)
+### Recommended: Zero Debloat via Native Office Mode
+
+> [!TIP]
+> **Debloating is optional on this firmware.**
+> If the TV is switched to **办公模式 (Office Mode)** in the native system settings, Coocaa OS internally suppresses all video streaming recommendations, banner advertisements, and background cloud preloading.
+>
+> Setting up CleanYourTV under native Office Mode produces an instant cold boot with **zero native loading screens** ("正在准备..."), while leaving all system packages fully intact (`pm list packages -d` remains empty), eliminating any risk of boot hangs.
+
+### Verified safe to disable (12 packages)
- **Telemetry & Diagnostics (4)**:
`com.skyworth.performance.monitors`, `com.skyworth.testtime`, `com.skyworthdigital.stb.dataprovider`, `com.skyworth.device`
-- **Ads & Manufacturer Push (5)**:
- `com.coocaa.tvmanager`, `com.coocaa.guide`, `com.tianci.de`, `com.tianci.user`, `com.coocaa.theme_package_ccos_nine`
-- **Preloaded Stores & Streaming (5)**:
- `com.coocaa.tvpitv`, `com.tianci.movieplatform`, `com.tianci.appstore`, `com.skyworth.skymarket`, `com.coocaa.app_browser`
-- **Factory & Tuning Background Daemons (2)**:
- `com.loostone.tuning`, `com.coocaa.factory`
+- **Ads & Manufacturer Push (3)**:
+ `com.coocaa.tvmanager`, `com.coocaa.guide`, `com.tianci.de`
+- **Preloaded Stores & Streaming (4)**:
+ `com.coocaa.tvpitv`, `com.tianci.appstore`, `com.skyworth.skymarket`, `com.coocaa.app_browser`
+- **Factory & System (1)**:
+ `com.coocaa.factory`
-In particular, `com.skyworth.device` (SmartDevice IoT and location reporting) and `com.coocaa.theme_package_ccos_nine` (default GoldenFaithTheme package) were tested for persistence:
-1. Disabled via `tools/tv.py 'pm disable-user --user 0 com.skyworth.device'` and `tools/tv.py 'pm disable-user --user 0 com.coocaa.theme_package_ccos_nine'`.
-2. Verified after a cold reboot (power cycled): both packages remained in state `disabled-user` (`enabled=3`). The system did not re-enable them.
-3. Bluetooth remote pairing, Wi-Fi connectivity, picture adjustments, and audio remain fully functional with nothing missing.
-
-### Must stay enabled
+### Must stay enabled (Critical system lifelines)
| Package | Purpose / Why it must stay enabled |
|---|---|
-| `com.skyworth.officehomepage` | Stock home application; disabling causes fatal hang on SKYWORTH boot logo |
+| `com.skyworth.officehomepage` | Office Mode stock home; disabling breaks system boot chain and hangs indefinitely on boot logo |
+| `com.tianci.movieplatform` | Standard Mode stock home base; boot chain hardcoded dependency, disabling causes fatal boot hang on COOCAA/SKYWORTH logo |
+| `com.loostone.tuning` | Loostone microphone tuning and audio HAL driver bridge; disabling causes AudioService / HAL timeout during boot |
+| `com.tianci.user` | Coocaa user account & auth service; framework Binder IPC dependency |
| `com.skyworth.tv` | HDMI, AV, and TV tuner input switching; picture and sound settings |
| `com.tianci.localmedia` | Built-in USB media player and local storage access |
@@ -65,9 +73,12 @@ In particular, `com.skyworth.device` (SmartDevice IoT and location reporting) an
## Replacing Home: Coocaa OS boot and Home key mechanism
-Coocaa OS does not use Android's standard `Intent.CATEGORY_HOME` activity chooser. Instead:
-- Home navigation and boot dispatch are controlled by system properties: `persist.service.homepage.pkg`, `persist.service.homepage.cls`, `persist.service.model.pkg`, and `persist.service.model.cls`.
-- In addition, Coocaa OS aggressive process management terminates third-party background applications whose package name does not begin with manufacturer prefixes (`coocaa`, `skyworth`, `tianci`, `android`).
+Coocaa OS does not use Android's standard `Intent.CATEGORY_HOME` activity chooser.
+For seamless cold boot without native transition overlays, follow this setup sequence:
+
+### Step 0: Switch to Office Mode in TV Settings
+
+Before installing CleanYourTV or redirecting properties, switch the television's desktop to **办公模式 (Office Mode)** using the remote in native system settings/menu. This ensures the firmware records `OfficeMode` as the active scene in its persistent database, silencing the video recommendation engine.
### Step 1: Build the launcher under Coocaa package ID
diff --git a/examples/skyworth-7t861-a23/README.md b/examples/skyworth-7t861-a23/README.md
index 02823b8cf..403eab40b 100644
--- a/examples/skyworth-7t861-a23/README.md
+++ b/examples/skyworth-7t861-a23/README.md
@@ -2,15 +2,29 @@
Tested on Skyworth 7T861_A23 (MediaTek MT9638 / mt5872, Android 10, build `eng.nobody.20241225.120706`).
-## Safety Warning
+## Safety Warning: Critical Packages to Keep
> [!CAUTION]
-> **Do not disable `com.skyworth.officehomepage`.**
-> Disabling the stock home app on this firmware causes the TV to hang indefinitely on the SKYWORTH boot logo upon restart. The system will fail to start the network stack, disabling port 5555. Recovery requires entering Recovery Mode and performing a factory reset ("Wipe data / factory reset").
+> **Do not disable any of these critical system packages:**
+> - **`com.skyworth.officehomepage`** & **`com.tianci.movieplatform`**: Stock launchers for Office Mode and Standard Mode. The Coocaa OS boot flow hard-depends on them; disabling either causes the TV to hang indefinitely at the boot logo (network stack fails to start, ADB drops).
+> - **`com.loostone.tuning`**: Microphone tuning & audio HAL driver bridge. Disabling it triggers `AudioService`/HAL self-test timeouts and boot hangs.
+> - **`com.tianci.user`**: User authentication & token provider with strong IPC Binder dependencies across system framework daemons.
+>
+> Recovery requires entering hardware Recovery Mode and performing a factory reset ("Wipe data / factory reset"). Keep all four enabled at all times.
-## Applying the debloat list
+## Recommended: Zero Debloat via Office Mode (100% Safe)
-Everything in [`debloat.txt`](debloat.txt) is disabled via `pm disable-user`, never uninstalled.
+> [!TIP]
+> **No packages need to be disabled on this model.**
+> Switching the TV to **办公模式 (Office Mode)** in the native system settings shuts off all video streaming feeds, banner advertisements, and background cloud preloading directly from the source.
+>
+> In `debloat.txt`, all packages are commented out by default:
+> - **Zero native loading screens**: Cold boot seamlessly transitions into CleanYourTV without intermediate "正在准备..." loading screens or network preloading delay.
+> - **Zero brick risk**: All system packages remain untouched (`pm list packages -d` is empty), ensuring 100% firmware stability and OTA update safety.
+
+## Applying the debloat list (Optional)
+
+If you explicitly wish to disable background telemetry and non-essential stores, uncomment the respective lines in [`debloat.txt`](debloat.txt):
- **Apply debloat list**:
```bash
@@ -21,11 +35,14 @@ Everything in [`debloat.txt`](debloat.txt) is disabled via `pm disable-user`, ne
TV_HOST=<tv-ip> tools/restore.sh examples/skyworth-7t861-a23/debloat.txt
```
-All 16 packages in `debloat.txt` have been verified across a cold reboot. Specifically, `com.skyworth.device` and `com.coocaa.theme_package_ccos_nine` remain disabled with Bluetooth remote control, Wi-Fi, audio, and settings working normally.
-
## Replacing the Home Launcher
-On Coocaa OS, the stock launcher cannot be replaced via standard Android Home chooser without bootlooping. Replacing the launcher safely requires building under the Coocaa package ID, using `coocaa-home-shim`, and pointing both the `persist.service.homepage` and `persist.service.model` properties (dual-track dispatch for standard/video modes and Home Office mode).
+On Coocaa OS, the stock launcher cannot be replaced via standard Android Home chooser without bootlooping.
+The cleanest and safest handover sequence:
+
+1. **Switch to Office Mode first**: On the TV, switch desktop mode to **办公模式 (Office Mode)** in the native settings/menu.
+2. **Build and install launcher**: Build under the Coocaa package ID (`com.coocaa.tvhome`) and install companion `coocaa-home-shim`.
+3. **Redirect Home properties**: Point both `persist.service.homepage.*` and `persist.service.model.*` to `com.ccos.tv.homepage`.
Detailed instructions, boot observations, and property undo commands are documented in:
👉 [`docs/devices/skyworth-7t861-a23.md`](../../docs/devices/skyworth-7t861-a23.md)
diff --git a/examples/skyworth-7t861-a23/debloat.txt b/examples/skyworth-7t861-a23/debloat.txt
index 181e78a13..6f06f8a73 100644
--- a/examples/skyworth-7t861-a23/debloat.txt
+++ b/examples/skyworth-7t861-a23/debloat.txt
@@ -8,31 +8,41 @@
# Everything is DISABLED, not uninstalled. Comment out any line you want to keep.
#
# CRITICAL SAFETY NOTE:
-# Do NOT disable com.skyworth.officehomepage directly. On this firmware, disabling the stock home
-# causes the system to hang at the SKYWORTH boot logo (network stack does not start, ADB drops).
-# Recovery requires a factory reset via Recovery Mode.
+# Do NOT disable com.skyworth.officehomepage or com.tianci.movieplatform directly.
+# Coocaa OS boot chain hardcodes dependencies on these stock home launchers. Disabling
+# either package causes the system to hang indefinitely at the boot logo (network stack
+# does not initialize, ADB drops). Recovery requires a hardware factory reset.
+#
+# RECOMMENDED BEST PRACTICE (ZERO DEBLOAT):
+# On this model, switching the television to "Office Mode" (办公模式) in the native settings
+# natively shuts off all video streaming feeds, banner advertisements, and background cloud
+# preloading from the source.
+# Leaving all packages enabled (zero debloat) is the safest approach, ensuring 100% firmware
+# stability, OTA upgrade safety, and eliminating any risk of boot hangs.
+# All packages below are commented out by default. Uncomment only if you explicitly wish to disable them.
# For replacing the home screen safely, see docs/devices/skyworth-7t861-a23.md.
-# Telemetry and diagnostics
-com.skyworth.performance.monitors # Performance monitors and telemetry
-com.skyworth.testtime # Factory testing timer
-com.skyworthdigital.stb.dataprovider # STB diagnostics data provider
+# Telemetry (optional)
+# Switching to Office Mode shuts off all ad feeds and streaming preloading, making
+# package disabling optional. The package below is verified safe to disable for privacy:
com.skyworth.device # Device information and location reporting
-# Ads and manufacturer content
-com.coocaa.tvmanager # CooCaa content recommendation manager
-com.coocaa.guide # EPG program guide and content pushes
-com.tianci.de # Tianci DE advertising engine
-com.tianci.user # Tianci user account and notification service
-com.coocaa.theme_package_ccos_nine # Default theme package
+# Other optional telemetry and apps (commented out by default):
+# com.skyworth.performance.monitors # Performance monitors and telemetry
+# com.skyworth.testtime # Factory testing timer
+# com.skyworthdigital.stb.dataprovider # STB diagnostics data provider
+
+# Ads and manufacturer content (optional to disable)
+# com.coocaa.tvmanager # CooCaa content recommendation manager
+# com.coocaa.guide # EPG program guide and content pushes
+# com.tianci.de # Tianci DE advertising engine
+# com.coocaa.theme_package_ccos_nine # Default theme package
-# Preloaded content and stores
-com.coocaa.tvpitv # CooCaa Live TV preloaded streaming
-com.tianci.movieplatform # Tianci video platform
-com.tianci.appstore # Tianci app store
-com.skyworth.skymarket # Skyworth market
-com.coocaa.app_browser # CooCaa built-in browser
+# Preloaded content and stores (optional to disable)
+# com.coocaa.tvpitv # CooCaa Live TV preloaded streaming
+# com.tianci.appstore # Tianci app store
+# com.skyworth.skymarket # Skyworth market
+# com.coocaa.app_browser # CooCaa built-in browser
# Factory and tuning tools
-com.loostone.tuning # Factory picture calibration utility
-com.coocaa.factory # Factory menu test package (do not launch)
+# com.coocaa.factory # Factory menu test package (do not launch)