mihirgupta0900/tv-home
ANDROID TV DEBLOAT AND LAUNCHER
Tool to remove ads and bloat from Android TV over Wi-Fi with installation of a minimalist Apple TV-style launcher. Disables unnecessary packages reversibly and replaces home screen with lightweight interface featuring rotating wallpapers.
// KEY FEATURES
- Debloat via ADB over Wi-Fi with backup and rollback
- Launcher 4.7 MB without network or background services
- Control via Claude Code with single command
- Configurable dock and app grid in XML
// DEEP DIVE: HOW IT WORKS
The project consists of two parts: a set of scripts to connect to the TV via ADB over Wi-Fi and disable unwanted packages, and a custom launcher that replaces the stock home screen. Scripts discover the TV on the network, build a list of apps to disable (the TCL Google TV example disables 25 packages, reducing launcher memory from 192 to 83 MB), apply changes via disable.sh, and allow full rollback via restore.sh — packages are only disabled, never uninstalled.
The launcher weighs 4.7 MB including wallpapers, requires no network or background services. It shows clock, greeting, and date; top-right frosted pills switch Inputs (HDMI/AV/Live TV), Wi-Fi, and Settings. Below is a configurable dock of favourite apps and a grid for the rest; D-pad focus is deterministic and remembers the last tile. Twelve nature wallpapers crossfade every 10 minutes with a scrim for text readability. Dock, hidden apps, and Live TV are configured in launcher/res/values/config.xml.
The primary workflow hands the repo to Claude Code with the prompt from PROMPT.md: the agent finds the TV, connects via ADB, asks about used apps, builds and installs the launcher. Manual run on macOS needs Python, JDK 17, Android SDK; macOS often blocks the system adb binary, so the adb-shell Python package is used. On Google TV, com.google.android.tungsten.setupwraith must be disabled or it hijacks the Home button. USB debugging must be on and both devices on the same Wi-Fi.
// USE CASES
Best for: For owners of slow Android TVs with ads
- Clean Android TV of ads and telemetry without losing system apps
- Replace heavy stock launcher with lightweight interface with rotating wallpapers
- Automate setup of multiple TVs via Claude Code with a single prompt
// QUICK START
./setup.sh
tools/find-tv.sh
tools/venv/bin/python -I tools/tv.py --probe
tools/disable.sh examples/tcl-google-tv-g07/debloat.txt
launcher/build-and-install.shCommands are taken from the repository README — check the current version on GitHub before running.
New repositories every 30 minutes
REDDYX AI scans GitHub 24/7 and ships the best AI/ML/Web3 projects to Telegram.
Join on Telegram