Section 1
What it does, and what it doesn’t
It does
- Turns off telemetry, cleaner apps, preloads and the ad and content feeds
- Replaces the home screen with a clean, ad-free launcher and your own dock
- Keeps your streaming apps, Assistant and Chromecast if you say so
- Backs up first and lets you undo every change
It doesn’t
- Work on Samsung (Tizen) or LG (webOS) TVs. Fire TV gets the debloat only, not the launcher
- Block ads inside apps: YouTube’s own ads still play
- Root or unlock the TV
Section 2
What you need
- An Android TV or Google TV (Android 8 or newer for the new launcher). Ours: Xiaomi Mi TV, MiTV-AXSO2, Android 11.
- A computer on the same Wi-Fi with Claude Code (needs a paid Claude plan) and Python 3.
- For the new launcher only: about 2 GB for Java and the Android SDK. Claude installs them for you.
- The TV remote, and time in one sitting: plan for about an hour the first time, most of it downloads.
Section 3
The setup, step by step
Steps marked On the TV are yours; Claude does the rest and asks before anything that depends on your choices. Change the parts in <brackets> before sending a prompt.
TV-യിൽ ചെയ്യേണ്ടത് മാത്രം നമ്മൾ ചെയ്യണം. ബാക്കി എല്ലാം Claude ചോദിച്ച് ചോദിച്ച് ചെയ്യും.
Turn on developer mode on the TV
On the TVOpen Settings → Device Preferences → About and press OK on Build 7 times until it says you’re a developer. Go back, open Developer options and turn on USB debugging (and Network / ADB debugging if your TV has it).
On our Xiaomi Mi TV, USB debugging alone opened the network connection Claude needs. Nothing is plugged into the USB port for this.
Find the TV’s model and IP address
On the TVThe model is under Settings → Device Preferences → About → Model (ours: MiTV-AXSO2). The IP address is under About → Status or in your Wi-Fi network’s details (it looks like 192.168.x.x). Your computer must be on the same Wi-Fi. A Wi-Fi extender is fine as long as both end up on the same network.
Give Claude Code the repo
On your computerOpen Claude Code in a new folder and paste this. Claude downloads the open-source CleanYourTV repo, reads its instructions and sets up its tools (a small Python ADB client, no extra app on the TV).
Clone https://github.com/Gathin23/cleanyourtv and follow PROMPT.md.
I want to debloat my Android TV and replace its launcher with a clean Apple TV style home screen.
My TV model is: <MODEL>. Its IP address is: <IP>.
Work on the real device step by step, back up first, and ask me before anything that depends on my preferences.Allow the connection on the TV
On the TVWhen Claude connects, the TV shows “Allow USB debugging?”. Tick Always allow from this computer and press OK. Watch the TV when Claude says it’s connecting: our first try timed out because the prompt went unanswered.
Let Claude back everything up
AutomaticBefore changing anything, Claude saves the full app list, every setting and the current home screen to a backup folder, and takes a screenshot of the TV. It also keeps an undo record of everything it turns off.
Tell Claude what you use
Your choiceClaude asks which features and apps to keep. We kept Google Assistant, Chromecast, screen mirroring, firmware updates and every streaming app (Netflix, Prime Video, YouTube, JioHotstar and the rest). If an answer looks wrong, it double-checks. Ours did, when only one streaming app was ticked by mistake.
Debloat in small batches
AutomaticClaude turns off the bloat in three batches (telemetry, background apps, ad and content feeds), with a screenshot of the home screen after each one to make sure nothing broke. Apps are disabled, not deleted, so everything can come back.
Build and install the clean launcher
OptionalThe old home screen still shows its own Shop/Discover tabs and sponsored rows, and only a new launcher removes those. Claude installs Java (JDK 17) and the Android SDK on your computer (about 2 GB), asks which apps go in the dock and what the greeting should say, builds the launcher (518 KB for us), installs it and makes it the Home screen.
Yes, install the JDK and Android SDK and build the clean launcher.
Dock: <Netflix, Prime, YouTube, Hotstar>. Greeting: <your name>.Reboot once and check
AutomaticClaude restarts the TV and confirms nothing switched itself back on and the new home screen comes back. Then press Home and your app buttons (Netflix, YouTube…) on the remote to check they still work.
Important
Section 4
What we turned off on our Mi TV
14 apps, all disabled (not uninstalled), plus the stock launcher. Your list will differ by TV model; the repo has tested lists for about 300 models.
| Xiaomi analytics, Xiaomi statistics, Google feedback | Telemetry |
| TV Manager (cleaner), Handbook, Mi Legal | Background apps |
| Mi Music, Mi Gallery, print spooler, basic screensaver | Preloaded apps |
| Xiaomi web content, Google TV recommendation feeds | Ad and content feeds |
| Xiaomi partner app auto-installer | Installs apps you didn’t ask for |
| Stock Google TV launcher | Replaced by the clean launcher |
Kept on purpose
Section 5
Fixes we made after
USB drive
The USB popup was gone
One of the Xiaomi apps we turned off showed the popup when a USB drive is plugged in. Claude turned it back on. USB videos also open from the Media Player tile.
Set-top box
Power on to the set-top box
Our set-top box is on HDMI 2. Claude set it as the input the TV opens at power-on. It’s also one click away under Inputs on the new home screen.
My <USB drive / set-top box on HDMI 2> isn’t showing like before. Find out which change caused it and fix only that.Section 6
Close up when you’re done
While USB debugging is on, your computer can control the TV over Wi-Fi. When you’ve finished making changes, on the TV:
- Open Developer options and select Revoke USB debugging authorisations.
- Turn USB debugging off.
- Restart the TV, then ask Claude to check that the connection is closed.
Changes എല്ലാം കഴിഞ്ഞാൽ USB debugging off ആക്കാൻ മറക്കരുത്. വേണമെങ്കിൽ പിന്നീട് വീണ്ടും on ആക്കാം.
Section 7
Undo anything
Turn USB debugging back on first, then ask Claude:
Restore my TV: re-enable everything you disabled and bring back the old home screen.Behind the scenes it runs the repo’s restore script (tools/restore.ps1 on Windows, tools/restore.sh on Mac and Linux) with the same list. You can also bring back a single app, or change the dock and rebuild the launcher, the same way.
Watch out
.cleanyourtv folder in your user folder). It’s the only copy of what was changed.Section 8
Troubleshooting
| The “Allow USB debugging?” prompt never shows | Press Home so no menu covers it, turn USB debugging off and on, and ask Claude to retry while you watch the TV. |
| Claude can’t find the TV | Check both are on the same Wi-Fi and the IP is right. Look for “Network debugging” or “Wireless debugging” in Developer options and turn it on. |
| The TV dropped off mid-way | It happened to us. Keep the TV awake and near the router or extender. When it’s back, Claude reconnects and carries on; nothing is half-done. |
| The USB-drive popup disappeared | Ask Claude to turn the Xiaomi “floating frame” app back on. USB files also open from the Media Player tile. |
| A remote button stopped working | Tell Claude which one. The launcher can map buttons like Input or the app keys. |
| A firmware update brought apps back | Ask Claude to run the repo’s check tool with --fix to reapply your list. |
Section 9
FAQ
Do I need to root the TV?
No. Everything runs through the TV’s own developer settings, and nothing is unlocked or rooted.
Will it remove YouTube ads?
No. It removes the ads and sponsored rows on the home screen. Ads inside apps like YouTube still play.
Does it work on Samsung or LG TVs?
No. Only Android TV and Google TV. Fire TV gets the debloat but not the new launcher.
Is it safe?
Claude backs up first, disables apps instead of deleting them, works in small batches with a screenshot after each, and checks after a reboot. You can undo everything.
Is it free?
The CleanYourTV repo is free and open source. Claude Code needs a paid Claude plan.
Does the TV get faster?
Fewer apps run in the background and the new launcher is light (about 0.5 MB), but we didn’t measure speed. The repo includes a benchmark tool if you want numbers.
CleanYourTV is an independent open-source project by its own authors. This guide is by ShiftLogic Labs and isn’t affiliated with Anthropic, Google, Xiaomi or the CleanYourTV project. Follow the steps at your own risk.
