Open source alternative to ATV Launcher Pro and Projectivy Launcher
Last verified
Transform any Android TV or Google TV by removing bloatware over Wi-Fi and installing a clean Apple TV-style launcher. No root, fully reversible.
Xiaomi, TCL, and similar sets show sponsored rows before installed apps load. CleanYourTV disables the OEM ad and telemetry packages using a community-tested list for the specific model, then installs the custom launcher. The process takes about fifteen minutes on a supported model.
Skip if your TV already runs a clean launcher such as NVIDIA Shield, where there are no OEM ad rows to remove and the stock interface is already uncluttered.
The debloat step targets telemetry packages that report viewing data back to the manufacturer. Owners who monitor their home network can verify the effect by watching DNS queries before and after the debloat run. The launcher itself makes no network requests after installation.
Skip if the TV is on an isolated network segment with telemetry already blocked at the router. CleanYourTV adds device-level disabling on top, but network-level blocking alone may be sufficient for your needs.
The launcher source is plain Java with AndroidX RecyclerView, no Compose. The module card spec in `docs/specs/card.md` lets any TV app declare its own tile. The themes system in `themes/` shows how to change layout, colour, and wallpaper without a rebuild.
Skip if you need Compose-based UI or OEM-specific APIs. The launcher targets 1 GB devices, which limits some animation techniques available on higher-end hardware.
If you have two or more TCL or Xiaomi sets on the same model line, the same debloat list and theme config apply to all of them. The TV_HOST environment variable is the only value to change between runs.
Skip if your sets are different brands or firmware versions. Debloat lists are model-specific; applying a Xiaomi list to a Sony TV will likely break core TV functions.
Modern Android TV and Google TV home screens are designed to generate ad revenue before they serve the viewer. Sponsored content rows appear above installed apps, telemetry packages report viewing data to the manufacturer, and preloaded apps occupy the launcher grid without any supported path to remove them. On sets from Xiaomi, TCL, and other Android TV manufacturers, the home screen itself is a monetized product. Paid placements can appear before the user reaches Netflix, and no setting removes them.
The ADB debug bridge is the only standard escape route, but it requires hours of forum research to use safely on a specific model. Package names differ between firmware versions, some services are interdependent, and disabling the wrong package can break core functions like HDMI switching or voice input. Without a model-specific list and a known-good procedure, the practical options were buying a premium streaming device or accepting the stock experience.
Connects to the TV over the local network using the ADB debug bridge built into Android TV. Enable USB debugging in Developer Options, allow the computer once, and the tool handles device discovery and authentication. No physical cable, no root, and no hardware modification is required.
Uses `pm disable-user` to disable bloatware rather than uninstalling it. All disabled packages stay on the device in a suspended state. The bundled restore script re-enables every package in reverse order, returning the TV to its factory launcher in one step. Nothing is permanently deleted.
A native Android TV app (`com.gathin.tvhome`) written in plain Java with AndroidX RecyclerView. Targets sets with 1 GB of RAM and avoids blur effects, video playback, network requests, and background services. The dock sits where Apple TV places it; a top shelf names the focused app over an ambient glow in the app's artwork colour.
The `examples/` folder holds one debloat list per tested model from contributors. Brands include TCL (14 lists), Xiaomi (14), Sony (9), Philips (4), and Hisense (3), plus Amazon Fire TV Stick, NVIDIA Shield, and Chromecast with Google TV. A model not in the list can still be debloated using the AI-guided discovery flow that identifies packages on the specific TV.
Themes set background colour, wallpaper, dock order, and column count via a JSON file pushed over ADB without a rebuild. Three themes ship in `themes/`. Module cards let any installed TV app declare its own tile in the grid; the launcher prompts the user once per app and remembers the answer tied to the app's signing key.
Every step the assistant automates can be run by hand. `tools/tv.py` is a pure-Python ADB client that probes the TV, runs shell commands, and pushes files. `tools/disable.sh` and `restore.sh` apply and undo a debloat list. PowerShell equivalents ship for Windows users with Android Studio installed.
ATV Launcher Pro is a paid Android TV replacement launcher that lets you rearrange apps and customise the home screen grid. CleanYourTV addresses a different problem: the bloatware running under the launcher.
| Feature | CleanYourTV | ATV Launcher Pro |
|---|---|---|
| License | MIT | Proprietary |
| Debloat step | Yes | No |
| Launcher replacement | Yes | Yes |
| Fire TV support | Debloat only | Yes (launcher) |
| Price | Free | Paid one-time |
CleanYourTV is the better choice when the primary concern is ad rows, telemetry, and manufacturer services running in the background. Its debloat step targets the packages generating OEM ad revenue, which a launcher-only replacement cannot address. The custom launcher it installs is 300 KB and built for sets with 1 GB of RAM.
ATV Launcher Pro is worth considering when the TV is already clean and the goal is purely cosmetic rearrangement. It works on Fire TV where CleanYourTV's launcher cannot, and the sideload path is simpler for users who prefer not to run Python tools.
The stock launcher on a Xiaomi or TCL set is not a neutral interface. It displays paid content rows, collects viewing data for the manufacturer, and loads ad services at boot. There is no OEM-supported path to remove these without replacing the launcher and disabling the responsible packages.
| Feature | CleanYourTV | Xiaomi/TCL Stock |
|---|---|---|
| Ad rows | Removed | Present |
| Manufacturer telemetry | Disabled | Active |
| Third-party launcher | Yes | No |
| Reversible | Yes | N/A |
CleanYourTV is the practical path to reclaiming the home screen on Android TV hardware where the OEM treats the launcher as an advertising surface. For the 66 tested models, the debloat lists remove OEM ad and tracking packages while leaving core TV functions intact.
Setup requires Python 3 on a computer connected to the same Wi-Fi network as the TV.
```bash
git clone https://github.com/Gathin23/cleanyourtv
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50
tools/venv/bin/python -I tools/tv.py --probe
tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt
TV_HOST=192.168.1.50 launcher/build-and-install.sh
```No. It uses the ADB debug bridge, which is available in Developer Options on every Android TV and Google TV device. No root, no bootloader unlock, and no hardware modification is needed. Enabling USB debugging in the TV settings is the only prerequisite.
The examples/ folder contains tested debloat lists for 66 specific Android TV and Google TV models across 25 brands, including TCL, Xiaomi, Sony, Philips, Hisense, and Chromecast with Google TV. Amazon Fire TV Stick and Toshiba Fire TV are supported for the debloat step only. A model not in the list can still be debloated using the AI-guided discovery flow, and you can contribute the resulting list so the next person with that model skips discovery.
Yes. The debloat step uses pm disable-user rather than uninstall, so the restore script re-enables every package in reverse order in one command. The launcher install script rolls back automatically if the Home handoff fails. The TV's factory reset undoes everything CleanYourTV changed.
No. Amazon's Fire OS does not let a third-party launcher take over the Home screen. The debloat lists for Fire TV Stick and Toshiba Fire TV are included and work for removing bloatware, but the CleanYourTV launcher cannot be installed as the default Home on Fire OS.
MIT allows free use, modification, distribution, sublicensing, and commercial use of the code. The only requirement is keeping the copyright and permission notice. The bundled Outfit font is separately licensed under SIL OFL 1.1, which also permits free use and distribution.
Alternative to
Grok Bot
AI teammates you own: your keys, your model, your machine.
Alternative to
CleanMyMac X
Mac cleaner, app uninstaller, disk analyzer, and system monitor
Alternative to
Internet Download Manager
Parallel-download manager combining multiple network connections
Alternative to
OpenAI Operator
Computer-use agent: desktop, browser, terminal, and iOS automation.
Alternative to
Magnet
Free window manager: snap by shortcut or drag-to-edge, no internet.
Alternative to
Superwhisper
Voice interface for Claude Code with local Whisper and spoken answers
Featured
Alternative toGrok Bot
AI teammates you own: your keys, your model, your machine.
Alternative to
Superhuman
AI email assistant that drafts replies and clears your inbox
Alternative toClaude Managed Agents
Open-source agent deployment API. Self-host or use Omnara Cloud.
The projects we add and every new guide. Free, unsubscribe any time.
Claude Code to 
OpenCode
Jira to 
Windshift
Notion to 
AppFlowy
Slack to 
Mattermost
Linear to 
GitLab
Wispr Flow to 
Handy
CapCut to 
Concat
Grok Bot to 
rakazo
Superhuman to 
Inbox Zero
Airtable to 
AITable
Muse to 
OpenClaw
GitHub Copilot to 
Cline
Datadog to 
Netdata
Microsoft Teams to 
Rocket.Chat
Pinecone to 
Qdrant
Zapier to 
n8n
Devin AI to 
OpenHands
Firebase to 
Supabase
1Password to 
KeePassXCConfluence to 
Docmost
Contentful to 
Strapi
Adobe Premiere Pro to 
Shotcut
ChatGPT to 
AnythingLLM
LangSmith to 
Langfuse
