cleanmytv README

项目的 README,来自 github.com/wingedpanther/cleanmytv。合并为一个 markdown 文件: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 by @gathint. Thanks, Gathin.

New to this? The user guide walks every step at TV-owner pace, including rollback and troubleshooting, and the known-devices table shows what the bundled lists cover per model. This README is the technical overview.

Questions, help and home-screen setups: join the CleanMyTV Discord. Bugs and feature requests go to GitHub issues.

New in 0.12.0

New in 0.11.0

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.

New in 0.9.0

New in 0.8.0

New in 0.7.2

New in 0.7.1

New in 0.7.0

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

Download and install

Get the latest version from 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:

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 Clean up: the list that matches the TV, with each package's state

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 Split: the clock and quick settings on the left, apps on the right
Shelf, the default Split
Rail: icons down the left edge that open with labels A folder open over the home screen
Rail, opened A folder

The Home screen step in the app, with a live preview of the TV

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, 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: 28 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. 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.

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

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's, by @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:

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 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 (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 by Suraj Maurya (MIT), rewritten in plain CSS. Its licence ships in resources/licenses/.

The fireplace video and its crackle come from Pixabay 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

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

Known limits

Licence

MIT, see LICENSE. The bundled debloat lists are from 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.

cleanmytv (wingedpanther/cleanmytv)

正在搜索数据库…

这是什么?一款免费的 Mac 和 Windows 应用,可以通过 Wi-Fi 清理你的 Android 电视。它会关闭电视上预装的无用应用,并安装 CleanMyTV Home,这是一个无广告的主屏幕,在电脑上设置即可。
它是启动器还是清理工具?两者都是。它会停用电视上预装的软件包,并用自带的启动器 CleanMyTV Home 替换主屏幕。它不会卸载任何东西,“恢复”步骤可以把所有软件包都恢复原样。
怎么让它运行起来?从 Releases 页面下载安装程序。在电视上打开“关于”,连续点击“版本号”七次以启用开发者模式,然后打开 USB 调试。让电视和电脑连接同一个 Wi-Fi,打开 CleanMyTV,选择你的电视,并在电视上点击“允许”。然后运行“清理并启动”。
我需要先安装 Python、Java 或 Android Studio 吗?不需要。电脑上不需要安装 Python、Java、Android Studio 或 adb。电视端唯一的要求是开启开发者模式并启用 USB 调试。
需要注意什么?安装程序未经签名,因此 macOS 和 Windows 首次运行时会发出警告,需要你手动确认允许。在 Mac 上,你必须允许本地网络访问,否则应用无法连接到电视。
支持哪些电脑和电视?搭载 Apple 芯片或 Intel 处理器的 Mac 需要 macOS 13 Ventura 或更高版本,同时也支持 Windows 10 和 11。CleanMyTV Home 要求电视系统为 Android 9(API 28)或更高版本。
它会向我的网络以外发送任何数据吗?只会通过本地网络上的 ADB(端口 5555)与你的电视通信。除此之外,它最多每天两次访问 api.github.com 检查新版本(不会下载任何内容);只有在你点击“无线调试配对”时才会访问 dl.google.com;只有在你选择必应每日图片时才会访问 www.bing.com。
CleanMyTV Home 会对电视做哪些改动?它会用一个无广告的启动器替换原厂主屏幕,该启动器提供三种布局(Shelf、Split、Rail)。你可以在电脑上设置应用、行、文件夹、壁纸、主题、音乐栏和遥控器按键,每次修改点击后,电视上都会实时显示变化。
能撤销所有操作吗?可以。“恢复”会把所有被停用的软件包恢复到首次清理前的状态。如果重启后 CleanMyTV Home 没有恢复出来,应用会自动把原厂启动器放回去。
它适用于所有 Android 电视吗?清理列表涵盖 100 个品牌的 371 款电视。对于不在列表中的电视,它会先使用同品牌的列表,并推荐其他电视已停用的软件包;已知设备表会按机型显示覆盖范围。
壁炉功能是什么?这是一段约 11 MB 的循环柴火壁炉视频,应用只下载一次,然后发送到电视上。你可以全屏显示、设为屏保,或置于主屏幕背后,还可以设置 30 分钟、1 或 2 小时后自动关闭。
大小
3.9 MB
星标
651
时长
29天
提交 · 90 天