mirror of
https://github.com/Gathin23/cleanyourtv.git
synced 2026-10-26 19:47:52 +00:00
Non-Android TVs: README, prompt, agent guide, issue page and tv.py point Samsung, LG and Roku owners to cleanyour.tv/not-android
This commit is contained in:
Gathin23 committed
1 parent
f592b6d2db
commit
b06ab21105
11 files changed
+39
-7
No files matched your search
@@ -1,5 +1,8 @@
|
||||
blank_issues_enabled: true
|
||||
contact_links:
|
||||
- name: Samsung, LG, Roku or another non-Android TV?
|
||||
url: https://cleanyour.tv/not-android
|
||||
about: CleanYourTV can't run there. This guide turns off the tracking, step by step with your remote.
|
||||
- name: Question or "does it work on my TV?"
|
||||
url: https://github.com/Gathin23/cleanyourtv/discussions/categories/q-a
|
||||
about: Ask in Discussions. Issues are for bugs and TV lists.
|
||||
|
||||
@@ -52,6 +52,9 @@ this file repeats their rules in the form an agent needs, and links to them for
|
||||
- **Stop and say so** when the TV refuses: `pm disable-user` refused for every package, a sideload that
|
||||
fails verification, or an SDK below the launcher's `minSdk` 26. Do not retry in a loop, and do not lower
|
||||
`minSdk` or hand over an APK built elsewhere.
|
||||
- **Not an Android TV?** No ADB port at all, or the set identifies as Tizen, webOS, Roku OS, VIDAA or
|
||||
SmartCast: stop, nothing here applies. Send the person to https://cleanyour.tv/not-android, which turns
|
||||
off the tracking with the remote.
|
||||
|
||||
The person's backups (`backup/`), screenshots (`shots/`), notes (`work/`) and the ADB key
|
||||
(`tools/adbkey/`) are listed in `.gitignore` and must never be committed. If the person wants to
|
||||
|
||||
@@ -3,7 +3,8 @@
|
||||
Paste this into Claude Code (or another coding assistant with shell access) on a computer that is
|
||||
on the same Wi-Fi as the TV. Works on Android TV / Google TV sets (Xiaomi, TCL, Hisense, Sony,
|
||||
OnePlus, Realme, Nvidia Shield and most others). It will not work on Samsung Tizen, LG webOS or
|
||||
Fire TV. If you cloned this repo, mention that: the assistant can reuse `tools/` and `launcher/`
|
||||
Fire TV. For Samsung, LG, Roku and other non-Android TVs, use https://cleanyour.tv/not-android instead:
|
||||
it turns off the tracking with the remote. If you cloned this repo, mention that: the assistant can reuse `tools/` and `launcher/`
|
||||
instead of writing them from scratch, and only needs to edit `launcher/.../values/config.xml`.
|
||||
|
||||
Before you start, on the TV: Settings → Device Preferences → About → press OK on "Build" 7 times,
|
||||
@@ -39,6 +40,9 @@ Connect
|
||||
and `adb tcpip 5555`. Android switches Wireless debugging off whenever Wi-Fi drops.
|
||||
Some firmware runs network ADB on another fixed port instead (a projector used 5877): if 5555 refuses and
|
||||
nothing advertises Wireless debugging, scan the TV's own TCP ports and try each open one with `TV_PORT`.
|
||||
- If the TV turns out not to be Android TV / Google TV (no ADB port at all, or it identifies as Tizen,
|
||||
webOS, Roku OS, VIDAA or SmartCast), stop and tell me to use https://cleanyour.tv/not-android, which
|
||||
turns off the tracking with the remote. Nothing in this repo applies to it.
|
||||
- Tell me when the "Allow USB debugging?" prompt will appear on the TV so I can accept it.
|
||||
- If `adb install` hangs on Android 14 it is waiting for an on-screen confirmation; push the APK and run
|
||||
`pm install -r` over the shell instead.
|
||||
|
||||
+5
-1
@@ -25,6 +25,9 @@ Questa pagina presenta le funzioni principali e l'uso. Ogni modello, area geogra
|
||||
elenco di app e dei limiti propri, quindi controlla prima quello della tua TV. Quando c'è una differenza, fa fede il
|
||||
[README in inglese](README.md); le note sui singoli modelli stanno nell'[elenco delle TV](examples/README.md).
|
||||
|
||||
**Samsung, LG, Roku o un'altra TV non Android?** CleanYourTV lì non funziona, ma puoi comunque disattivare il
|
||||
tracciamento, passo per passo con il telecomando: [cleanyour.tv/not-android](https://cleanyour.tv/not-android)
|
||||
|
||||
|
||||
|
||||
## Come funziona
|
||||
@@ -123,7 +126,8 @@ corrispondente prima di usare un elenco.
|
||||
- Samsung Tizen e LG webOS non eseguono il launcher Android del progetto;
|
||||
[docs/devices/samsung-tizen.md](docs/devices/samsung-tizen.md) descrive cosa espone sulla rete locale una TV Tizen
|
||||
del 2021 (niente ADB, quindi niente app da disattivare). I port della community su altre piattaforme sono nei
|
||||
[Progetti della community](SHOWCASE.md).
|
||||
[Progetti della community](SHOWCASE.md). Per disattivare il tracciamento su Samsung, LG, Roku e altre TV non Android:
|
||||
[cleanyour.tv/not-android](https://cleanyour.tv/not-android).
|
||||
- Per Fire TV ci sono note di pulizia da seguire a mano; il [prompt per l'assistente](PROMPT.md) non si usa su Fire TV
|
||||
e Fire OS non permette di cambiare la Home predefinita.
|
||||
- Alcune TV vendute nella Cina continentale rifiutano APK esterni o launcher di terzi. Non dedurre la compatibilità
|
||||
|
||||
+5
-1
@@ -24,6 +24,9 @@
|
||||
まずお使いのテレビと照らし合わせてください。変更があった場合は[英語版 README](README.md) が正となります。
|
||||
機種ごとの記録は[機種リスト](examples/README.md)にあります。
|
||||
|
||||
**Samsung、LG、Roku など Android 以外のテレビをお使いですか？** CleanYourTV は動きませんが、リモコンで
|
||||
順番に操作してトラッキングをオフにできます: [cleanyour.tv/not-android](https://cleanyour.tv/not-android)
|
||||
|
||||
|
||||
|
||||
## 仕組み
|
||||
@@ -118,7 +121,8 @@ Android アプリは、マウスやタッチ操作が必要な場合がありま
|
||||
- Samsung Tizen と LG webOS では、このプロジェクトの Android ランチャーは動きません。
|
||||
[docs/devices/samsung-tizen.md](docs/devices/samsung-tizen.md) には、2021 年製の Tizen テレビがローカルネットワークで
|
||||
何を公開しているかを記録しています（ADB がないため、アプリの無効化はできません）。コミュニティによる他プラットフォームへの
|
||||
移植は[コミュニティのプロジェクト](SHOWCASE.md)にあります。
|
||||
移植は[コミュニティのプロジェクト](SHOWCASE.md)にあります。Samsung、LG、Roku など Android 以外のテレビで
|
||||
トラッキングをオフにする手順は [cleanyour.tv/not-android](https://cleanyour.tv/not-android) にあります。
|
||||
- Fire TV には手作業で進めるための無効化メモがあります。[アシスタント用プロンプト](PROMPT.md)は Fire TV には使えず、
|
||||
Fire OS ではデフォルトのホーム画面を変更できません。
|
||||
- 中国本土で販売されている一部のテレビは、外部 APK やサードパーティのランチャーのインストールを拒否します。
|
||||
|
||||
@@ -23,6 +23,9 @@
|
||||
<a href="docs/PRESS.md"><img src="docs/card.jpg" alt="316 TV models · 89 brands · 28 languages · 523 KB launcher. Featured in TechCrunch, TechRadar, Tom's Guide, Mashable, Android Authority, XDA, FlatpanelsHD, It's FOSS, Phandroid, GIGAZINE, Xataka, WinFuture, Frandroid, Macitynet, Techaeris, TechPP and 181 more: 197 articles from 32 countries. Before: stock Google TV home with a sponsored ad. After: the Clean Your TV launcher." width="800"></a>
|
||||
</p>
|
||||
|
||||
**Samsung, LG, Roku or another non-Android TV?** CleanYourTV can't run there, but you can still turn off
|
||||
the tracking, step by step with your remote: [cleanyour.tv/not-android](https://cleanyour.tv/not-android)
|
||||
|
||||
**The viral tweet:** [x.com/gathint/status/2111379569030939102](https://x.com/gathint/status/2111379569030939102)
|
||||
|
||||
On 17 October 2026 I posted a before and after of my parents' TV, cleaned up by Claude Code over Wi-Fi.
|
||||
@@ -112,7 +115,7 @@ Anything running **Android TV** or **Google TV**.
|
||||
| **Android TV, Google TV** | The debloat and the launcher. |
|
||||
| **Fire TV** | The debloat half only, since Fire OS will not hand Home to a third-party launcher. And on the 2015 Fire TV Box (Fire OS 5) even that half fails: every `pm` route is refused. |
|
||||
| **A few China-market TCL sets** | They refuse to install any launcher at all; their lists say so in the header. |
|
||||
| **Samsung (Tizen), LG (webOS)** | Different systems. See [SHOWCASE.md](SHOWCASE.md#other-platforms-fire-tv-and-lg-webos) for three webOS ports, and [docs/devices/samsung-tizen.md](docs/devices/samsung-tizen.md) for what a 2021 Samsung set answers over Wi-Fi (no ADB, so no `pm disable-user`) if you are weighing a Tizen port. |
|
||||
| **Samsung (Tizen), LG (webOS), Roku, Vizio, Hisense VIDAA** | Not supported (no ADB). Turn off the tracking instead: [cleanyour.tv/not-android](https://cleanyour.tv/not-android). See [SHOWCASE.md](SHOWCASE.md#other-platforms-fire-tv-and-lg-webos) for three webOS ports, and [docs/devices/samsung-tizen.md](docs/devices/samsung-tizen.md) for what a 2021 Samsung set answers over Wi-Fi (no ADB, so no `pm disable-user`) if you are weighing a Tizen port. |
|
||||
|
||||
Tested lists from contributors, one folder per model in [`examples/`](examples/):
|
||||
|
||||
|
||||
+5
-1
@@ -24,6 +24,9 @@ Tài liệu này giới thiệu các tính năng chung và cách dùng. Mỗi d
|
||||
ứng dụng và giới hạn riêng, nên hãy đối chiếu với TV của bạn trước. Khi có thay đổi, [README tiếng Anh](README.md)
|
||||
là bản chuẩn; ghi chú cho từng dòng TV nằm trong [danh sách TV](examples/README.md).
|
||||
|
||||
**TV Samsung, LG, Roku hoặc TV không chạy Android khác?** CleanYourTV không chạy được trên đó, nhưng bạn vẫn có thể
|
||||
tắt tính năng theo dõi, từng bước bằng điều khiển: [cleanyour.tv/not-android](https://cleanyour.tv/not-android)
|
||||
|
||||
|
||||
|
||||
## Cách hoạt động
|
||||
@@ -118,7 +121,8 @@ sách dọn dẹp chưa chắc đã cài được launcher. Hãy đối chiếu
|
||||
- Samsung Tizen và LG webOS không chạy được launcher Android của dự án;
|
||||
[docs/devices/samsung-tizen.md](docs/devices/samsung-tizen.md) ghi lại những gì một TV Tizen đời 2021 mở ra trong
|
||||
mạng nội bộ (không có ADB, nên không tắt được ứng dụng). Các bản chuyển sang nền tảng khác của cộng đồng nằm trong
|
||||
[Dự án cộng đồng](SHOWCASE.md).
|
||||
[Dự án cộng đồng](SHOWCASE.md). Để tắt tính năng theo dõi trên Samsung, LG, Roku và các TV không chạy Android khác:
|
||||
[cleanyour.tv/not-android](https://cleanyour.tv/not-android).
|
||||
- Fire TV có các ghi chú dọn dẹp để tự làm theo; [câu lệnh cho trợ lý](PROMPT.md) không dùng cho Fire TV, và Fire OS
|
||||
không cho thay màn hình chính mặc định.
|
||||
- Một số TV bán tại Trung Quốc đại lục từ chối cài APK ngoài hoặc launcher bên thứ ba. Đừng đoán khả năng tương thích
|
||||
|
||||
+3
-1
@@ -19,6 +19,8 @@
|
||||
|
||||
本文介绍通用功能和使用方法。不同机型、地区和固件的应用包及限制可能不同，请先核对自己的设备。功能变化以[英文 README](README.md)为准，具体机型记录见[机型清单](examples/README.md)。
|
||||
|
||||
**Samsung、LG、Roku 或其他非 Android 电视？** CleanYourTV 无法在这些电视上运行，但你仍可以用遥控器一步步关闭跟踪功能：[cleanyour.tv/not-android](https://cleanyour.tv/not-android)
|
||||
|
||||
|
||||
|
||||
## 工作原理
|
||||
@@ -95,7 +97,7 @@
|
||||
|
||||
清理清单面向 **Android TV / Google TV**；当前桌面 APK 要求 **Android 8.0（API 26）或更高版本**。社区提供了多种电视与电视盒子的配置；其中一些设备运行的 Android 版本低于桌面的最低要求，清理清单不代表桌面可安装。请在[机型清单](examples/README.md)中核对型号、地区和固件，阅读对应目录的说明，再使用停用列表。
|
||||
|
||||
- Samsung Tizen 和 LG webOS 不能直接运行本项目的 Android 桌面；[docs/devices/samsung-tizen.md](docs/devices/samsung-tizen.md) 记录了一台 2021 年 Tizen 机型在局域网里暴露的接口（没有 ADB，因而无法停用应用），社区移植项目可参考[社区作品](SHOWCASE.md)。
|
||||
- Samsung Tizen 和 LG webOS 不能直接运行本项目的 Android 桌面；[docs/devices/samsung-tizen.md](docs/devices/samsung-tizen.md) 记录了一台 2021 年 Tizen 机型在局域网里暴露的接口（没有 ADB，因而无法停用应用），社区移植项目可参考[社区作品](SHOWCASE.md)。如需在 Samsung、LG、Roku 等非 Android 电视上关闭跟踪功能，请看 [cleanyour.tv/not-android](https://cleanyour.tv/not-android)。
|
||||
- Fire TV 的清理记录可供手动适配；[操作提示词](PROMPT.md)不适用于 Fire TV，Fire OS 也限制替换默认桌面。
|
||||
- 部分中国大陆版电视会拒绝侧载 APK 或安装第三方 HOME 桌面，已记录的 TCL 机型只是其中的例子。不能仅凭品牌判断兼容性。
|
||||
- 没有现成清单时，可以让助手检查实际设备，并按[贡献指南](CONTRIBUTING.md)提交经过验证的机型记录。
|
||||
|
||||
@@ -164,6 +164,8 @@ Ways to run the cleanup or control the TV from a phone or a computer, without an
|
||||
|
||||
Fire OS won't let another launcher replace Amazon's home, and LG TVs run webOS rather than Android, so these take their own routes.
|
||||
|
||||
Only want the tracking off on a Samsung, LG, Roku or other non-Android TV? [cleanyour.tv/not-android](https://cleanyour.tv/not-android) does it step by step with the remote, no root.
|
||||
|
||||
| Project | What it is | Built on | By |
|
||||
|---|---|---|---|
|
||||
| [CleanYourTV AFTSS minimal fork](https://github.com/bearylabs/cleanyourtv/tree/firetv) ([build and test notes](https://github.com/bearylabs/cleanyourtv/blob/firetv/FIRETV.md), [screenshot](https://github.com/bearylabs/cleanyourtv/releases/download/firetv-device-check-images-2026-10-25/rc1-home.jpg)) | No-root fork with a Home redirect in its accessibility service and a fail-open cover; Amazon Home stays enabled, no new network permission | Fire TV Stick Lite 2020 (AFTSS / sheldon), Fire OS 7.7.1.7 / Android 9 | [bearylabs](https://github.com/bearylabs) |
|
||||
|
||||
@@ -5,6 +5,8 @@
|
||||
> the Home button still opened Samsung Home and a long-press restart returned to HDMI.
|
||||
> Standby resume worked in one sequence; it is not a system launcher replacement.
|
||||
> No safe system-app removal or full restorable backup was established.
|
||||
> To turn off the tracking on a Samsung (or LG, Roku) TV with the remote instead, see
|
||||
> [cleanyour.tv/not-android](https://cleanyour.tv/not-android).
|
||||
|
||||
One owner's reconnaissance from a Mac on the same network, not a port and not a tested list. It was
|
||||
reported in [#441](https://github.com/Gathin23/cleanyourtv/issues/441) on 2026-10-20 by
|
||||
|
||||
+2
-1
@@ -195,7 +195,8 @@ def connect_error(e):
|
||||
if isinstance(e, ConnectionRefusedError):
|
||||
return (f"{target} refused the connection: nothing listens for ADB there, so network ADB is off "
|
||||
f"or on another port.\nIf the TV has Wireless debugging, {pair}. {reboot} A firmware that "
|
||||
f"runs adbd on a port of its own takes TV_HOST=<tv ip>:<port>. {see}")
|
||||
f"runs adbd on a port of its own takes TV_HOST=<tv ip>:<port>.\nNot an Android TV (Samsung, LG, "
|
||||
f"Roku)? There's no ADB to connect to; see https://cleanyour.tv/not-android. {see}")
|
||||
if isinstance(e, (TcpTimeoutException, AdbTimeoutError)):
|
||||
return (f"{target} took the connection, but ADB did not finish the handshake "
|
||||
f"({type(e).__name__}: {e}).\nIf the TV shows \"Allow USB debugging?\", accept it and run "
|
||||
|
||||
Reference in new issue
Block a user