Guide de configuration de CleanYourTV

Un point de départ pour un écran d'accueil Android TV ou Google TV plus calme.

CleanYourTV est un projet open source de Gathin23. Ce site est un guide indépendant et gratuit de son fonctionnement. Le paquet de code source contient le README du projet, le prompt, des exemples d'appareils, des thèmes, des notes de dépannage et des notes de sécurité.

Commencez par votre téléviseur exact

Vérifiez le modèle, la région et le firmware dans les rapports d'appareils du dossier examples/ du paquet de code source extrait. Android TV et Google TV sont les points de départ pris en charge. Le prompt d'installation ne prend pas en charge Fire TV, Samsung Tizen ni LG webOS.

Préparez le téléviseur

Gardez le téléviseur et l'ordinateur sur le même réseau local. Ouvrez Paramètres, puis À propos, et appuyez sept fois sur l'entrée Build pour déverrouiller les Options pour les développeurs. Activez le débogage USB et le débogage réseau/ADB s'ils sont disponibles. N'acceptez une demande de débogage que depuis votre propre ordinateur de confiance.

Trouvez l'adresse IPv4 du téléviseur dans ses paramètres Réseau ou Wi-Fi et transmettez-la à l'assistant. Le formulaire de configuration de ce site peut inclure cette adresse dans votre prompt de démarrage ; il n'analyse pas votre réseau et ne s'y connecte pas.

Certains appareils Google TV utilisent le débogage sans fil avec un code d'association et un port de connexion distinct. Si la connexion normale ne fonctionne pas, suivez la branche d'association du prompt d'installation au lieu de supposer que le port 5555 est toujours ouvert. Le guide de dépannage de la connexion explique les vérifications à effectuer.

Suivez le flux de travail actuel du projet

Ouvrez le prompt d'installation, copiez tout son texte dans un assistant de programmation ayant accès au terminal et donnez-lui votre modèle exact. Demandez-lui d'avancer par points de contrôle. Le projet est gratuit ; certains assistants de programmation facturent leur utilisation séparément.

Avant toute modification, enregistrez les listes de paquets, les états des paquets désactivés, les paramètres et les informations de l'appareil. Confirmez les applications de streaming, l'assistant vocal, les services de diffusion et les mises à jour que vous souhaitez conserver. Ne désactivez pas les paquets inconnus ni les éléments essentiels d'entrée, de télécommande, d'audio, de clavier ou les services Play.

Le launcher est construit à partir du code source. Téléchargez le ZIP complet du code source et extrayez-le. Conservez tout le dossier du projet : les scripts de compilation ont aussi besoin de fichiers de tools/ et launcher/.

Préparez Python 3, JDK 17, Android SDK Platform 34 et Android Build Tools 34.0.0. Le README.md extrait contient les détails de la configuration manuelle. Téléchargez le script de compilation Windows ou le script de compilation macOS/Linux, placez-le dans le répertoire launcher/ extrait et exécutez-le depuis ce répertoire ; ce sont des scripts de compilation du code source, pas des téléchargements d'APK prêts à l'emploi.

Avant que le nouveau launcher ne devienne Home, laissez l'ancien launcher activé jusqu'à ce que le remplacement s'ouvre correctement. Vérifiez le bouton Home sur le téléviseur au lieu de vous fier uniquement au message de réussite d'une commande.

Certains firmwares bloquent les applications installées par sideload ou les launchers Home tiers. Si l'appareil refuse l'installation à cause d'une restriction de vérification ou de signature du fabricant, arrêtez l'installation du launcher et consultez les notes du modèle exact. Des tentatives d'installation répétées ne prouvent pas la compatibilité.

Vérifiez et terminez

Vérifiez Home, les boutons de raccourci et de paramètres de la télécommande, les entrées HDMI, le son et la diffusion. Désactivez le débogage, révoquez les autorisations, redémarrez et utilisez l'outil téléchargeable de vérification ADB fermé pour confirmer que le port ADB refuse les connexions. Un délai d'attente ou une erreur de routage ne constitue pas un refus confirmé.

Personnalisez le launcher

Une fois la configuration de base fonctionnelle, utilisez les paramètres du launcher pour organiser les rangées d'applications et décider si vous souhaitez conserver les animations. Le themes/README.md extrait explique comment modifier l'arrière-plan, les couleurs et le dock. Consultez les instructions du thème avant de l'appliquer et vérifiez à nouveau la télécommande et le bouton Home ensuite.

Restaurez ou résolvez un problème

Conservez sur votre ordinateur les listes de paquets d'origine et les enregistrements d'état. Téléchargez le script de restauration Windows ou le script de restauration macOS/Linux, placez-le dans le répertoire tools/ extrait et utilisez-le avec la liste exacte que vous avez appliquée. Ces scripts restaurent les états enregistrés ; ce ne sont pas des images système complètes. Pour les problèmes spécifiques au modèle et les conseils de sécurité, lisez docs/TROUBLESHOOTING.md et SECURITY.md dans le paquet de code source extrait.

Lire le parcours de restauration · Trouver une étape de dépannage

Retourner au guide de configuration interactif