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/privacy.md

View on GitHub
# Privacy: screen recognition, microphone, camera

Mandatory. Run it on every TV right after the debloat batches, even when the owner only asked for the launcher.
Say why in one line: smart TVs recognise what is on screen (ACR), including HDMI inputs, and sell the viewing
history for ads; some keep a microphone or a camera available to vendor apps.

What is known, so you can answer the owner without overstating it:
- ACR samples the picture (or sound) several times a second and sends fingerprints, not full video. A 2024
  UC Davis / UCL study measured Samsung sampling every 500 ms and LG every 10 ms, also on HDMI and antenna
  input. On Android TV / Google TV it is usually Samba TV (Sony, TCL, Philips and others) or a vendor service.
- Vendors earn on viewing data, which is why TVs are cheap. Texas sued Samsung, Sony, LG, Hisense and TCL
  over ACR in December 2025 (allegations, not rulings).
- Toggles are not proof: the owner switches them off, then we check the packages and app ops ourselves.

## 1. Scan

```sh
python <skill>/scripts/privacy.py scan
```

It prints ACR/ad/analytics candidates by name, every app that holds `RECORD_AUDIO` or `CAMERA`, and whether the
TV reports a microphone or camera. Read each candidate with `dumpsys package <pkg>` (debloat.md section 1).
Typical finds: `*samba*`, "interactive TV" services, vendor `*.acr*`, `*.ads*`,
`*.analytics*`, "user experience programme" apps. Names vary per firmware: trust
services, receivers and permissions over the name.

## 2. Menu toggles (owner, with a screenshot each)

Ask Q-R1. The owner switches these off in the TV menu; take a screenshot of each screen as proof.
Paths differ per model and year: search the settings screen, do not insist on one path.

| Where | What to switch off |
|---|---|
| Sony / Philips / TCL Android TV | "Samba Interactive TV" / "Interactive TV" / "Viewing information" (Settings → Privacy, Device Preferences or Initial setup) |
| Google TV / Android TV 12+ | Privacy → Usage & Diagnostics off; Privacy → Ads → "Delete advertising ID" (or "Opt out of Ads Personalization" on older builds) |
| Vendor privacy screen | "Viewing information services", "Content recognition", "User experience programme", "Personalised recommendations" |
| Voice | "Hey Google" / hands-free voice / far-field mic toggle; a physical mic switch on the set if it has one |

Reading the setting back with `snapshot.py` (save, toggle, diff) finds the key so the next TV of this family can
be checked by command. Note the key in `references/devices/<board>.md`.

## 3. Disable ACR packages

Packages proven to be ACR, ad or viewing-data services go into their own batch,
`debloat/batchN-privacy.txt`, and through `disable.py` like any other batch. Screenshot Home and play one
video after it. If `disable.py` refuses (core, factory or Wi-Fi owner), leave the package and rely on the menu
toggle and DNS (section 5).

## 4. Microphone and camera

Ask Q-R2 and Q-R3. Block the mic and camera for every vendor app the owner does not use them for:

```sh
python <skill>/scripts/privacy.py deny <pkg> [<pkg> ...]
python <skill>/scripts/privacy.py scan     # proves RECORD_AUDIO=ignore / CAMERA=ignore
```

- Keep the mic for the voice assistant the owner kept in Q-D1/Q-D2 (`katniss`, `tv.assistant`, the vendor one),
  and for apps they named (video calls, karaoke).
- With no mic and no camera feature on the TV, say so and only block what holds the permission anyway:
  a remote or an accessory can add a microphone later.
- A camera on the set (pop-up or clip-on): block it for everything but the call app the owner uses, and tell
  them to push it down or cover it. Software cannot prove a camera is off; the shutter can.
- App ops survive reboots; `restore.py` puts the original modes back.

## 5. Network: blocking DNS (default on)

Ask Q-R4 and turn it on unless the owner says no. It catches the tracking hosts that no package list covers,
and the owner does nothing but answer yes:

```sh
python <skill>/scripts/privacy.py dns on      # AdGuard DNS as Private DNS, logged for restore.py
python <skill>/scripts/privacy.py dns check   # proves an ad host is sunk and normal sites still resolve
```

`OK` is the proof. After it, open every streaming app the owner uses and start a video. If one fails, or
`check` prints `FAIL`, run `privacy.py dns off` and tell the owner. `NOT BLOCKING` usually means a VPN app (ByeByeDPI
in always-on mode) answers DNS itself: say so and leave it. Android 8 and older have no Private DNS: skip and
say so. It does not block YouTube ads.

Why a ready-made filter and not a hand-made list: a block list ages. A reader's LG TV started calling a new ACR
host after two firmware updates that his 18-month-old list did not have. A maintained filter picks up new hosts.

Only when the owner says they run their own DNS filter (AdGuard Home, Pi-hole): skip Private DNS, and suggest a
default-deny for the TV's IP (firmware hosts and the apps they use),
a port 53 redirect on the router, and no outbound DoT/DoH from the TV. Do not bring this up with anyone else.

## 6. Report

Tell the owner: which ACR/ad packages were disabled, which toggles they switched off (with the screenshots),
which apps lost the mic or camera and which kept them, and whether Private DNS is on. Put the same into the
TV's README under "Privacy".
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: 197kUpdated 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