L'extension YouTube est livrée avec Recalbox : vous la trouvez directement dans Extensions de Kodi. Elle fonctionne sans configuration pour la recherche, mais pour accéder à votre compte (abonnements, playlists, historique, lecture sans publicité), YouTube exige que l'extension utilise vos propres clés d'API. C'est gratuit, mais cela demande une dizaine de minutes sur la console Google Cloud.
Prérequis : un compte Google/YouTube, un ordinateur avec un navigateur, et une Recalbox connectée au réseau.
La console Google Cloud évolue régulièrement : les libellés exacts peuvent différer de ceux indiqués ici. Les trois éléments à obtenir restent les mêmes : une clé d'API, un ID client OAuth et un code secret client.
Nouveau projet. Donnez-lui le nom que vous voulez, puis Créer.API et services > Bibliothèque.YouTube Data API v3, ouvrez la fiche et cliquez sur Activer.API et services > Identifiants.Créer des identifiants > Clé API.API et services, ouvrez Écran de consentement OAuth (selon la version de la console, cette section peut s'appeler Google Auth Platform).Externe, puis Créer.Enregistrer et continuer. Les deux adresses peuvent être différentes.Add users / Ajouter des utilisateurs) avec l'adresse e-mail de votre compte YouTube.Publier l'application : sans cela, l'accès expire au bout de quelques jours.API et services > Identifiants.Créer des identifiants > ID client OAuth.Téléviseurs et périphériques d'entrée limitée (c'est ce type, et lui seul, qui permet l'identification par code affiché à l'écran). Puis Créer.Vous disposez maintenant des trois valeurs nécessaires.
Les écrans peuvent différer légèrement si vous démarrez Kodi ou l'extension YouTube pour la première fois.
Extensions > YouTube.Paramètres.API dans la colonne de gauche, puis renseignez au centre :
Clé de l'API : la clé d'API de l'étape 2 ;ID de l'API : l'ID client de l'étape 4, sans le suffixe .apps.googleusercontent.com ;API secret : le code secret du client de l'étape 4.OK.Oui, choisissez votre langue et votre région, puis indiquez si vous souhaitez utiliser la géolocalisation.Suggestions de vidéos : si une liste de vidéos s'affiche, les clés fonctionnent.📷 Capture à venir :
kodi-youtube-api.png
La saisie de trois longues chaînes de caractères à la manette est fastidieuse : branchez un clavier USB, ou pilotez Kodi depuis l'application Kore ou Yatse — voir Kodi Media Center.
Connexion. Kodi vous indique qu'il faut vous identifier deux fois.Un avertissement indiquant que l'application n'est pas vérifiée peut s'afficher : c'est normal, l'application c'est vous. Continuez pour terminer l'identification.
Une fois les deux validations effectuées, vous êtes connecté : vos abonnements, playlists et vidéos recommandées apparaissent, et la lecture se fait sans publicité.
Au lancement d'une vidéo, j'obtiens le message d'erreur « UNKNOWN ». Il s'agit presque toujours d'un problème de flux protégé : dans les options de l'extension YouTube, vérifiez que InputStream Adaptive est bien activé.
J'ai dépassé le quota de l'API. Chaque clé d'API dispose d'un quota journalier gratuit. En usage domestique il est très rarement atteint, mais si c'est le cas, il se réinitialise chaque jour.
Faut-il refaire la manipulation sur chaque Recalbox ? Les clés sont liées à votre projet Google, pas à la machine : vous pouvez réutiliser les mêmes valeurs sur plusieurs Recalbox.
Besoin d'aide ? Rejoignez le Discord Recalbox.