~/guides/TV.md

Guides / AI tools

Clear the ads off your TV with Claude Code: CleanYourTV switches off ads, preloaded apps and tracking

Free, open-source CleanYourTV lets Claude Code reach your Android or Google TV over Wi-Fi, switch off ads and junk apps, and add a clean home. 3 steps.

Does your TV open on a sponsored banner, recommended videos and a row of apps you never use? I use CleanYourTV, a free, open-source (MIT) GitHub project. Grab it, paste one prompt into Claude Code, add your TV model, and Claude Code connects to the TV over Wi-Fi, backs it up, switches off the ads, the preloaded junk and the tracking, and installs a clean home screen that looks like an Apple TV. No root, no cable, and one command puts it all back. The catch first: it only works on Android TV and Google TV, not Samsung or LG.

01The result first: an ad-filled home → a clean home screen

A paper-craft living-room TV showing the stock Google TV home, with a large Sponsored banner at the top circled in red
Before: the stock home opens on a sponsored banner (from the project's own photo; we blurred the people in the ad).
The same TV with a clean dark red home screen: time, date and a few apps; a green tag reads ads 0
After: the CleanYourTV launcher, just the time, the date and the apps you want.

Both screens come from real photos in the project's official README (the author's parents' TV); we did not draw them. The job has three parts: back up, switch off, install a new home.

  1. Back up: the list of installed apps and all settings are saved first.
  2. Switch off: the maker's telemetry, ad services, content rows and preloaded apps. They are disabled, not uninstalled, so it can be undone.
  3. Install: a small native launcher becomes the default home screen.

02Before you start: check that your TV can run it

  1. Works: Android TV and Google TV. On 27 Oct 2026 the official list had 335 TV models from 92 brands, most of them TCL, Sony, Xiaomi and Philips.
  2. Half works: Fire TV. Ads and apps can be switched off, but Fire OS will not let another launcher become Home.
  3. Does not work: Samsung (Tizen), LG (webOS), Roku, Vizio, Hisense VIDAA. They have no ADB; the project has a separate page for turning off their tracking with the remote.
  4. You also need: a computer on the same Wi-Fi as the TV with Claude Code installed (Codex, Gemini CLI and other assistants that can run shell commands work too).

03Step 1: turn on USB debugging on the TV

Paper-craft menu path to Build number, a USB debugging switch turned on, the first checklist row ticked
The menu path and the switch to turn on. Names vary a little by model.
  1. Open Settings → Device Preferences → About on the TV.
  2. Go to Build and press OK on the remote 7 times until it says you are a developer.
  3. Go back, open Developer options and turn on USB debugging.
  4. If you also see a Network debugging or ADB debugging switch, turn that on too. Keep the TV on.

04Step 2: grab the project and paste the prompt into Claude Code

Terminal: get the project
git clone https://github.com/Gathin23/cleanyourtv
cd cleanyourtv
claude
The PROMPT.md page on GitHub, headed The prompt: Paste this into Claude Code
The official PROMPT.md (captured 27 Oct 2026): paste all of it into Claude Code.

The project says to clone it first: Claude Code then uses its own tools/disable.sh and launcher, which hold the backup, the Home guard and the restore record, instead of writing its own.

One line to paste before PROMPT.md (replace the [])
I have cloned cleanyourtv. Work in this folder and use the existing tools in tools/ and launcher/.
My TV model is: [TV model, e.g. Sony KD-55X80K]
Then follow PROMPT.md step by step, check every step with a screenshot from the TV, and ask me before anything that depends on my preferences.

05Step 3: answer its questions (about 15 minutes)

Paper-craft chat bubbles ask whether to keep Netflix and YouTube, each ticked keep; a clock reads about 15 minutes
It asks first, then acts.
  1. When the TV shows Allow USB debugging?, press Allow.
  2. Claude Code asks which apps you use, how many go on the home screen and in what order.
  3. It also asks whether to keep the voice assistant, Chromecast casting and system updates. If unsure, keep them.
  4. It backs up, switches off, installs the new home and checks each step with screenshots from the TV. With the project as context, the README says it takes about fifteen minutes.

06Changed your mind: one command restores it

A paper-craft terminal types the restore.sh command; the TV shows the stock home again
The restore replays the record saved before the change.
Terminal: restore (replace the [])
TV_HOST=[TV IP] tools/restore.sh examples/[your TV folder]/debloat.txt

# Google TV: also give the stock home back
TV_HOST=[TV IP] tools/restore.sh examples/[your TV folder]/debloat.txt com.google.android.apps.tv.launcherx
  1. Keep the list you applied (debloat.txt): the restore follows it.
  2. The record of the TV before the change is saved on your computer in ~/.cleanyourtv/.
  3. The new launcher stays installed; remove it in the TV's Settings → Apps if you want it gone.
  4. If the computer cannot reach the TV, you can also re-enable apps one by one in the TV's Settings → Apps.

07Good to know

  1. When you are done, go back to Developer options and turn USB, Network and Wireless debugging off. The project ships a check: python3 tools/adb-closed.py [TV IP] must say the port is closed.
  2. After a TV firmware update some disabled apps can come back; the README's After a firmware update section explains how to run it again.
  3. Only download from github.com/Gathin23/cleanyourtv and cleanyour.tv. The project says cleanyourtv.com is not theirs.
  4. The project is free (MIT); Claude Code runs on your own Claude plan or credits.
  5. Models, numbers and steps were checked on 27 Oct 2026. The project moves fast: the official README wins.
  6. This changes the TV's system settings. If it is not your TV (a rental flat's, say), ask the owner first.

Sources

Related guides