# cleanmytv (wingedpanther/cleanmytv)

> A free Mac and Windows app that cleans up your Android TV over Wi-Fi. It switches off preinstalled bloatware and installs CleanMyTV Home, an ad-free home screen you set up from your computer.

- GitHub: https://github.com/wingedpanther/cleanmytv
- GitHub.Locker page: https://github.locker/wingedpanther/cleanmytv
- Stars: 651
- Language: TypeScript
- License: MIT
- Last push: 2026-11-17

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is it a launcher or a cleaner?**

Both. It disables the preinstalled packages on your TV and replaces the home screen with its own launcher, CleanMyTV Home. Nothing is uninstalled, and the Restore step puts every package back.

**How do I get it running?**

Download the installer from the Releases page. On the TV, open About, press Build seven times to enable developer mode, then turn on USB debugging. Keep the TV on the same Wi-Fi as your computer, open CleanMyTV, pick your TV and press Allow on the TV. Then run Clean & launch.

**Do I need Python, Java or Android Studio first?**

No. You don't need Python, Java, Android Studio or adb installed on your computer. The only requirement on the TV side is developer mode with USB debugging enabled.

**What should I watch out for?**

The installers are unsigned, so macOS and Windows will warn you the first time and need a manual OK. On a Mac you must allow local network access, or the app cannot reach the TV.

**Which computers and TVs does it support?**

Macs with Apple silicon or Intel need macOS 13 Ventura or newer, and Windows 10 or 11 is supported too. CleanMyTV Home needs Android 9 (API 28) or newer on the TV.

**Does it send anything off my network?**

Only to your TV, over ADB on port 5555 of your local network. Beyond that it contacts api.github.com at most twice a day to check for a newer version (it downloads nothing), dl.google.com only when you click Wireless debugging pairing, and www.bing.com only if you choose Bing's picture of the day.

**What does CleanMyTV Home change on the TV?**

It replaces the stock home screen with an ad-free launcher with three layouts (Shelf, Split, Rail). You set the apps, rows, folders, wallpaper, themes, music bars and remote buttons from your computer, and the TV shows each change as you click.

**Can I undo everything?**

Yes. Restore puts every disabled package back the way it was before the first cleanup. If CleanMyTV Home doesn't come back after a restart, the app puts the stock launcher back on its own.

**Does it work with any Android TV?**

The cleanup lists cover 371 TVs from 100 brands. For an unlisted TV it starts with lists from its brand and suggests packages other TVs have disabled, and the known-devices table shows what is covered per model.

**What is the fireplace feature?**

A looping log-fire video of about 11 MB that the app downloads once and sends to the TV. You can show it full screen, make it the screensaver or put it behind Home, and set it to turn off after 30 minutes, 1 or 2 hours.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/wingedpanther/cleanmytv/blob/main/README.md

# CleanMyTV

A free Mac, Windows and Linux app that cleans up your Android TV over Wi-Fi. It switches off the preinstalled
bloat and puts in CleanMyTV Home, an ad-free home screen you set up from your computer. You don't need
Python, Java, Android Studio or `adb`.

The per-TV cleanup lists come from [cleanyourtv](https://github.com/Gathin23/cleanyourtv) by
[@gathint](https://x.com/gathint). Thanks, Gathin.

New to this? The **[user guide](docs/USER-GUIDE.md)** walks every step at TV-owner pace, including
rollback and troubleshooting, and the **[known-devices table](docs/KNOWN-DEVICES.md)** shows what the
bundled lists cover per model. This README is the technical overview.

Questions, help and home-screen setups: join the **[CleanMyTV Discord](https://discord.gg/6hZeQkDYf9)**.
Bugs and feature requests go to [GitHub issues](https://github.com/wingedpanther/cleanmytv/issues).

### New in 0.13.1

- **Uploads that pick up where they stopped (#121):** if the TV closes Home while the fireplace, a theme
  or a slideshow picture is going over, Home carries on with the part it already has. The app also tries
  a failed file once more before it gives up.
- **Rows run to the screen edge (#124):** apps slide off the side of the screen instead of being cut off
  short of it.
- **Mono icons with the Glow focus (#119):** the focused app is white with a black logo, like the top bar.
- **Where the Bing picture was taken (#123):** Bing's caption shows small in the bottom corner. Turn it
  off with **Show where it was taken**.

### New in 0.13.0

- **German:** the app and CleanMyTV Home now come in German, translated by WiesoBistnSuus from our Discord.
  Want CleanMyTV in your language? Ask on Discord: it's a spreadsheet, no coding.
- **Continue watching:** a row on Home with what you were part-way through, from Android's Watch Next list.
  It's a section, so you can move it or turn it off. Hidden apps stay out, and locked apps ask for the PIN.
- **Christmas theme:** a winter night with fairy lights and falling snow. **Snow** has its own switch under
  Wallpaper, so it works with any theme.
- **Power on (#94):** choose the input the TV opens when it comes on, and how long to wait first. The
  check-up also finds TVs that HDMI devices can't turn on, and fixes them.
- **Match frame rate** in TV extras, so films at 24 fps don't judder (Android 12 and later).
- **Hourly forecast** under the weather, off unless you turn it on in Widgets.
- **Grids for App lock and the app order (#117):** pick and move apps on a grid with the remote, plus Lock
  All and Unlock All. Thanks to harikrishna-salver.
- **Fixes:** the fireplace crackle plays on TCL TVs where it was silent (#118). Mono icons with the Glow
  focus show black on white (#119). The TV's wallpaper picker shows a preview. Home stays the Home app on
  Google TV 14 and Haier TVs that carry a hidden launcher entry.

### New in 0.12.0

- **Russian:** the app follows your computer's language and CleanMyTV Home follows the TV's. You can
  pick the app's language in the sidebar. Built on linaiven91-cyber's translation (#83).
- **Check-up after Clean up:** after Apply, Clean up checks the keyboard, the Home button, the remote's
  microphone and the screensaver, with a button to fix each. The Finish step has the same check.
- **Record a problem:** in the Activity drawer, record the TV's log while you make the problem happen,
  then save it as a file for your GitHub issue. Addresses and email addresses are taken out.
- **The keyboard stays after standby (#98):** on TVs that switch to the phone keyboard every time they
  wake, Home puts yours back straight away. **Keep my keyboard** turns it off.
- **Brightness (#74)** in Quick settings and as a remote button action, plus a Picture & sound row.
- **Fireplace (#116):** listed in the top bar and the TV's screensavers only while it's on the TV.
- **Search on the TV** goes straight to the setting. The PIN pad takes the keyboard's Delete key.

### New in 0.11.0

- **Each theme keeps its own look** (LimeNinja's idea): change the look on the TV while a theme is on,
  and that theme keeps it. That covers colours, tile sizes, glass, dimming, shading, spacing and music
  bars. Switch themes and each one comes back the way you left it, at the day and night switch too.
  Rows, folders, App lock and buttons stay the same for every theme. **Forget changes** puts a theme back.
- **Save to the TV:** the Look tab saves the TV's look and wallpaper as a theme on the TV, next to the
  built-in ones, or updates the theme with that name. On the TV, **Save this look as a theme** does the
  same. Putting the built-in themes on the TV again keeps the ones you saved.
- **The keyboard stays (#98):** on TVs that switch to the phone-remote keyboard at every restart, Home
  now puts yours back. The 0.8.0 fix couldn't see the TV's keyboards. Clean up also leaves on any app
  that carries a keyboard, like Google's speech services.
- **Copy for a bug report** lists the TV's apps, on and switched off, and its keyboard. New TV lists
  are made from that.
- **App lock:** with App lock on, showing hidden apps or resetting the app order in the editor asks for
  the PIN (thanks harikrishna-salver).
- **Smoother Home:** the layout is worked out once per change instead of on every redraw, and the app
  colour wash and the sunrise no longer redraw the whole screen while they fade.
- **Editor colours:** with a white or near-white accent, the editor marks picked items in its own blue,
  so they don't look focused.
- **TCL 75Q6C** shows on the TCL 55Q6CX1 list. They share the G08 board.

### New in 0.10.0

The big one: **CleanMyTV Home can now be set up from the TV itself.** Turn on **Edit on the TV** in the
desktop app once, and a Customize icon in Home's top bar opens an editor you drive with the remote.

- **Customize from the remote** (thanks harikrishna-salver for the editor, #95): layout and sections,
  rows and folders, look and shading, themes and wallpaper, widgets, apps, remote buttons, App lock,
  music bars, the fireplace, the greeting and names. It wears your theme's colours, and it has its own
  PIN switch in App lock.
- **Search settings:** type "font", "PIN", "photo" or "sleep" and jump straight to the setting.
- **Photos from your phone:** scan a QR code on the TV and send a photo as the wallpaper or into the
  slideshow. No computer, and no storage permission.
- **Home updates itself:** when a new version is out, an update icon shows in the top bar, with the
  release notes, and Android's own installer does the rest. Your settings stay.
- **Sleep timer:** 15 minutes to 2 hours, from a top bar icon or a remote button, with "Sleeps at"
  under the clock.
- **Daily limits:** give an app so many minutes a day; after that it needs the PIN for the rest of the day.
- **Idle screen styles:** the clock in the corner, a big clock, or your photos with the clock.
- **Fonts:** usual, condensed, serif or casual. Themes carry the font.
- **Bing every day:** Bing's new picture becomes the wallpaper each day.
- **Fixes:** Rail lines the weather and date up under the clock; square tiles in All apps line up with
  the heading; Mono cuts the marks out of more logos, like RTL+ and Nova Video Player (#113); Home's
  menus use your accent instead of green (#112); setting a PIN on the TV uses Home's own number pad.

### New in 0.9.0

- **Linux:** an AppImage for 64-bit Linux (#109, thanks Morditux).
- **Recently used:** a Home section with the last 8 apps the TV opened, newest first, however they were
  opened. Turn it on under Layout → Sections (#85).
- **Shading:** sliders for how strong the top and bottom shades over the wallpaper are and how far they
  reach, and the same for the app colour wash. Themes and day and night looks carry them.
- **Long press:** letting go of OK no longer picks Move from the menu.
- **HEIC pictures:** iPhone and Mac photos work as wallpapers and in the slideshow (on a Mac).
- **Pairing:** when it fails, the app says why: a wrong code, a closed pairing window, a TV that's off, or
  another device on the TV's address. The example port numbers that looked real are gone from the form.
- **Tile shape** shows under Banners too, with a note on how to change it.
- **Windows:** the installer stops on Windows 8.1 and older, and on 32-bit Windows, and says why (#107).
- **Mac:** the app names the network services it looks for, so macOS asks for local network access (#65).
- **TCL:** Clean up leaves the TCL Home phone app's packages on unless you tick them (#81).
- **CleanMyTV Home on its own:** each release has the launcher's APK, for updating it without the desktop app.

### New in 0.8.0

- **Remote buttons stay on.** Home turns its button service back on after a reboot, or when the TV
  switched it off, so mapped buttons keep working (#78).
- **Weather from MET Norway** when the network blocks Open-Meteo (#76, #80).
- **Inputs:** Live TV shows once, even on TVs with a tuner per broadcast type, and a new switch hides
  it (#50).
- **Bluetooth button:** on TVs that block the pairing screen, it opens Settings instead (#97).
- **Rename the Quick settings buttons** and the All apps title (#67).
- **Mono icons** cut the shape out of single-colour icons (#91).
- **Save a snapshot** of the TV screen to your computer (#92).
- **Xiaomi:** Clean up and Finish say when USB drives stop working while debugging is on (#71).
- **Memory:** free memory under the clock, and a Clean memory button that closes apps left running in the
  background, on Android 9 to 13. Android 14 doesn't let one app close another.
- **Day and night looks:** save one look for the day and one for the night, and Home swaps them at the times
  you set. Any theme works, shared ones too.
- **Mono glass:** a slider for how much the tile behind each logo shows. Glow focus no longer fills Mono tiles.
- **Mice and air mice:** point at a tile to move to it, click to open it.
- **No more green haze:** the shade over the wallpaper uses your background colour (#102).
- **Dock:** tiles grow past 100% (#89), and the dock stays where Space above the apps puts it (#90).
- **Volume:** holding a volume button repeats again on TVs where remote buttons stopped it. Home only listens
  to buttons while one is mapped (#87).
- **Keyboard:** on TVs that switch back to their own keyboard at every restart, Home puts yours back (#98).
- **Clean up:** Netflix, YouTube, YouTube Music, Prime Video and other streaming apps stay on unless you tick them.
- **Another launcher:** one you installed with Install an app can be Home instead (#82).
- **Keep Google TV's launcher on:** for TVs where Apple TV or Netflix stop playing, or Google Photos albums
  won't load, without it (#99, #88). CleanMyTV Home comes back in front after a Home press.
- **Update from the app (#93):** when a new version is out, Update now in the sidebar downloads it, checks it
  against the release's checksums, installs it and opens CleanMyTV again. This starts with the version after
  this one.
- **Long press an app on Home** for Move, Hide, App info and Uninstall. Move lets the arrow keys put the app
  anywhere in the dock, All apps or its row, with no computer needed.
- **Back to the input at power on:** if the TV went to sleep on HDMI or TV channels, it wakes up there (#94).
- **Fire TV:** installing no longer reports an error, CleanMyTV Home only comes back in front of Amazon's home
  screen, and Clean up says which Amazon apps Fire OS won't let go.
- **Volume with mapped buttons:** a volume press pauses the button service for 4 seconds, so holding it repeats.
- **Clean up** keeps the keyboard you type with on, whatever the list says.
- **472 TV lists from 129 brands**, up from 371.

### New in 0.7.2

- **Fireplace on every TV.** The fireplace now goes onto the TV through CleanMyTV Home itself, instead
  of the folder that Fire TV, Xiaomi boxes and some TCL TVs refused (#70).
- **Fire TV:** CleanMyTV Home comes back in front when Fire OS opens its own launcher, as long as remote
  buttons are on. Thanks Sean Warren.
- **USB drives and YouTube ads:** Clean up no longer ticks Media Player, its gallery and video player,
  Android's storage apps, or the TV's web viewers by default (#71, #55).
- **Mac:** when macOS never shows the Local Network switch, the Connect screen gives a Terminal command
  that starts the app with Terminal's network access (#65).
- **Phone apps in an Other apps folder:** apps with no TV picture can move out of the dock and grid into
  one folder (#3).

### New in 0.7.1

- **Install an app.** A new step in the sidebar. Drop an .apk on it, see the app's name, version and
  whether the TV has it already, then install it. A warning about apps from outside the Play Store
  stays on top, and if Android refuses the app, the app says why in plain words.
- **Back on the home screen** stays on Home instead of closing it (#69).
- **The theme picker on the TV** shows the picture of the theme you're on (#68).
- **Now playing** goes away when the music or video stops, or after 10 minutes paused (#66).
- **Clean & launch** leaves the Google screensaver, phone remote, casting and voice on, like Clean up
  does. Thanks nasd223.
- **Copy for a bug report** shows your home folder as ~, so it doesn't paste your computer's user
  name. Thanks nasd223.
- The restart check no longer mistakes Settings' fallback screen for a working home screen. Thanks
  nasd223.

### New in 0.7.0

- **Fireplace.** A real log fire with its crackle, looping without a seam. Show it full screen from an
  icon or a remote button, make it the screensaver, or put it behind Home. The app downloads it once
  (about 11 MB) and sends it to the TV. Set it to turn off after 30 minutes, 1 or 2 hours, and the fire
  fades before the TV sleeps.
- **Live TV in Inputs.** The TV's own tuner is first in the Inputs menu and opens your channels (#63).
- **Slideshow.** Up to 12 of your pictures, or the current theme's three, change every 5 to 60 minutes
  (#56).
- **Make your own theme.** Start from a built-in theme, pick the accent, a second colour, the background
  and the picture style, and see it before it goes on the TV.
- **Google screensaver.** TV extras switches Google's Ambient screensaver apps back on and makes it the
  screensaver again (#57).
- **Clean up after a firmware update.** It lists packages you switched off that came back on, with one
  button to switch them off again.
- **Help when Connect fails.** The app names the likely cause: macOS blocking local network access,
  another network, a VPN, or the pairing port typed into Connect.
- Folders and your name in the greeting take the theme's accent.




https://github.com/user-attachments/assets/4e3eb18a-d196-4a51-8d0e-93ce98e11913



## Download and install

Get the latest version from [Releases](https://github.com/wingedpanther/cleanmytv/releases):

| Computer | File |
|---|---|
| Mac with Apple silicon (M1 and later) | `CleanMyTV-<version>-arm64.dmg` |
| Mac with Intel | `CleanMyTV-<version>.dmg` |
| Windows 10 or 11 | `CleanMyTV-Setup-<version>.exe` |
| Linux (64-bit) | `CleanMyTV-<version>.AppImage` |

Macs need macOS 13 Ventura or newer, and Windows needs Windows 10 or 11 on a 64-bit PC. The app asks GitHub
for a newer version at most twice a day. On a Mac or Windows, **Update now** in the sidebar downloads it,
checks it against the release's checksums and installs it; on Linux, download the new AppImage.

Each release also has `CleanMyTV-Home-<version>.apk`, the launcher on its own. Installed over CleanMyTV Home
on the TV (with Downloader, for example), it keeps your settings.

The installers are not signed with a paid developer certificate, so your computer warns you the first
time:

- **Mac:** open the dmg and drag CleanMyTV to Applications, then open it. When macOS says it can't
  verify the developer, choose **Done**, go to System Settings → Privacy & Security and press
  **Open Anyway** next to CleanMyTV (on macOS 14 and earlier, right-click the app and choose **Open**
  instead). macOS asks whether CleanMyTV may find devices on your local network: choose **Allow**, or
  it cannot reach the TV.

  If macOS says CleanMyTV **is damaged and can't be opened**, you have v0.1.0, whose Mac build was
  not signed correctly. Run this in Terminal, then open the app again:

  ```bash
  xattr -cr /Applications/CleanMyTV.app
  codesign --force --deep --sign - /Applications/CleanMyTV.app
  ```
- **Windows:** your browser may call the download uncommon, or even dangerous, because the installer is
  new and not signed. Keep it: in Chrome, open the downloads list and choose **Keep**. When SmartScreen
  says it protected your PC, choose **More info**, then **Run anyway**.
- **Linux:** make the downloaded file executable (`chmod +x CleanMyTV-*.AppImage`) and run it. Ubuntu
  22.04 and newer do not ship FUSE 2 by default, which AppImages need: install `libfuse2t64` (Ubuntu 24.04+)
  or `libfuse2` (Ubuntu 22.04) first (`sudo apt install libfuse2t64` or `sudo apt install libfuse2`).

## Before you start: on the TV

1. Settings → Device Preferences → About (on some Google TVs: Settings → System → About).
2. Press OK on **Build** (or **Android TV OS build**) seven times, until the TV says you are a developer.
3. Back one screen → **Developer options** → turn on **USB debugging**. If you also see
   **Network debugging** or **ADB debugging**, turn that on too.
4. Keep the TV on and on the same Wi-Fi as your computer.

Open CleanMyTV, find the TV and choose **Allow** when the TV asks. Tick **Always allow from this
computer** to skip the question next time.

## What it does

| Step | What happens |
|---|---|
| **Clean & launch** | The guided path: applies the list that best matches your TV, then installs CleanMyTV Home. |
| **Setup** | Checks the network, lists the TVs on your Wi-Fi by name (a phone with Wireless debugging on can show up too, and a scan finds older TVs with port 5555 open), connects, and waits while you press Allow on the TV. Google TVs that only offer Wireless debugging get a pairing form that fills in the ports when the TV's pairing screen opens, so you only type the code. With more than one known TV, it shows them with snapshot thumbnails to pick from. |
| **Clean up** | Picks the upstream list that matches your TV's model, from 472 TVs and 129 brands. Every package shows its live state on the TV, and you choose what to disable. If your TV isn't listed, lists from its brand come first, and it offers the packages other TVs disable. You can add any package on the TV by name. |
| **Home screen** | Installs or updates CleanMyTV Home and hands Home over. If Home doesn't land on it, it rolls back. If the app can't tell which app is the TV's own launcher, it asks. Tabs for layout, apps, rows and folders, look and wallpaper, widgets, music bars and remote buttons. See below. |
| **TV extras** | Ad-blocking Private DNS, animation speed, an on-screen remote, reboot. |
| **Finish** | Restarts the TV and checks the home screen comes back; if it doesn't, puts the stock launcher back. Then walks through switching debugging off, and checks that port 5555 is closed. |

| | |
|---|---|
| ![Setup, connected to a TV](docs/setup.png) | ![Clean up: the list that matches the TV, with each package's state](docs/clean-up.png) |

Nothing is uninstalled. Packages are switched off for your user, and Restore puts every package back
the way it was before the first cleanup.

## CleanMyTV Home

No ads. Your apps, your layout, the weather and what's playing. You change everything from your
computer, and the TV shows it as you click. Or, with **Edit on the TV** switched on, from the TV with the
remote: a Customize icon in the top bar opens the same settings, with a search to find them.

| | |
|---|---|
| ![Shelf: the clock, weather and quick settings in the top corner, apps lower down](docs/home-shelf.jpg) | ![Split: the clock and quick settings on the left, apps on the right](docs/home-split.jpg) |
| **Shelf**, the default | **Split** |
| ![Rail: icons down the left edge that open with labels](docs/home-rail.jpg) | ![A folder open over the home screen](docs/home-folder.jpg) |
| **Rail**, opened | A folder |

![The Home screen step in the app, with a live preview of the TV](docs/home-editor.png)

The Home screen step has eight tabs. Every change shows on the TV straight away. The Layout and Apps
tabs have a live preview of the TV screen at the top.

| Tab | What you set |
|---|---|
| **Overview** | Install or update Home, and how to use it. Give Home back to the stock launcher. Remove the old CleanYourTV launcher in one click if it's still on the TV. Take a snapshot of the TV screen. |
| **Layout** | Three layouts: Shelf (the default), Split and Rail. Space above the apps. The now playing, dock, continue watching, rows, folders and all apps sections, in any order, each one can be hidden. Quick-settings icons: Inputs, Wi-Fi, Bluetooth, Picture & sound, Apps, Screensaver, Search, Music bars, Quick settings, Themes, Fireplace and Settings. Icons the TV can't open are marked "not on this TV". Up to 6 apps as round icons in the same row, like a VPN. Dock and row tile sizes, apps per row, app names (always, focused app only, or off), clock and greeting. An idle screen: after a set time with no button pressed, only the wallpaper and a large clock show. |
| **Apps, rows & folders** | Dock size, drag to reorder, hide apps, named rows and folders. |
| **Look & wallpaper** | Themes: 29 looks with their own wallpaper art, three pictures each, saved to and loaded from `.cmtvtheme` files, and Put it back to undo them. Put the themes on the TV to switch them with the remote. App icons: banners, or every logo redrawn in Colour, Mono or Duotone, on wide, square, squircle or round tiles. Accent colour. Focus style (lift, glow, outline or none), with options to lean the tile toward the move, keep it in place while the row slides, and tint the background in the focused app's colour. Your own picture or Bing's picture of the day, darken, background colour, and the sunrise when it changes. Snow falling over the wallpaper, on its own switch; the Christmas theme turns it on. A slideshow of up to 12 pictures. Make your own theme from a built-in one. The fireplace: put it on the TV, show it, make it the screensaver or put it behind Home, with its crackle and a turn-off timer. |
| **Widgets** | Now playing: what any music or video app plays, with play, pause and next. Weather next to the clock for a town you pick, in °C or °F. |
| **Music bars** | On or off; bars, mirrored or wave; accent, rainbow or white; peak dots, number of bars, height, opacity and sensitivity. |
| **Remote buttons** | Find what a remote button sends, then give it a job in every app: open Settings, Inputs, an app, Home, Back, Quick settings, Themes, the fireplace, the theme's next picture, and more. Off until you turn it on. Only the buttons you map are touched. Power, volume and the mic button are usually handled before Android sees them. On Xiaomi TVs, one click makes the Mi button go Home. |
| **App lock** | A 4 to 6 digit PIN, kept hashed on the TV, and the apps it locks. Optionally Settings, the Play Store and Quick settings too. An unlock lasts until the TV sleeps, 15 minutes, or until another app opens. Locked apps show a small lock on Home, or stay hidden. One switch turns it all off; the PIN and the list stay. |

Your settings and wallpaper stay through updates and reboots. The app also keeps a copy on your
computer: if CleanMyTV Home ever starts empty (after an uninstall or a factory reset), installing it
puts the copy back. The wallpaper is also kept on the TV, so another computer can save the look with it. What the launcher can access is under [Security and privacy](#security-and-privacy).

CleanMyTV Home needs Android 9 (API 28) or newer.

## Coming back to customise

Turn USB debugging on again and open the app. With one known TV, it reconnects to it. When CleanMyTV
Home is already Home it opens the Home screen step, loaded with what is on the TV now. Switch debugging
off again when you're done. If you didn't revoke the authorisations, there's no Allow prompt.

The app remembers each TV it has connected to. With more than one, it doesn't connect by itself: Setup
shows the TVs with snapshot thumbnails, and you pick one. The sidebar shows the connected TV's thumbnail.

If the router gave the TV a new address, or another device now answers at the old one, the app says so
and scans the network. You pick the TV from the list; the app does not log in to devices it found by
itself.

## Security and privacy

- **What it talks to.** The TV address you choose, over ADB on port 5555 of your local network. On
  Setup, it also asks your local network which Android TVs are there (mDNS) and checks whether their
  debugging ports accept a connection, without logging in. Over HTTPS, and nothing else:
  - api.github.com, at most twice a day, to see if a newer CleanMyTV is out. It downloads nothing.
  - dl.google.com for Google's platform-tools, only when you click it (Wireless debugging pairing).
  - www.bing.com, only when you choose Bing's picture of the day as the wallpaper.
  - geocoding-api.open-meteo.com, only when you search for a town for the weather.
  - github.com, once, when you press Put the fireplace on the TV. It downloads the video and sound from
    this project's `fireplace-1` release and checks them against a fixed SHA-256.

  No analytics, no accounts, no server of its own.
- **What CleanMyTV Home can access.**
  - Its settings and wallpaper live in its own private storage. The app sends them over ADB through a
    ContentProvider (`content call`) that only the shell user and root may call. This is also what
    fixed the "Permission denied" on `Android/data` (#20, #27, #28) and the reset after a reboot (#21).
  - The music bars read the TV's sound output: the app grants `RECORD_AUDIO` over ADB at install. The
    bars only move while music or video plays.
  - Now playing reads other apps' media sessions. Android only allows that for a notification listener,
    so the app switches one on over ADB while the section is on, and off without it. It reads no
    notifications.
  - Continue watching reads Android's Watch Next list, the one Google TV's launcher shows. Android only
    shows Home other apps' entries with `READ_TV_LISTINGS`, which the app grants over ADB at install. A
    Home that updated itself asks on the TV, in the editor's Layout section.
  - Remote buttons and the app lock use an accessibility service. It sees key presses and which app is
    in front, and can't read what's on screen. It is off until you turn on either, only acts on the
    buttons you map, and only covers the apps you lock.
  - The app lock's PIN is stored on the TV salted and hashed (PBKDF2), in Home's private storage. The
    app can set it but never read it back. It's a family lock: anyone with ADB access or a factory reset
    gets past it.
  - The Quick settings panel changes screensaver, sleep, Private DNS, animation and clock settings. The
    app grants `WRITE_SECURE_SETTINGS` and `WRITE_SETTINGS` over ADB at install for that. A TV that
    refuses them still works: those rows open the TV's own settings instead.
  - The fireplace video and sound sit in Home's folder on the TV's shared storage
    (`Android/data/io.github.wingedpanther.cleanmytv.home/files/fireplace`). ADB can write there, and
    Home reads them without a storage permission.
  - What it fetches from the internet: the weather, every 30 minutes while the place is set
    (api.open-meteo.com, and api.met.no when Open-Meteo doesn't answer); Bing's picture of the day
    (www.bing.com), only when you pick it or turn on Bing every day; the pictures in Continue watching, from
    wherever the app that listed them keeps them; and, once a day while "Look for
    updates" is on, the latest release from api.github.com. An update is checked against the release's
    SHA256SUMS.txt before Android's installer asks you to confirm it. Home needs "Install unknown apps"
    for that, which you allow on the TV the first time.
  - **From your phone** answers on your home network only while its QR code is on the TV, at a random
    address that stops working when you close it or after 10 minutes. It takes pictures up to 4 MB and
    nothing else.
  - The sleep timer and daily limits use the same accessibility service as remote buttons. Home counts
    an app's time from which app is in front; it keeps no other record of what you watch.
- **Your keys.** The app makes its own ADB key in its data folder and signs only with that. It never
  uses `~/.android/adbkey`, which your phones may also trust, and it only logs in to an address you
  picked. Network ADB is plaintext by design, so use it on a network you trust.
- **Pinned upstream.** The debloat lists come from one upstream commit pinned in
  [`upstream.json`](upstream.json) with a content hash. A build refuses anything that doesn't match, so
  a change upstream reaches this app only after someone reviews it and moves the pin.
- **The launcher signing key ships inside the app, on purpose.** `resources/signing/cleanmytv.jks`
  (password `cleanyourtv`) signs CleanMyTV Home, so every build installs over the others. It gives no
  access to a TV: installing anything still needs ADB access the owner allowed.
- **Close debugging when you're done.** Some TVs (`ro.adb.secure=0`) accept any device on the network
  without the Allow prompt; the app warns you if yours is one. The Finish step checks that port 5555 is
  closed. The launcher keeps working without debugging.
- **Window lockdown.** The app window is sandboxed, cannot navigate away from its own page, and only
  that page may call into the part that talks to the TV.

Found a security problem? Please report it privately through the repository's
**Security → Report a vulnerability** page rather than in a public issue.

## Credits and upstream

The per-TV cleanup lists are [cleanyourtv](https://github.com/Gathin23/cleanyourtv)'s, by
[@gathint](https://x.com/gathint), shipped unchanged. CleanMyTV is an independent project, not part of
cleanyourtv. Versions 0.1.x installed the CleanYourTV launcher (`com.gathin.tvhome`); since 0.2.0 the
launcher is CleanMyTV Home, built from `home/` in this repository, and the app can remove the old one.

The debloat side is a TypeScript port of upstream's `tools/`, and the launcher handover follows
`launcher/build-and-install.sh`:

- `src/main/adb/` is an ADB-over-TCP client, the twin of `tools/tv.py`.
- `src/main/debloat.ts` has the same guards as `disable.sh`: it won't disable the app that owns Home while nothing else can take it, and it won't disable setupwraith while it owns the Wi-Fi network. It writes the same recovery record to `~/.cleanyourtv/`, plus the TV's device name so the record follows the TV to a new address. `tests/engine.test.ts` checks that the record names and the restore batch match upstream `recovery.py` exactly, so `tools/restore.sh ~/.cleanyourtv/lists/<tv>.txt` can also undo what the app did.
- `src/main/launcher.ts` follows the handover order of `build-and-install.sh`: install, start, switch off Google's launcher, set Home, check, roll back. Vendor launchers stay on, as upstream's `STOCK_LAUNCHER=none` does: lists say to keep them. If setupwraith takes Home once the Google launcher is off, as on Google TV 14 MediaTek boards, the install switches it off too, after the same Wi-Fi check, and Undo turns it back on. The app knows the stock launchers the lists name, and remembers each TV's for Undo. It also removes the CleanYourTV launcher that 0.1.x installed.
- `src/main/home.ts` reads and writes CleanMyTV Home's settings through its ContentProvider.

Upstream's themes aren't bundled. They are for upstream's launcher.

The "From Omarchy" home screen themes use the colours of the dark themes in
[Omarchy](https://github.com/omacom/omarchy/tree/quattro/themes) by David Heinemeier Hansson (MIT). Only
the colours are used; the wallpapers are drawn by the app. Its licence ships in `resources/licenses/`.

The drawn app icons come from [Simple Icons](https://simpleicons.org) (CC0). Brand marks belong to their
owners; Home only shows them to open the app they belong to.

The undo toast, the Apply button that changes as it works, the PIN boxes, the step bar, the loading rows and
the ⌘K search follow components from [EasyUI](https://github.com/Surajmaurya1/easyui) by Suraj Maurya (MIT),
rewritten in plain CSS. Its licence ships in `resources/licenses/`.

The fireplace video and its crackle come from [Pixabay](https://pixabay.com) under the Pixabay Content
License, looped and re-encoded for the TV. They're downloaded from the `fireplace-1` release when you
put the fireplace on a TV, and aren't part of this repository.

### The launcher APK

CleanMyTV Home lives in `home/`: Kotlin and Jetpack Compose for TV, package
`io.github.wingedpanther.cleanmytv.home`. `npm run home` builds it into `resources/home.apk`, and
`resources/home.json` records its version. The script uses `JAVA_HOME` and `ANDROID_HOME` if they are
set. Otherwise it downloads JDK 17 and the Android SDK into `.cytv-build/`. Every build is signed with
`resources/signing/cleanmytv.jks`, so each one installs over the others.

## Develop

```bash
npm install
npm run sync                 # lists from the pinned upstream commit
npm run home                 # resources/home.apk (without JAVA_HOME/ANDROID_HOME, first run downloads the build tools)
npm run dev                  # the app, with hot reload
npx tsx scripts/fake-tv.ts   # a pretend TV on 127.0.0.1:5556 to try the app without one
UPSTREAM_DIR=<clone at the pinned commit> npm test
npm run dist:mac             # dist/*.dmg   (on a Mac)
npm run dist:win             # dist/*.exe   (on Windows, a Mac, or in CI)
npm run dist:linux           # dist/*.AppImage (on Linux or in CI)
```

To move to a newer upstream: review its changes, then `node scripts/pin-upstream.mjs <commit sha>`,
`npm run sync`, and test on a TV. `UPSTREAM_UNPINNED=1` lets `sync` use other content for a local
trial.

`.github/workflows/build.yml` builds the APK on Linux and runs the tests on every push and pull request.
Pushes to `main` and version tags also build the macOS, Windows and Linux installers; download them from the
run's **Artifacts**. It runs with read-only repository permissions and actions pinned to commits.

### Releasing

1. Set the new `version` in `package.json` and commit it.
2. Tag and push: `git tag v0.3.0 && git push origin main v0.3.0`.
3. The workflow builds both installers and opens a **draft** release with them attached. Check it,
   then press **Publish release**.

The tag has to match the version in `package.json`, or the release step stops.

## Help and community

- **Chat and how-to questions:** the [CleanMyTV Discord](https://discord.gg/6hZeQkDYf9). Share your
  home screen in `#show-your-setup`.
- **Bugs and feature requests:** [open a GitHub issue](https://github.com/wingedpanther/cleanmytv/issues/new)
  with your TV model, Android version and what happened. Issues are where fixes get tracked, so please
  don't report bugs only in Discord.

## Known limits

- Tested on a Xiaomi Mi Box S from Windows, and on a TV emulator from macOS.
- Macs need macOS 13 Ventura or newer. CleanMyTV Home needs Android 9 or newer; Clean up works on older TVs.
- Wireless debugging pairing uses Google's `adb`, downloaded on demand. On macOS, Local Network
  privacy can block that binary. If pairing fails there, pair from a Windows PC or run `adb pair`
  in Terminal once.

## Licence

MIT, see [LICENSE](LICENSE). The bundled debloat lists are from
[cleanyourtv](https://github.com/Gathin23/cleanyourtv) by Gathin23, also MIT; its licence ships in
`resources/upstream/LICENSE`. The Omarchy theme colours are MIT too; see `resources/licenses/omarchy-LICENSE.txt`.

