CleanYourTV: Debloat für Android TV und Google TV

1. Projektübersicht

CleanYourTV ist ein Open-Source-Werkzeugsatz für Android TV und Google TV, der vorinstallierte Bloatware, Werbung und Telemetrie über WLAN entfernt und den Standard-Startbildschirm durch einen schlanken Launcher im Apple-TV-Stil ersetzt – ganz ohne Root, ohne Kabel, ohne Deinstallationen und mit einer Wiederherstellung per Einzeiler.

2. Hintergrund und Positionierung

Warum es entwickelt wurde

Viele Smart-TVs werden mit vorinstallierten Apps, Werbeinhaltsreihen, Werbediensten und Hintergrundtelemetrie ausgeliefert, die das Gerät verlangsamen und den Startbildschirm überladen. CleanYourTV bietet Besitzern eine sichere, umkehrbare Möglichkeit, die Kontrolle über ihren eigenen Fernseher zu übernehmen, indem ausschließlich Einstellungen genutzt werden, die der Besitzer ohnehin ändern darf (die integrierte ADB-Fehlersuche).

Wie es sich von ähnlichen Projekten unterscheidet

Konstruktionsbedingt umkehrbar: Apps werden mit pm disable-user deaktiviert, niemals deinstalliert, und ein aufgezeichneter Schnappschuss macht die Wiederherstellung zu einem einzigen Befehl.
Gerätebewusst: Die Debloat-Liste unterscheidet sich je nach Marke, daher prüft ein Coding-Assistent Ihren konkreten Fernseher und fragt nach, bevor etwas geändert wird.
Mitgelieferter Launcher: Debloating und ein alternativer Startbildschirm kommen in einem Projekt (etwa 497 KB, reines Java, läuft auf Fernsehern mit 1 GB RAM).
Von der Community getestete Listen: Der Ordner examples/ enthält modellbezogene Debloat-Listen, die von Nutzern beigesteuert wurden (über 170 Modelle).

3. Funktionskategorien

🧹 Debloat und Werbeentfernung

Deaktiviert Telemetrie, Werbedienste, Inhaltsreihen und vorinstallierte Apps ohne Root.

Sicherung der Liste installierter Pakete und der Einstellungen
Deaktivierung auf Basis von pm disable-user (nichts wird deinstalliert)
Sicherheitsprüfung, die das Deaktivieren der aktiven Home-App ohne Ersatz verweigert
check.py zum Erkennen von Paketen, die durch Firmware-Updates wiederhergestellt wurden (--fix wendet sie erneut an)
Wiederherstellung aus einem aufgezeichneten Zustand per Einzeiler

📺 Schlanker Launcher

Ein schneller, minimalistischer Ersatz-Startbildschirm für Android TV und Google TV.

Schwarzer Hintergrund mit Favoriten-Dock und App-Raster
Obere Leiste, die den Namen der fokussierten App anzeigt
Fokus-Hervorhebung im Glasstil und mattierte Schaltflächen (Eingänge, Netzwerk, Einstellungen)
Uhr-Bildschirmschoner mit optionalen CPU-, Speicher- und Speicherplatzstatistiken
25 Sprachen, einschließlich eines gespiegelten Rechts-nach-links-Layouts

🎨 Themes und Anpassung

Personalisieren Sie das Erscheinungsbild, ohne den Launcher neu zu erstellen.

Konfigurierbare Farben, Hintergrundbilder, Dock und Spaltenanzahl
Mitgelieferte Themes wie default, aurora und six-columns
Theme-Anwendung mit tools/theme.sh
Neubelegung der Fernbedienungstasten und App-Bibliothek (optional)

🧩 Add-ons und Modulkarten

Erweitern Sie den Launcher mit optionalen Apps.

Andere Apps können Kacheln hinzufügen, jedoch nur mit Zustimmung des Nutzers
Add-ons befinden sich im Ordner addons/
Begleitseiten auf cleanyour.tv für Apps und Add-ons

🔒 Datenschutz- und Sicherheitstools

Verstehen und reduzieren Sie, was Ihr Fernseher im Hintergrund tut.

privacy.py meldet Kandidaten für Sprache, ACR und Telemetrie mit Nachweisen
adb-closed.py bestätigt anschließend, dass der Netzwerk-ADB-Port geschlossen ist
Optionale AdGuard-DNS-Einrichtung zur werbefreien Nutzung innerhalb von Apps über privates DNS
Optionales Tailscale für die sichere Fernverwaltung

🛠️ Entwickler- und Diagnosetools

Hilfsprogramme für Betreuer und Mitwirkende.

tv.py: reiner Python-ADB-Client und Prüfroutine
bench.py, trace.py und screendiff.py für Leistungs- und visuelle Prüfungen
manage.py für die Geräteverwaltung
Eine Testsuite in tests/

4. Wichtigste Highlights

Kein Root, kein Kabel: funktioniert über WLAN mithilfe der integrierten Netzwerk-ADB-Fehlersuche des Fernsehers.
Vollständig umkehrbar: nichts wird deinstalliert, und eine schnappschussbasierte Wiederherstellung setzt den Fernseher in seinen vorherigen Zustand zurück.
KI-gestützter Arbeitsablauf: Fügen Sie PROMPT.md in einen Coding-Assistenten wie Claude Code, Codex oder Gemini CLI ein, und dieser führt Sie in etwa fünfzehn Minuten durch die gesamte Bereinigung.
Winziger Launcher: etwa 497 KB, geschrieben in reinem Java, ausgelegt für Android 8.0 (API 26) und höher.
Breite Community-Abdeckung: getestete Debloat-Listen für über 170 TV-Modelle von Marken wie TCL, Sony, Xiaomi und Philips.
Standardmäßig global: 25 Oberflächensprachen, mit README-Übersetzungen auf Japanisch, Vietnamesisch und vereinfachtem Chinesisch.

5. Anwendungsfälle nach Rolle

Allgemeine Nutzer und TV-Besitzer: erhalten Sie einen schnelleren, saubereren Startbildschirm ohne technisches Risiko.
Allgemeine Entwickler: studieren Sie einen kompakten nativen Android-TV-Launcher und einen reinen Python-ADB-Client.
DevOps / SRE: verwalten Sie Flotten von Fernsehern oder Kiosksystemen ferngesteuert mit den Skripten und Tailscale.
Sicherheitsingenieure: prüfen Sie Kandidaten für Telemetrie, Sprache und ACR mit privacy.py und stellen Sie sicher, dass ADB danach geschlossen ist.
Projektmanager / Integratoren: bereiten Sie einheitliche, werbefreie Digital-Signage- oder Hospitality-Displays mit gemeinsamen Debloat-Listen vor.

6. Erste Schritte

Finden Sie, was Sie brauchen

Durchsuchen Sie die modellbezogenen Listen in examples/ und die Anleitungen in docs/ oder besuchen Sie https://cleanyour.tv.

Installieren / Integrieren

Aktivieren Sie auf dem Fernseher die Entwickleroptionen und die USB-Fehlersuche und lassen Sie ihn im selben WLAN wie Ihren Computer.
Fügen Sie PROMPT.md in einen Coding-Assistenten ein und geben Sie Ihr TV-Modell an, oder führen Sie die manuellen Befehle aus:

git clone https://github.com/Gathin23/cleanyourtv.git
cd cleanyourtv
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50
tools/venv/bin/python -I tools/tv.py --probe
tools/disable.sh examples/<model>/debloat.txt
TV_HOST=192.168.1.50 launcher/build-and-install.sh
tools/theme.sh themes/aurora

Um alles rückgängig zu machen:

tools/restore.sh examples/<model>/debloat.txt

Eine von der Community entwickelte Android-App kann die Bereinigung auch direkt vom Smartphone aus ohne Computer durchführen.

Mitwirken

Fügen Sie eine getestete Debloat-Liste für Ihr TV-Modell in examples/ hinzu, lesen Sie dann CONTRIBUTING.md und eröffnen Sie einen Pull Request: https://github.com/Gathin23/cleanyourtv/blob/main/CONTRIBUTING.md

7. Projektstruktur

cleanyourtv/
├── addons/        # optionale Add-on-Apps, die als Modulkarten angezeigt werden
├── docs/          # Anleitungen, Spezifikationen, Fehlerbehebung, Gerätehinweise
├── examples/      # modellbezogene Debloat-Listen
├── launcher/      # Quellcode und Build-Skripte des Android-Launchers
├── themes/        # Theme-Ordner (default, aurora, six-columns, ...)
├── tools/         # Python-/Shell-Hilfsprogramme (tv.py, disable.sh, restore.sh, check.py, privacy.py)
├── tests/         # Testsuite
├── PROMPT.md      # Prompt für die Einrichtung über einen Coding-Assistenten
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE

8. Verwandtes Ökosystem

Android Debug Bridge (ADB): der Mechanismus zur Steuerung des Fernsehers.
Coding-Assistenten: Claude Code, Codex und Gemini CLI können die geführte Einrichtung steuern.
Build-Toolchain: JDK 17 und Android SDK Plattform 34 mit build-tools 34.0.0 für den Launcher.
Optionale Dienste: Tailscale (Fernverwaltung) und AdGuard DNS (Werbeblockierung).
Verwandte Plattformen: Fire TV wird nur für Debloat unterstützt; Samsung (Tizen) und LG (webOS) sind andere Systeme, die in separaten Hinweisen behandelt werden.

9. Lizenz

✅ Nutzen, kopieren, ändern und verbreiten Sie die Software, auch kommerziell, unter den Bedingungen der MIT-Lizenz (wie in der Projekt-README angegeben)
✅ Binden Sie sie in Ihre eigenen Projekte ein, wobei der Lizenzhinweis erhalten bleibt
❌ Es wird keine Gewährleistung übernommen; die Autoren haften nicht für Schäden
❌ Nicht verbunden mit oder unterstützt von einem TV-Hersteller
ℹ️ GitHub meldet die Lizenz als unbekannt (NOASSERTION); prüfen Sie die Datei LICENSE im Repository
ℹ️ Die Schriftart Outfit steht unter der SIL Open Font License

10. Häufig gestellte Fragen

F: Ist es sicher, und kann ich es rückgängig machen?
A: Apps werden nur deaktiviert, niemals deinstalliert. Führen Sie tools/restore.sh examples/<model>/debloat.txt aus, um alles zurückzusetzen.

F: Funktioniert es auf Fire TV, Samsung- oder LG-Fernsehern?
A: Fire TV unterstützt nur Debloat. Samsung (Tizen) und LG (webOS) sind andere Systeme und werden nicht direkt unterstützt.

F: Machen Firmware-Updates die Änderungen rückgängig?
A: Updates können Pakete wieder aktivieren. Führen Sie check.py aus, um zu sehen, was sich geändert hat, und fügen Sie --fix hinzu, um Ihre Liste erneut anzuwenden.

F: Kann ich das ohne Computer machen?
A: Ja, eine von der Community entwickelte Android-App führt dieselbe Bereinigung vom Smartphone aus durch.

F: Sollte ich ADB danach eingeschaltet lassen?
A: Nein. Netzwerk-ADB ist auf Port 5555 unverschlüsselt; schalten Sie es nach Abschluss aus und überprüfen Sie dies mit adb-closed.py.

11. Schnelllinks

Repository: https://github.com/Gathin23/cleanyourtv
Website: https://cleanyour.tv
Leitfaden zum Mitwirken: https://github.com/Gathin23/cleanyourtv/blob/main/CONTRIBUTING.md
Diskussionen: https://github.com/Gathin23/cleanyourtv/discussions
Sicherheitsrichtlinie: https://github.com/Gathin23/cleanyourtv/security

12. Zusammenfassung

CleanYourTV bietet TV-Besitzern eine sichere, umkehrbare Möglichkeit, Bloatware, Werbung und Telemetrie zu entfernen und einen schnellen, sauberen Launcher zu installieren – alles über WLAN und ohne Root. Es eignet sich für jeden mit einem Android TV oder Google TV, der einen schnelleren, ruhigeren Startbildschirm möchte, sowie für Entwickler und Sicherheitsingenieure, die eine kompakte, gut dokumentierte Codebasis zum Lernen oder Erweitern suchen.