How gathin23/cleanyourtv works
CleanYourTV replaces an Android TV’s ad-filled home with a configurable launcher, while leaving disabled packages installed and providing a restore path. The documented workflow is: connect over Wi‑Fi with ADB, back up package/settings state, disable selected bloat, then install the launcher as Home. The launcher also handles remote-key behavior; the repository tree shows many independent TV add-ons, including screensavers, utilities, calendars, and smart-home integrations. Launcher UI internals and most add-on wiring were not sampled, so those relationships are omitted or marked unverified.
Main entry points: disable.sh Bloat disabling · build-and-install.sh Launcher install · launcher CleanYourTV home · RemoteKeys.java Remote key mapping
Components 20
TV setup
- State backup
tools/disable.sh - Bloat disabling
tools/disable.sh - Restore path
tools/disable.sh - Launcher install
launcher/build-and-install.sh
Launcher
- CleanYourTV home
launcher - Home key service
launcher/app/src/main/java/com/gathin/tvhome/HomeKeyService.java - Input key service
launcher/app/src/main/java/com/gathin/tvhome/InputKeyService.java - Remote key mapping
launcher/app/src/main/java/com/gathin/tvhome/RemoteKeys.java - Themes and cards
launcher
TV add-ons
- Frigate Glance
addons/frigate-glance/app/src/main/java/io/github/nickld/frigateglance/GlanceService.java - Frigate settings
addons/frigate-glance/app/src/main/java/io/github/nickld/frigateglance/ConfigStore.java - Game calendars
addons/game-day/app/src/main/java/io/github/justinnewman/gameday/Calendar.java - News screensaver
addons/news-screensaver/app/src/main/java/com/gathin/newsdream/News.java - Photo screensavers
addons/photo-screensaver - Smart home
addons/smart-home/app/src/main/java/io/github/maxhayim/smarthome/HaClient.java - Brightness control
addons/brightness/app/src/main/java/io/github/maxhayim/brightness/DimService.java - Tatami screensaver
addons/tatami/plan/src/main/java/io/github/pbanddev/tatami/View.java
Other components
- TV owner
- Android TV
- ADB over Wi-Fi
Connections 12
- TV owner → Android TV: enables debugging
- TV owner → ADB over Wi-Fi: connects over Wi-Fi
- ADB over Wi-Fi → State backup: backs up
- State backup → Bloat disabling: precedes
- ADB over Wi-Fi → Bloat disabling: disables packages
- Bloat disabling → Restore path: can undo
- ADB over Wi-Fi → Launcher install: installs
- Launcher install → CleanYourTV home: sets as Home
- Home key service → Remote key mapping: uses key mappings
launcher/app/src/main/java/com/gathin/tvhome/HomeKeyService.java - Input key service → Remote key mapping: dispatches keys
launcher/app/src/main/java/com/gathin/tvhome/InputKeyService.java - CleanYourTV home → Themes and cards: supports
- Frigate Glance → Frigate settings: loads settings
addons/frigate-glance/app/src/main/java/io/github/nickld/frigateglance/GlanceService.java