TV Detox gives an old Android TV a 30 MB ad-free home screen and a Claude Code cleanup you can undo
TV Detox (Ansub/tv-detox) is a free, MIT-licensed kit for slow Android and Google TVs: a tiny ad-free home screen app plus a prompt that has Claude Code or Codex turn off preinstalled apps over ADB, asking before each change. Here is how to install it, the risks and how to undo it.
TV Detox (GitHub: Ansub/tv-detox) is a free, MIT-licensed project for making a slow Android TV or Google TV usable again. It pairs a tiny home screen app (your apps, HDMI inputs and a clock, no sponsored rows) with a prompt for Claude Code or Codex that connects over ADB and turns off preinstalled apps, asking before each change. Every figure the project publishes is about memory, swap and storage rather than measured speed, and nothing in it removes ads inside apps such as YouTube. The repo had 2,372 stars and 269 forks as of November 16, 2026, less than a month after its first commit on October 18.
Quick facts
- Works on: Android TV and Google TV sets and boxes, including many Sony, TCL, Hisense, Philips and Xiaomi TVs, Chromecast with Google TV and Nvidia Shield. The README lists Android TV 9, 11 and 12 and Google TV 14 as tested; the app's minimum is Android 5.0 (minSdk 21).
- Not for: Roku, Samsung Tizen or LG webOS, which are not Android. On current Fire TVs only the cleanup works; Amazon keeps its own home screen.
- Needs: a laptop on the same network as the TV, adb, and Claude Code or Codex for the guided cleanup. TV Detox needs no account, but Claude Code and Codex need their own; the README's free path skips the AI and uses install.sh.
- Licence and cost: MIT, free. The home screen uses about 30 MB of RAM, with no account and no ads.
- Releases: 15, from v1.0.1 on October 18 to v1.5.7 on October 28. Release APKs had about 26,200 downloads in total on November 16; the v1.5.7 tvhome.apk is 54,110 bytes.
- The repo's homepage link points to the author's Skool community; the code, APK and prompt in the repo are free.
How to install
Turn on developer mode on the TV (About, press Build seven times) and USB debugging. Then paste the README's prompt into Claude Code or Codex with your TV's brand and model, or skip the AI: download the repo, install adb (on a Mac, brew install android-platform-tools; on Windows, Google's SDK Platform Tools from Git Bash) and run:
sh install.sh <TV_IP> # picks your TV apps
sh install.sh <TV_IP> "com.netflix.ninja,com.hulu.livingroomplus" # or choose them
sh install.sh <TV_IP> "" "bluetooth,sound,picture" # add settings shortcutsinstall.sh uses your own build in out/tvhome.apk if one exists; otherwise it downloads tvhome.apk from the latest GitHub release and installs it with adb. Chromecast with Google TV and newer Google TVs need Wireless debugging: adb pair, then adb connect, then pass that IP and port to every script.
First setup
Before changing anything, two read-only scripts are worth running. sh supports.sh <TV_IP> reports the model, Android version, RAM and whether swapping the home screen is wise. sh candidates.sh <TV_IP> gives every app a verdict: never, keep, safe or review. Neither changes the TV.
TV Detox itself needs no account or API key. Holding OK on a tile moves, replaces or removes an app, or renames an HDMI input; an Add app tile adds more, in rows of six. Fourteen colour-only wallpapers are built in. Afterwards, turn all debugging off again.
What stands out
- The per-app cleanup is deliberately not automated. Installing the home screen and switching the launcher are scripted, but turning off each app is treated as a judgement call, so it is left to you or the AI, guided by candidates.sh and the five rules in docs/debloat.md.
- The rules come from real failures. Disable, never uninstall; leave what starts the TV and PERSISTENT apps alone; test casting; and never turn off the app that saved your Wi-Fi, a rule added after two TCL TVs lost Wi-Fi mid-install. On Google TV that is often the setup app, which install.sh then leaves on; the README's workaround is to forget the network and join it again, or use Ethernet.
- Google TV safety default. Since v1.4.1, install.sh leaves Google TV's own home screen on, after a viewer's Chromecast got stuck restarting and needed a factory reset. You opt in with GOOGLE_TV=1 only if you can reconnect over USB or port 5555.
- Brand notes with numbers. On a TCL Smart TV Pro, free memory went from about 660 MB to about 1 GB (partly from the restart itself) and on two TCL Q651G sets from about 560 to 840 MB; on both, com.tcl.tv must stay on or HDMI breaks. On a 954 MB TCL 32S4K, which is MediaTek inside and keeps its MediaTek HDMI and remote packages, swap in use fell from 216 MB to 132 MB and the home screen from 84 MB to 25 MB.
- After a firmware update, plain check.sh reports what drifted and check.sh --fix puts the home screen back in charge (on Philips, only --fix tests where Home goes).
How TV Detox compares with Free My TV and CleanYourTV
Claudefox has covered two similar projects. Free My TV (simbasjungles/free-my-tv) also swaps the home screen and disables rather than removes apps, but adds trending picks and weather, runs as an app on LG and Samsung TVs too, and has an Original mode (Free My TV, then Home Screen, then Original) that brings back the factory home screen, screensaver and every app it turned off; it also switches back by itself if its home screen crashes repeatedly. CleanYourTV (Gathin23/cleanyourtv) has its scripts apply debloat lists, writes a restore record before any change and builds an Apple TV-style launcher from source on your computer. TV Detox ships a signed 54 KB release APK of one plain-Java screen, plus a prompt and a planner, and has no automatic switch-back. Its undo.sh only reverses what install.sh itself turned off, so the cleanup's undo list is yours or the AI's to keep.
How it was built with Claude
The commit history shows it. Of 146 commits on main through October 30, 110 are by the author, Ansub Khan, and the rest come from more than 20 other contributors. 81 commits carry a Claude Co-Authored-By trailer, mostly naming Claude Opus 5.5, starting with the initial commit on October 18; one credits Cursor Agent. There is no CLAUDE.md or AGENTS.md. The AI rules live in the README prompt: explain the risk, ask before every change, keep an undo list, restart once before finishing. The v1.4.1 notes open with an apology to Chromecast owners. CI tests each change on Android TV 9 and 11 emulators and runs ShellCheck.
Try it with your AI. If you want only a cautious, reversible cleanup plan for your TV before deciding anything, give this prompt to Claude Code or Codex on a laptop on the same network:
Help me plan a reversible cleanup of my Android TV, a [brand and model] at [TV IP
address].
First check: adb is installed (on a Mac, brew install android-platform-tools; install
nothing else). Connect with adb connect [TV IP address]. On a Chromecast or newer Google
TV with only Wireless debugging, walk me through adb pair [IP]:[pairing port] and adb
connect [IP]:[port] instead. If the TV shows "Allow debugging?", tell me to press Allow.
Read-only steps, from inside the downloaded https://github.com/Ansub/tv-detox folder:
1. Run sh supports.sh and sh candidates.sh with my TV address, and explain the verdicts.
2. Run adb shell "dumpsys wifi | grep -o 'cname=[^ ]*' | sort -u". The app that saved my
Wi-Fi stays on. If the list is empty or unreadable, treat the setup app as the owner.
3. Save the output of adb shell pm list packages -d.
Propose a first batch of five apps marked safe that I don't use (the guide says five or
ten; start small). Leave on everything marked never, keep or review, and casting
(com.google.android.apps.mediashell) if I cast. For each, run adb shell dumpsys package
[package] | grep -m1 pkgFlags and drop any marked PERSISTENT. Explain the risk, show me
the batch and wait for my confirmation.
After I confirm: turn each off with adb shell pm disable-user --user 0 [package], never
uninstall. Write each to an undo file [file name] on my laptop with its adb shell pm
enable [package] line; undo.sh does not read this file. Then have me restart the TV and
check inputs, settings and casting before any next batch.
At the end, remind me to turn all debugging off.Known limits
- It turns off system apps, at your own risk. The README warns that a few TVs got stuck at the logo or kept restarting; open issues report a boot loop on a Xiaomi Google TV and a black-screen loop on a TCL Google TV. The author disclaims liability.
- Warranty is not addressed. The repo says nothing about how disabling preinstalled apps or using developer options affects a TV's warranty or support; check your maker's terms first.
- Undo has limits. sh undo.sh <TV_IP> turns the TV's own home screen back on and removes this one, but only knows what install.sh turned off. Apps the AI or you turned off need the list you kept and adb shell pm enable <package>. On a TV stuck restarting, the README lists disabled packages with adb shell pm list packages -d and enables them while it briefly answers; failing that, recovery mode or a factory reset.
- Network debugging is an open door while on. Other devices on your network can ask to control the TV while debugging is on.
- Features can break. Some remote buttons and casting can stop working, and Play Protect may warn about the optional Home button's accessibility service.
- Ads inside apps stay. The project removes the stock home screen's sponsored rows and preinstalled apps; it does not claim to block ads in YouTube or other apps, and the README's contributing note rules out ad blockers.
- OLED TVs should keep the screensaver on to avoid burn-in, and firmware updates can turn things back on (check.sh helps here).
Problems and feedback
Bugs and device reports go to GitHub issues on Ansub/tv-detox; 29 issues and pull requests were open on November 16. Pull requests are welcome for fixes that work on every TV.
FAQ
Does TV Detox delete apps from my TV? No. Apps are turned off with pm disable-user and can be turned back on with pm enable. Only the home screen app itself is uninstalled when you run undo.sh.
Can I keep my TV's own home screen and only remove the junk? Yes. Leave out the home screen step of the README prompt; the cleanup alone is what makes the TV faster, and it works with any launcher.
Do I need a paid Claude Code or Codex subscription? No. The README's route for anyone who does not want to pay is install.sh with adb alone, plus candidates.sh and docs/debloat.md to decide app by app.
Does it work on Samsung, LG or Roku TVs? No. They do not run Android. On LG the README suggests turning off Home Promotion and Content Recommendation in the TV's own settings.
Built by Ansub Khan and contributors
Source: GitHub: Ansub/tv-detox, TV Detox README, TV Detox releases, TV Detox latest release, Cleaning your TV safely (docs/debloat.md), install.sh, undo.sh, supports.sh, candidates.sh, check.sh, AndroidManifest.xml, build.sh, CI workflow, Commit history, Open issues and pull requests, Claudefox: Free My TV, Claudefox: CleanYourTV
This story first appeared in the claudefox daily briefing for November 16, 2026.