cleanyourtv-app README

项目的 README,来自 github.com/udhaykumarbala/cleanyourtv-app。合并为一个 markdown 文件:README.md。

Community app for Clean Your TV. Clean your TV from your phone. No laptop. No coding agent. Open the app on your Android phone, tap Start, and the ads and bloat are gone in about five minutes. Three steps: connect, analyse, clean.

Download the latest APK 173 TV lists from 47 brands Android 9 or newer MIT licence

A community-built phone app for Clean Your TV.
Anyone can clean up their TV: no laptop, no coding agent, no cables.

Download · Get it with Obtainium · How it works · Is it safe? · Supported TVs
Obtainium follows this app's GitHub releases and updates it by itself.

Three steps, phone and TV side by side. 1 Connect: the app finds the TV and the TV asks to allow the phone. 2 Analyse: the phone reads the TV and shows 22 things to switch off while the TV is untouched. 3 Clean: the phone shows Making it clean while the TV shows a lantern scanning the old cards and drawing them into a soft black hole, and the TV ends on its new home screen.

How it works

1. Connect 2. Analyse 3. Clean
Look at the TV: the TV asks whether to trust this phone; tick Always allow, then choose OK We found 22 things to switch off, grouped into adverts, tracking, apps nobody asked for and brand extras, with everything it keeps listed below Your TV is ready: 23 things switched off, new home screen on, everything can be put back
The app finds your TV on the Wi-Fi and shows you how to let the phone in with the remote. It reads what is on the TV and shows the plan: what goes off and what stays. Nothing changes yet. Tap "Make it clean". A restore point first, then the clutter goes and the new home screen comes on.

You need an Android phone (Android 9 or newer, with a screen lock) on the same Wi-Fi as the TV. Download the APK and open it to install. Connecting takes about a minute (you switch on network debugging with the remote; the app shows you how), and the whole clean-up about five minutes.

Come back any time to put an app back, check for leftovers after a TV update, change the dock or the look, or undo everything.

What your TV gets

Not every TV gets the new home screen yet. The app says which of these your TV gets before it changes anything, on the "What we found" screen, and why.

Which TVs What the app does
New home screen and clean-up TVs where testers confirmed the switch holds after a restart: most Xiaomi and Redmi sets on Android 9 to 11 and the Xiaomi MiTV-MZTU1 and MiTV-MOEU1 on Android 14; OnePlus on Android 11, Sony on Android 8, Hisense on Android 9, Homatics, MECOOL and the Strong LEAP-S1 on Android 14, the Toshiba Smart TV (hamamatsucho) on Android 11, the MI MiProjM05 projector on Android 9 (with Google's Android TV home); and the TCL, Sony, Hisense, Philips and other models whose list says so Switches off the clutter and puts the Clean Your TV home screen in charge, with a restore point first
Clean-up only, for now Most Google TV sets (their setup wizard holds the Wi-Fi, or the TV has no list yet), TVs the app has not met before, and Google's own Chromecast and TV Streamer (the switch would cost casting) Switches off adverts, tracking and background apps. The TV keeps its own home screen, so it looks the same; the adverts drawn by that home screen stay with it
Not possible Fire TV, TCL's China builds, Android 7 and older Clean-up only, and the app says so up front

The TV list says what each model gets today, which ones are in the test build, and which are coming soon. A TV with no list of its own moves up when its owners send its report from the app ("Help add this TV").

Two ways to clean your TV

Clean Your TV gives any Android TV a calm, ad-free home screen and switches off the bloat, using lists tested by its community. On its own it needs a computer: you run its scripts, or hand its prompt to a coding agent. This app does the whole job from your phone.

Clean Your TV repo Clean Your TV app (this repo)
You need A computer with ADB, or a coding agent such as Claude Code Just an Android phone on the same Wi-Fi as the TV
You do Run the scripts, or give the prompt to the agent Tap Start, check the plan, tap "Make it clean"
Made for Tinkerers, themes and new TV lists Everyone: you, your parents, your friends

Both give you the same Clean Your TV home screen and the same community TV lists, switch apps off without uninstalling them, and keep a way back for every change.

Safe by design

Supported TVs

173 TV lists from 47 brands, from the Clean Your TV community lists: TCL, Sony, Xiaomi, Hisense, Philips, Amazon Fire TV, Panasonic, XGIMI, BenQ, NVIDIA Shield, onn, Google and many more, on Android TV, Google TV and Fire OS. A model nobody has listed yet still gets a careful clean-up based on its brand.

The details
  • Profiles: TCL (26 lists), Sony (22), Xiaomi (29), Hisense, Philips, Amazon Fire TV, Panasonic, XGIMI, BenQ, NVIDIA Shield, Skyworth, Haier, CHiQ, onn, Google, Vestel-made sets (JVC, Toshiba, Cecotec), the Freebox Player and more, on Android TV, Google TV, Fire OS and TCL's China builds. Each profile names who tested it.
  • Brand fallback: for Amazon, Hisense, Panasonic, Philips, Sony, TCL, XGIMI and Xiaomi models without a profile, the app switches off only what every profile of that brand agrees on, and says it is being careful. More can be switched off by hand under Customise.
  • Other Android TVs get the clean-up the app is sure about, and keep their own home screen until a list for them says the switch holds (see "What your TV gets" above and the TV list).
  • Clean-up only (the TV keeps its own home screen, and the app says why): Fire TV, TCL's China builds, Android 7, vendor home screens the app does not know, Chromecast with Google TV and the Google TV Streamer (the switch would cost casting), the Kalley and PRISM+ sets whose setup wizard returns at every boot, and TVs whose setup wizard has to stay on.
  • Network debugging: the TV needs ADB over the network (port 5555). On TVs that only offer Wireless debugging with a pairing code, pair once from a computer; the app shows the three commands.

Your TV is not listed? TV lists live in Clean Your TV, so they help everyone, with or without the app. Add yours there by following its contributing guide, and the app picks it up in its next release. See also CONTRIBUTING.md.

Built on Clean Your TV

Privacy in detail
  • No accounts, no analytics, no advertising, no crash reporting service.
  • On your home network the app talks only to the TV you pick (ADB on port 5555) and listens for TVs announcing themselves (mDNS).
  • On the internet it talks only to GitHub, and only when you ask: "Check for updates" makes one request for the latest release, and an optional add-on downloads from its GitHub release. The launcher and the TV progress screen are inside the APK, so a normal setup makes no internet request at all.
  • The key the TV trusts lives in the phone's Android Keystore and never leaves the phone. Restore points stay on the phone unless you save a copy yourself.
  • "Report a problem" and "Help add this TV" show the whole report first, remove addresses, serial numbers, keys and codes, and send nothing themselves: you share it or post it on GitHub.
  • Permissions: internet, network state, Wi-Fi multicast (to find the TV), a foreground service while it works on the TV, notifications and the screen lock prompt. No location, storage, camera or contacts.
  • The full policy: PRIVACY.md, published at cleanyour.tv/app/android/privacy.
Check the download

Every release is signed by the same key, whose certificate SHA-256 is (also in docs/release-signer.sha256):

eaf7af3867bb29ff4bb038854842c93f42ffe4198a087e611cb18f925201cd65
sha256sum cleanyourtv-0.2.0.apk                 # compare with the release notes
apksigner verify --print-certs cleanyourtv-0.2.0.apk

Android refuses an update signed by any other key, so after the first install every update is checked for you. The build is reproducible: for every release tag CI builds the unsigned APK from the public source, and scripts/verify-release.sh checks that the published APK is exactly that build plus a signature.

For developers

git clone --recurse-submodules https://github.com/udhaykumarbala/cleanyourtv-app.git
cd cleanyourtv-app
./gradlew check assembleDebug        # JDK 21 and the Android SDK

A Kotlin and Jetpack Compose app that speaks ADB to the TV itself, with no computer in between. CONTRIBUTING.md covers tests, screenshot goldens, the module rules and how releases are built and signed. How the app was designed and reviewed is in docs/history, and what changed in each version in CHANGELOG.md.

The app is developed with AI coding agents under human review: the maintainer set the design and reviewed and tested the app, and every change went through automated tests and review.

Credits

Full list: THIRD-PARTY-NOTICES. Licence: MIT, like Clean Your TV.

If the app saved you an evening, you can buy me a coffee.

cleanyourtv-app (udhaykumarbala/cleanyourtv-app)

正在搜索数据库…

这是什么?Clean Your TV 是一款由社区开发的 Android 手机应用,无需电脑,也无需编程助手,就能直接用手机清理 Android TV、Google TV 或 Fire TV 设备。
这是要装在电视上还是手机上的应用?它以 APK 的形式安装在你的 Android 手机上;然后通过 ADB 经 Wi-Fi 连接电视,远程关闭无用预装软件,并在电视上安装一个干净的启动器。
我该如何让它运行起来?下载 APK 并打开安装,将手机和电视连接到同一个 Wi-Fi,然后用遥控器在电视上开启网络调试(应用会一步步引导你),接着让应用进行分析,并点击 'Make it clean'。
使用它我需要准备什么?一部运行 Android 9 或更高版本、已开启屏幕锁定的 Android 手机,并且与电视连接在同一个 Wi-Fi 网络中。
它会在每台设备上都切换电视的主屏幕吗?不会。在 Fire TV、搭载 Google TV 的 Chromecast、Google TV Streamer、TCL 的中国版机型以及 Android 7 设备上,应用只进行清理,不会更换电视自带的主屏幕,因为切换会破坏投屏功能,或者不够可靠。
它支持哪些电视品牌和平台?支持 46 个品牌的 131 款电视机型,包括 TCL、Sony、Xiaomi、Hisense、Philips、Amazon Fire TV、NVIDIA Shield 等,运行 Android TV、Google TV 或 Fire OS;未列出的机型仍会根据品牌进行谨慎的清理。
这个应用会把我的数据发送到别处吗?不会。它没有账户、数据分析、广告或崩溃报告;在你的家庭网络中,它只与你选择的电视通信;在互联网上,它只会在你明确要求检查更新时访问 GitHub。
这和原版 Clean Your TV 脚本有什么不同?原版 Clean Your TV 仓库需要一台装有 ADB 的电脑(或编程助手)来运行其脚本,而这款应用只需用手机点击即可完成全部操作:点击开始,查看方案,然后点击 'Make it clean'。
如果我不喜欢这些改动,能撤销吗?可以。你可以从还原点恢复单个应用或全部内容;'Save a copy' 选项还能导出可独立运行的还原脚本,即使不用这款应用,在任何装有 adb 的电脑上也能运行。
清理过程中如果连接断开了会怎样?如果手机在 150 秒内没有确认新的主屏幕,电视上的看门狗会自动切回其自带的主屏幕。
它如何防止我的电视出故障?在执行任何操作之前,它会先显示完整方案;它会保护核心系统应用(Wi-Fi、Play 商店、遥控器、输入源)不被改动;对于已知在更换主屏幕时容易出问题的电视,它只限于进行清理。
大小
370.8 MB
星标
2.3K
时长
28天
提交 · 90 天