# gathin23/cleanyourtv

> CleanYourTV is a set of scripts and an Android launcher for removing manufacturer telemetry, ads and preloaded apps from Android TV and Google TV over Wi-Fi. It disables those packages rather than uninstalling them, then installs its own launcher as the home screen. The project is written mainly in Python, with Java and Kotlin for the Android code.

Source: https://github.com/gathin23/cleanyourtv
Indexed: commit 04aec4b on 2026-11-04 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Python
- Stars: 59,091 at index time
- Code health: 8.2/10, Good
- Last commit: 2026-11-04
- Contributors: 989

## How it works

The owner turns on USB debugging on the TV, and a computer on the same Wi-Fi network connects to it over ADB. The steps in PROMPT.md drive a coding assistant, which reuses tools/disable.sh to back up the installed packages and disable telemetry, ad services and preloaded apps with pm disable-user. tools/manage.py is the entry point for the scripts in the tools directory, and tools/tv.py is one of its central helpers. launcher/build-and-install.sh builds the Android launcher and installs it as the default home screen, and MainActivity.java in launcher/app is the launcher's main screen. The addons directory holds optional apps and scripts that run separately from the core debloat.

- addons/ad-blocking/app/src/main/java/io/github/maxhayim/adblocking/ConfigProvider.java: entry point
- addons/ad-blocking/app/src/main/java/io/github/maxhayim/adblocking/MainActivity.java: entry point
- addons/ad-blocking/app/src/main/java/io/github/maxhayim/adblocking/Server.java: entry point
- addons/airplay-status/app/src/main/java/io/github/maxhayim/airplaystatus/MainActivity.java: entry point
- addons/bluetooth-connect/app/src/main/java/com/gathin/btconnect/MainActivity.java: entry point
Modules: addons, tests, launcher, tools, themes. 1,768 files, 100,194 lines, 12,043 symbols.

## Code health

- Score: 8.2/10 (Good)
- Rank: #60 of 4,000+ indexed repos
- Hotspots: launcher/app/src/main/java/com/gathin/tvhome/MainActivity.java, launcher/app/src/main/java/com/gathin/tvhome/AppAdapter.java, launcher/app/src/main/java/com/gathin/tvhome/Config.java, launcher/app/src/main/java/com/gathin/tvhome/AppLibraryDialog.java, launcher/app/src/main/java/com/gathin/tvhome/RemoteKeys.java
- Lowest file: launcher/app/src/main/java/com/gathin/tvhome/MainActivity.java
- Dead code: none found

## Maintenance

- Last commit 2026-11-04, first commit 2026-10-17, 3,118 commits
- 989 contributors, bus factor 5

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/gathin23/cleanyourtv/security

## More

- Page: https://repowise.dev/repo/gathin23/cleanyourtv
- Ask this codebase: https://repowise.dev/repo/gathin23/cleanyourtv/chat
- Docs: https://repowise.dev/repo/gathin23/cleanyourtv/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/gathin23/cleanyourtv
