CleanYourTV — Debloat Android/Google TVs over Wi-Fi, replace ads with a clean Apple TV-style home screen.
Analyzed by Sai Pavan Gopularam · Smart Home · Customization · View on GitHub
- Stars: 10127
- Forks: 1138
- Commits last 30 days: 100
- Health: Active (100 commits this month)
- Language: Java
- License: Other
What It Is
Imagine your smart TV is like a billboard constantly showing you ads and unnecessary apps, even when you just want to watch Netflix. CleanYourTV is a tool that takes that billboard and transforms it into a minimalist, ad-free display, much like an Apple TV. It works by using standard Android debugging features to disable the hidden bloatware and ad services, then installs a super lightweight custom home screen.
This matters because modern smart TVs often prioritize ad revenue over user experience, leading to slow interfaces, privacy concerns, and constant interruptions. CleanYourTV kills this problem by giving you back control, making your TV faster, more private, and pleasant to use without needing to buy expensive new hardware or delve into complex technical setups.
License Verdict
MIT License — Build and Sell Freely — Commercial Use Approved • No Copyleft Restrictions
The MIT License allows you to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software. You can use this code in proprietary products without needing to open-source your own code. It's highly permissive for commercial use.
How to Use It
Set up your TV by enabling USB debugging in developer options. Then, use a coding AI assistant (like Claude Code) on your computer, connected to the same Wi-Fi, to paste the provided prompt. The assistant will guide you through the debloating and launcher installation process.
Prerequisites:
- Computer on same Wi-Fi as TV
- Android TV or Google TV
- Coding AI assistant with shell access (e.g., Claude Code)
- ADB tools installed (optional, AI handles it)
Estimated setup time: 15 minutes.
brew install android-platform-tools
# On TV: Settings -> Device Preferences -> About -> Build (7x OK) -> Developer options -> USB debugging ON
# Find your TV's IP address
adb connect <TV_IP_ADDRESS>:5555
# Then, paste PROMPT.md into your AI assistant and follow its instructionsWhat I'd Build With This
Custom TV Launcher Builder (micro-saas)
A web service where users input their TV model, select desired apps for the dock, and choose a theme. The service then generates a personalized debloat script and a custom launcher APK, which users can sideload. This offers a streamlined, non-AI solution for less tech-savvy users.
Effort: 1 Month Build Time · Target: Non-technical Smart TV Owners · Pricing: $19 one-time per TV
Smart TV Management Platform for Businesses (saas)
Develop a dashboard for businesses (hotels, retail, waiting rooms) to remotely manage and debloat multiple Android/Google TVs. Features would include bulk deployment of custom launchers, content control, remote troubleshooting, and device health monitoring. This centralizes management for commercial environments.
Effort: 3 Months Build Time · Target: Hotels, Retail, Healthcare · Pricing: $99/month per 10 TVs
White-Label Smart TV OS Customization (enterprise)
Partner directly with TV manufacturers or large hospitality groups to offer a pre-integrated, white-label solution. This would involve customizing the base Android TV OS with a branded, ad-free, and performance-optimized experience, going beyond just a launcher to a full custom firmware or OS layer. Requires deep technical integration and business development.
Effort: 6-12 Months Build Time · Target: TV Manufacturers, Large Hospitality Groups · Pricing: Custom Enterprise Contract
Sai Pavan Gopularam's Take
This is brilliant. It solves a real pain point for anyone with a modern smart TV that's become an ad billboard, giving them a premium experience for free. I could see a simple web service charging $19 for a custom debloat script and launcher APK, easily making $5,000/month if they get just 10 sales a day.
Watch Out For
- AI Assistant Dependency: The primary setup method relies heavily on a coding AI assistant (like Claude Code). Users without access or familiarity with such tools might find the process less straightforward than traditional software installations.
- Partial Support for Some TVs: While widely supported, Fire TV devices only get the debloat features, not the custom launcher. A few specific TCL models also refuse any third-party launcher, limiting the full experience for those users.
- Developer Mode Requirement: To connect, users must enable 'USB debugging' in their TV's developer options. This might be an unfamiliar or uncomfortable step for non-technical users, potentially raising security concerns for some.
I break down trending repos like CleanYourTV every week — join the newsletter.