Skip to content

JohnWayneeee/cleantv / skills/android-tv-setup

android-tv-setup

Unverified

Set up an Android TV or Google TV over network ADB - back up, debloat with the owner's choices, switch off screen recognition (ACR) and take the microphone and camera away from vendor apps, tune performance, set picture and sound like a calibrator, replace the home screen with a clean Apple TV style launcher, and set up a YouTube DPI bypass (ByeByeDPI) where the ISP throttles YouTube, verifying every step with screenshots from the TV. Use when the user wants to debloat, clean up, speed up, configure, calibrate or replace the launcher on an Android TV / Google TV set or box (Xiaomi, TCL, Hisense, Sony, Philips, CHiQ/Changhong, Haier, Nvidia Shield and others). Not for Samsung Tizen, LG webOS or Fire TV launchers.

FileKindSize
SKILL.mdskill md7.1 KB
launcher/app/build.gradleother482 B
launcher/app/src/main/AndroidManifest.xmlconfig2.2 KB
launcher/app/src/main/assets/fonts/OFL.txtmarkdown4.3 KB
launcher/app/src/main/assets/fonts/Onest.ttfbinary188.5 KB
launcher/app/src/main/java/com/cleantv/launcher/AppRepository.javaother4.5 KB
launcher/app/src/main/java/com/cleantv/launcher/GlassHighlight.javaother2.8 KB
launcher/app/src/main/java/com/cleantv/launcher/MainActivity.javaother29.2 KB
launcher/app/src/main/java/com/cleantv/launcher/ShimmerDrawable.javaother2.1 KB
launcher/app/src/main/java/com/cleantv/launcher/SkeletonAdapter.javaother2.4 KB
launcher/app/src/main/java/com/cleantv/launcher/TileAdapter.javaother3.0 KB
launcher/app/src/main/res/drawable/banner.xmlconfig491 B
launcher/app/src/main/res/drawable/ic_input.xmlconfig472 B
launcher/app/src/main/res/drawable/ic_settings.xmlconfig1.2 KB
launcher/app/src/main/res/drawable/ic_wifi.xmlconfig489 B
launcher/app/src/main/res/layout/activity_main.xmlconfig7.3 KB
launcher/app/src/main/res/layout/item_tile.xmlconfig1.0 KB
launcher/app/src/main/res/values/config.xmlconfig2.2 KB
launcher/app/src/main/res/values/strings.xmlconfig696 B
launcher/app/src/main/res/values/styles.xmlconfig1.1 KB
launcher/build.gradleother74 B
launcher/gradle.propertiesother109 B
launcher/gradle/wrapper/gradle-wrapper.jarbinary42.7 KB
launcher/gradle/wrapper/gradle-wrapper.propertiesother251 B
launcher/gradlewother8.5 KB
launcher/gradlew.batscript2.8 KB
launcher/settings.gradleother332 B
references/connect.mdmarkdown3.1 KB
references/debloat.mdmarkdown4.0 KB
references/devices/mediatek-mt5889-homwee.mdmarkdown9.6 KB
references/devices/skyworth-m7332.mdmarkdown6.9 KB
references/dpi-bypass.mdmarkdown4.5 KB
references/finish.mdmarkdown2.5 KB
references/launcher.mdmarkdown7.9 KB
references/performance.mdmarkdown3.1 KB
references/picture.mdmarkdown5.5 KB
references/privacy.mdmarkdown5.2 KB
references/questions.mdmarkdown11.6 KB
references/sound.mdmarkdown2.9 KB
scripts/adb-closed.pyscript893 B
scripts/appops.pyscript1.2 KB
scripts/backup.pyscript3.2 KB
scripts/build-install.shscript2.9 KB
scripts/disable.pyscript3.0 KB
scripts/privacy.pyscript5.4 KB
scripts/restore.pyscript1.5 KB
scripts/scan.pyscript2.4 KB
scripts/setting.pyscript1.9 KB
scripts/snapshot.pyscript1.9 KB
scripts/tv.pyscript1.8 KB
scripts/tvlib.pyscript2.4 KB

references/debloat.md

View on GitHub
# Debloat

## 1. Sort the packages

From `backup/packages-system.txt`, `backup/packages-3rdparty.txt` and `backup/launchable.txt`, sort into:

1. Manufacturer telemetry and analytics.
2. Manufacturer content and ad services: stores, recommendation rows, content providers, PatchWall-like home rows.
3. Background services the owner likely does not need: duplicate cast/share receivers, cleaners, demo modes, print.
4. Preloaded apps.
5. Streaming apps.
6. Keep: everything below and anything load-bearing.

For every vendor package whose name does not say what it is, read it without starting it:

```sh
python tv.py 'dumpsys package <pkg> | grep -E "^\s+[0-9a-f]+ <pkg>/|versionName|sharedUser|permission\."'
```

Activities, services, receivers and permissions tell the story: `BIND_TV_INPUT` = an input/remote service (keep),
`c2dm`/Firebase + boot receiver = push/telemetry, `hpplay`/`lebo` = Chinese AirPlay SDK. Ask when still unclear.

## 2. Never disable

- Android core: `android`, `com.android.systemui`, `com.android.shell`, `com.android.phone`, `com.android.settings`,
  `com.android.tv.settings`, permission controller, package installer, ext services, ext shared, module metadata
  (each as `com.android.*` or `com.google.android.*`), `com.google.android.overlay.modules*`,
  `com.android.providers.*` except calendar, contacts, user dictionary and blocked numbers.
  An original Mi TV Stick never booted again after a list took six of these.
- What the TV needs: the TV app and input services (HDMI, tuner), the input/source menu, remote and Bluetooth
  pairing (`com.android.bluetooth`, vendor `autopair`), the on-screen keyboard, Play Store and Play Services,
  Android TV Remote service (phone remote).
- Factory packages: never disable, never launch (`*factory*`, `*.fac.*`, `hkcfac`, `com.at.factory.*`,
  `mediatek.factorymenu.ui`). On Haier/CVTE boards opening one flips a factory flag: Input key and CEC die and
  the next boot disables Play services, Netflix and Chromecast for good.
- The owner of the saved Wi-Fi network (`backup/wifi-owner.txt`), until the network is re-joined.
- On CVTE boards (`com.cvte.*`) leave the stock launcher enabled unless a device file says otherwise.

`disable.py` enforces the core list, the factory pattern and the Wi-Fi owner check.

## 3. Ask, then disable in batches

Ask Q-D1..Q-D4 (`questions.md`). Write each batch to `debloat/batchN-<topic>.txt`, one package per line with a
`# comment` saying what it is. Then:

```sh
python <skill>/scripts/disable.py debloat/batch1-vendor.txt
python <skill>/scripts/tv.py --screenshot shots/01-after-batch1.png HOME sleep:2
python <skill>/scripts/tv.py 'ping -c1 -W2 8.8.8.8 | tail -1'
```

Look at the screenshot before the next batch. A batch can take something load-bearing with it, and you can only
tell which batch if they are small.

Typical batches: (1) vendor telemetry/content/ads, (2) the owner's "don't use" choices, (3) ACR and viewing data
(privacy.md, mandatory), (4) launcher takeover (launcher.md), (5) speed (performance.md).

## 4. Reboot check

After the last batch: reboot, wait for `sys.boot_completed`, then compare:

```sh
python <skill>/scripts/tv.py 'pm list packages -d'
```

with `backup/disabled-by-us.txt` (compare as sets; `comm` on Windows trips over sort order and CRLF).
Some firmware re-enables packages at every boot from its own list (TCL Android 9 does this for its user center):
note those in the batch header instead of disabling them again. If the setup wizard or stock launcher came back
and Home is black, check `logcat | grep RecoveryActivity` and re-enable the stock launcher first.

## Firmware that refuses

Fire OS 5 and some others refuse `pm disable-user` with `SecurityException`, `pm uninstall --user 0` with
`DELETE_FAILED_INTERNAL_ERROR`, and `pm hide` reports success but changes nothing. Trust `pm list packages -d`,
not the exit code. If every package is refused, stop: offer the TV's own privacy toggles and DNS blocking.

## Ad-blocking DNS

Part of the privacy phase now: `privacy.md` section 5, `privacy.py dns on`.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall