GitHub - Ansub/tv-detox: Make an old Android TV fast again with Claude Code or Codex: a tiny ad-free home screen plus the prompt to clean it up
A GitHub project that uses Claude Code or Codex to remove bloatware, ads and sponsored rows from Android TV and Google TV devices by disabling apps (never deleting them), then installs a calm, minimal home screen. The guide covers setup over adb, which TVs and streaming boxes are supported, and the pitfalls, especially on Google TV and Chromecast.
- The cleanup disables apps rather than deleting them, so every change can be undone with undo.sh or a single adb command.
- Turning off Google TV's own home screen can leave some Chromecast units stuck restarting and needing a factory reset, so install.sh now keeps it on by default.
- Support is limited to Android TV and Google TV: Roku, Samsung, LG and Fire TV either can't be cleaned this way or only partly, and the author tested on a TCL Google TV, reporting free memory rising from about 660 MB to 1 GB.
Tv-detox is a set of scripts that strips the bloat off an Android TV or Google TV box. It removes or disables preinstalled apps, ads and sponsored rows, leaving you with your own apps, your HDMI inputs and a plain clock. Nothing is deleted; apps are only turned off, and undo.sh brings them back. The whole thing is driven by an AI coding assistant (Claude Code or Codex) running on your laptop over the same Wi-Fi as the TV. You turn on developer mode, pair the laptop with the TV over ADB, paste a prompt, and the assistant asks before every change. The author reports free memory on one TCL set rising from about 660 MB to roughly 1 GB, though some of that is just from a restart.
The useful part for anyone trying this is the list of traps. Google TV and Chromecast with Google TV can get stuck restarting if you disable their home screen, and the only fix reported was a factory reset, so install.sh now keeps that home screen on unless you pass GOOGLE_TV=1. On some Google TVs, disabling the home screen also makes Home open the setup app's recovery screen, which needs a separate opt-in (YES_SETUP=1) to fix. OLED owners are told to keep the screensaver on to avoid burn-in, and not to leave any home screen running for hours. Chromecast with Google TV needs Wireless debugging with a pairing code rather than a plain IP connection, and the port changes after every restart, which can break a cleanup halfway through.
Platform support is narrow. Android TV 9, 11, 12 and Google TV 14 are the tested targets, and the author says every change was checked on emulators. Fire TV works partly, since Amazon blocks changing its home screen. Roku, Samsung and LG are out, because their systems don't expose anything that can be connected to and controlled this way; on LG you can at least switch off Home Promotion and Content Recommendation by hand. The author is clear this is their own experience, not professional advice, and takes no responsibility for a TV that goes wrong. Read the warnings before running anything.