Skip to content
HardwareLab

Fix Google TV and Android TV lag and home-screen ads

Start with the CleanYourTV build. It disables selected telemetry, ad services, content rows and preloaded apps, then makes a native launcher your home screen. Packages are disabled rather than uninstalled; no root is required. README source.

Android TV / Google TV only. Samsung (Tizen), LG (webOS) and Roku aren't supported. Some China-market TCL sets also refuse launcher installation; check the model's list first. README compatibility source.

Replace the ad-filled home screen

  1. Prepare the TV and computer. Use a computer on the same Wi-Fi and a coding assistant with shell access. On the TV, open Settings → Device Preferences → About, press OK on Build seven times, then enable USB debugging in Developer options. Enable Network or ADB debugging too if offered. README source.
  2. Use the repository's prompt. Paste PROMPT.md into the assistant and fill in your TV model. Accept the TV's debugging permission, then choose the apps, voice assistant, Chromecast and updates you want to keep. The assistant backs up, debloats, builds and installs the launcher, checking with screenshots. README source.
  3. Keep a working Home app. Install and run the new launcher before disabling the stock one. The install script handles that order. Disabling Google TV's setup wizard can also remove its saved Wi-Fi network and, on Google's Chromecast and TV Streamer, phone casting; review those caveats before changing it. README source.

Prefer to run the tools yourself? Follow the README's manual setup and commands, including launcher/build-and-install.sh and tools/disable.sh with a list for your model. README source.

For launcher lag, reduce motion and effects

The README provides reduced_motion in config.xml for TVs whose GPU cannot keep up. Hold OK on Settings, choose Launcher settings and turn animations off. Advanced effects are optional and may use more memory, so leave them off when trying this approach to lag. README source.

TV debloat tips + Thursday builds

Get TV debloat tips and HardwareLab builds in the Thursday email. Free.

Built something? Submit a build

Home-screen ads and in-app ads are different

The replacement home screen removes sponsored rows and Discover nags. README source. The README separately describes Private DNS for blocking some in-app ad domains, with a privacy trade-off: the resolver sees the TV's DNS queries. That method does not remove YouTube ads. README source.

Keep the restore path, then close debugging

Keep the debloat list you applied and the recovery record in ~/.cleanyourtv/. Use tools/restore.sh with that list to replay the saved state and restore Home. The replacement launcher stays installed; remove it in Settings → Apps if you want it gone. README source.

When finished, turn off USB and Network/ADB debugging, revoke debugging authorisations and reboot. Check the connection is closed with python3 tools/adb-closed.py <tv ip>. The launcher works with debugging off. README source.