Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.
Add-ons
Small, optional Android TV apps that plug into the launcher as a module card, kept in this repo
so they are easy to find, build and review. The launcher in launcher/ never
depends on them: it is built, tested and size-checked without this folder, so an add-on can't make
the core bigger or change how it behaves. You install an add-on only if you want it.
Add-ons
| Add-on | What it does | Author | Tested on | Permissions | Screenshot |
|---|---|---|---|---|---|
| Tatami | A screensaver of small rooms that rearrange themselves in slow, quiet motion, in two looks that take turns, drawn live on the TV with no network; the card shows it full screen, with its effects one press away | @PBandDev | Sony Android TV 10 (model private) | None | ![]() |
| Jewish Calendar | Offline Hebrew and Gregorian dates, holiday/Shabbat greetings, and an optional clock screensaver | lionlev21 | Android TV 12 (model private) | None | ![]() |
| Nepali Calendar | Offline Bikram Sambat and Gregorian dates in Devanagari and Latin, a BS month grid with weekends and fixed-date national days in red, and an optional clock screensaver | @1yuv | Hisense 50A6H4 (SmartTV 4K, songshan), Android TV 11 | None | ![]() |
| Frigate Glance | Frigate camera pop-ups over whatever is playing | NickLD | TCL 65Q650G | overlay, accessibility (card keys), network, foreground service, start at boot | ![]() |
| Capacity Stats | Available/total and used/total RAM; available/total storage | lionlev21 | Android TV 12 (model private) | None | ![]() |
| Weather | The weather for one city: now, US air quality and the next three days, from Open-Meteo (no key) | @Sumyabazar1 | Hisense SmartTV 4K FFM (lushan), Google TV 12 | INTERNET |
![]() |
| Photo Prints | Your own photos as a screensaver: dated prints dealt in on a time-of-day sky, and a card that starts the slideshow | @shivamsingh262 | Sony BRAVIA KD-65X82L (Google TV 12) | None | ![]() |
| Photo screensaver | Your own pictures and MP4 clips as the TV's screensaver and as a card, slowly zooming and crossfading (20 s each by default); optional time, photo dates, prints on a sky and weather | JorickGU | TCL 43P69K (Google TV 12) | INTERNET and coarse location, only with the weather option on |
![]() |
| Prayer Times | Today's prayer times for one city from Aladhan (no key), the next prayer with a countdown, Gregorian and Hijri dates | @majnioui | Xiaomi TV (MiTV-MOOR2), Google TV 11 | INTERNET, start at boot, exact alarm, overlay (only with reminders on) |
![]() |
| TV Hub | One live-TV guide for M3U/XMLTV playlists, Dispatcharr and HDHomeRun tuners, with a Media3 player and shortcuts to installed live-TV apps | @maxhayim | MOKA R8G (Android TV 14) | INTERNET |
![]() |
| Headphones | Bluetooth headphones made easy: where the sound goes, paired pairs with battery, a pairing shortcut, and a quiet guard that pauses and mutes the speakers when headphones drop | @maxhayim | MOKA R8G (Android 14) | Bluetooth (paired devices only) | ![]() |
| TV Static | An off-the-air moment each time the screen turns on: the picture opens from a bright line, snow and hiss, colour bars or an old "no signal" screen for 3 to 10 s, then fades into what was on screen; the card sets style, sound and length | @luyzfernando08 | Xiaomi Mi Box S (Android TV 9), Philco by Skyworth (Android TV 14) | foreground service (screen-on watcher), start at boot, display over other apps | ![]() |
| Open on wake | Opens the app you choose each time the screen turns on, optionally at a link (a video, a channel); the card shows the app as a picture and sets the wait | @luyzfernando08 | Xiaomi Mi Box S (Android TV 9), Philco by Skyworth (Android TV 14) | foreground service (screen-on watcher), start at boot, display over other apps | ![]() |
| Brightness | Dims the picture below the TV's own minimum over every app (and the picture settings on Realtek TVs), with a warm night mode on a schedule and a one-press normal screen | @maxhayim | MOKA R8G (Android 14) | overlay, foreground service, start at boot | ![]() |
| Sleep Timer | A sleep timer: 15 to 120 minutes, a one-minute countdown over what is playing with "15 more minutes", then standby; over HDMI-CEC the TV turns off with the box | @luyzfernando08 | Xiaomi Mi Box S (Android TV 9) | accessibility (lock-screen action only), display over other apps, exact alarms | ![]() |
| Scoreboard | Streaming app usage leaderboard tracking launches and watch time with D-pad click-to-launch | @EricWoodford | TiVo Stream 4K (Android TV 12) | PACKAGE_USAGE_STATS (granted via ADB) |
![]() |
| Quiet Hours | A volume cap for the night (or all day): the volume is brought back down to the cap whenever it goes above, a muted TV is left alone, headphones can stay uncapped | @maxhayim | MOKA R8G (Android 14) | foreground service, start at boot | ![]() |
| Remote Access | Whether the TV is open to remote control: network debugging (ADB) and its port, the TV's address, Tailscale, and a button that switches network debugging off | @maxhayim | MOKA R8G (Android 14) | network state; WRITE_SECURE_SETTINGS granted by ADB, only for the off button |
![]() |
| Bluetooth Connect | Paired Bluetooth speakers and headphones with a Connect / Disconnect button, which the TV's own settings lack | @thenewnano | Philips UHD Android TV (Android 14) | Nearby devices (BLUETOOTH_CONNECT), granted by ADB |
![]() |
| AirPlay Status | How iPhones and Macs see this TV: its AirPlay name, screen mirroring offered or audio only (and why), and the other AirPlay receivers on the network | @maxhayim | MOKA R8G (Android 14) | network (mDNS listening only), network state | ![]() |
| Sources | The TV's sources by the names devices give themselves over HDMI-CEC ("PlayStation 5", not "HDMI 2"), with their state, and Live TV; OK switches | @maxhayim | MOKA R8G (Android 14) | None | ![]() |
| Smart Home | Home Assistant on the TV: weather and fuel prices at a glance, scenes, lights and switches (OK toggles, left and right dim), climate, temperature and humidity, doors and windows, and locks shown but never opened | @maxhayim | MOKA R8G (Android 14); Sony BRAVIA (Android 9) | INTERNET (your Home Assistant only) |
![]() |
| Ad Blocking | Your Pi-hole (6 or 5) or AdGuard Home on the TV: today's queries and blocked share, and one OK to pause blocking for five minutes | @maxhayim | MOKA R8G (Android 14) | INTERNET (your blocker only) |
![]() |
| Startup & Branding | A welcome screen of your own: your picture, a background colour and a line of text, full screen for a few seconds or until Back or OK, with a live preview, Fit/Fill/Stretch/Original scaling and a compatibility check of what the TV allows without root | @maxhayim | MOKA M1G (Android TV 11) | None | ![]() |
| World Clock | One to six offline clocks with dates, UTC offsets and day differences; city search and D-pad controls | @SaviorOneZero | Samsung C71KW-200 / AT&T Osprey (Android TV 11) | None | ![]() |
| Flock | An interactive flocking simulation using separation, alignment and cohesion, controlled with the TV remote | CleanYourTV contributors | TCL 32S5K (Android TV 14) | None | ![]() |
| News screensaver | Headlines from your own RSS and Atom feeds as the TV's screensaver and as a card, one at a time with source, age, a QR code to the article and Left/Right paging; feeds (with names), seconds per headline and idle time are set with setup.sh or on the TV |
@modist | Philips 2021/22 UHD Android TV (Android 11) | INTERNET |
![]() |
| Digital Rain | A Matrix-style screensaver: mirrored katakana and digits falling in green trails with bright heads, drawn on the TV with no network; the card starts it at once | @dennis-oleary | NVIDIA SHIELD Android TV Pro 2019 (Android TV 11) | None | ![]() |
| Bluetooth Toggle | For Android 12 and older (13 and newer do not let apps switch Bluetooth). A one-press Bluetooth switch: the tile turns Bluetooth off or on, a small panel says which, and Pair accessory is one press away | @justin-newman | Hisense 75U75N (hengshan), Google TV 12 | Bluetooth (BLUETOOTH_CONNECT) |
![]() |
| TV Inspector | What the remote sends (key name, key code, scan code, device) and what the TV can play: display modes, HDR, video decoders, audio outputs and formats, input devices; every line also in logcat for a tv.json or a bug report |
@shaharukhs | Sansui TV (Skyworth eleonas, MediaTek MT9676), Android TV 14 | None | ![]() |
| Game Day | Each team's next game on Home, counted down ("Puck drop in 2h 18m", then "Live now"), from calendar links you add: any team, any sport, no scores; one turn per team, rotating, with the theme's F1 weekend | @justin-newman | Hisense 75U75N (hengshan), Google TV 12 | INTERNET (your calendar links only) |
![]() |
| Haunted | A Halloween screensaver (and a card that starts it): the theme's night photos crossfading, bats drifting across, a ghost floating up, a flickering jack-o'-lantern glow and a small clock, drawn on the TV with no network | CleanYourTV contributors | Not yet tested on a real TV | None | ![]() |
| Lịch Vạn Niên | Vietnamese lunar almanac, offline: the tile says whether today is hoàng đạo (auspicious) or hắc đạo and lists the day's good hours; OK opens the lunar date, can chi, the day's star and trực, a 12-hour ring with the zodiac animals, and what the day suits or should avoid; Left/Right page through days | @mevvmevvcodinggarg | Expressluck AiPro4K (sepolia), Android TV 14 | start at boot (re-enable today's tile) | ![]() |
A widget, an info tile, a storage or smart-home card: if it can live as its own small app, it can live here. See the rules below.
How an add-on works
An add-on is a normal Android TV app with its own Gradle project in addons/<name>/. It declares a
card with the existing module-card contract: the how-to is docs/modules.md
and the spec is docs/specs/card.md. The launcher finds the card, asks the
TV owner once, and shows it as a tile with the add-on's label, caption and glow colour. Nothing else
connects the two.
Build one (JDK 17, Android SDK 34, as for the launcher), from the repo root:
macOS / Linux:
cd addons/<name> && ./gradlew assembleRelease && cd ../..
TV_HOST=<tv ip> tools/venv/bin/python -I tools/tv.py --push addons/<name>/app/build/outputs/apk/release/app-release.apk /data/local/tmp/addon.apk
TV_HOST=<tv ip> tools/venv/bin/python -I tools/tv.py 'pm install -r /data/local/tmp/addon.apk; rm -f /data/local/tmp/addon.apk'
Windows (Command Prompt):
set TV_HOST=<tv ip>
cd addons\<name>
gradlew.bat assembleRelease
cd ..\..
tools\venv\Scripts\python.exe -I tools\tv.py --push addons\<name>\app\build\outputs\apk\release\app-release.apk /data/local/tmp/addon.apk
tools\venv\Scripts\python.exe -I tools\tv.py "pm install -r /data/local/tmp/addon.apk; rm -f /data/local/tmp/addon.apk"
When something goes wrong with gradlew.bat assembleRelease
If the build fails with:
FAILURE: Build failed with an exception.
What went wrong:
Could not determine the dependencies of task ':app:lintVitalReportRelease'.
> SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable or by setting the sdk.dir path in your project's local properties file at 'C:\...\addons\<name>\local.properties'.
Solution:
Create a local.properties file inside addons/<name>/ pointing to your Android SDK installation path:
sdk.dir=C:/Users/<user name>/AppData/Local/Android/Sdk
(Replace <user name> with your Windows user name. Use forward slashes: a backslash is an escape character in this file.)
Or let tools/manage.py do it the creator's way: it lists every add-on with its screenshot, shows which are on
the TV, and installs, updates or removes one by running the add-on's own install.sh or build-and-install.sh
(or the three steps above when it has none):
tools/venv/bin/python -I tools/manage.py list addons
TV_HOST=<tv ip> tools/venv/bin/python -I tools/manage.py status
TV_HOST=<tv ip> tools/venv/bin/python -I tools/manage.py install weather
Rules
- Its own app. One folder per add-on,
addons/<name>/, with its own Gradle project (settings.gradle,app/), its own package name and its own README. - Only through the module-card spec. An add-on never edits anything under
launcher/, andlauncher/never referencesaddons/. If your idea needs a change inside the launcher, it isn't an add-on. Open an issue first instead. - No prebuilt APKs in the repo. People build from source, as with the launcher.
- Permissions up front. The add-on's README lists every permission it asks for and why, plus
any network access or background service, and the Permissions column of the table above carries the
same list in one line: a reader scanning it sees what each add-on can do without opening its README,
so an add-on whose manifest asks for something the column leaves out is a bug in this page.
The rules in
docs/modules.mdapply: no telemetry without an opt-in, no ads, your own art. - Tested on a real TV. Say which one in the README and in the table above.
- A screenshot.
addons/<name>/screenshot.jpg: the add-on on a real TV, its card in the grid or its own screen, as a JPEG, 16:9 (1280×720 is plenty) and under 300 KB, shown in the table's Screenshot column. It is what people see first here and on cleanyour.tv/addons. Take it withtools/tv.py --screenshot shot.png(oradb exec-out screencap -p > shot.png), thensips -s format jpeg -s formatOptions 85 -z 720 1280 shot.png --out screenshot.jpgon a Mac. Blur anything personal: Wi-Fi names, people, addresses. Add-ons marked "wanted" in the table came before this rule; a screenshot for one of them is welcome. - The author maintains it. Issues about an add-on are assigned to its author. An add-on that
breaks on current Android TV versions, or goes unmaintained, may be removed. Its history stays in
git, and you can keep it going in a fork listed in
SHOWCASE.md.
Adding one
Open a pull request that adds addons/<name>/ and one row to the table above. The core CI is not
blocked by add-ons: a separate workflow builds whatever changed under addons/, and
tests/test_addons.py checks the folder rules (own Gradle project, a README with a Permissions
section, a screenshot, no APKs, a row in this table showing the screenshot) and that the launcher never includes or references this folder.
tests/test_addon_permissions_index.py holds each row's Permissions column and the add-on's own
Permissions section to the uses-permission lines in its AndroidManifest.xml, so a new permission
cannot reach a TV without the two pages saying so.
































