In questa pagina gli appunti per installare l'add-on YouTube su Kodi 17.6. In effetti si tratta di installare due differenti add-on:

• GitHub plugin.video.youtube - Repository per il download delle versioni beta e per la gestione dei bug.
• Addon repository plugin.video.youtube per Kodi 19 Matrix - Mirror degli add-on pacchettizzati per le varie versioni di Kodi.
• plugin.video.youtube - Pagina Wiki del progetto Kodi.

Si tratta di un client della API YouTube che, previa registrazione di un account Google Youtube, interagisce con i servizi dello stesso consentendo di fare ricerche tra i canali, assistere a live, ecc.

Ne tempo ho provato diverse versioni dell'add-on, a partire da Kodi 17.6, quindi l'add-on 6.8.9 su Kodi 18 Leia e infine le versioni 6.8.27, 7.0.5 e poi 7.2.0 beta.4 su Kodi 19 Matrix. In generale è stato necessario fare l'aggiornamento dell'add-on tutte le volte che Google ha modificato in qualche modo le API rendendo il vecchio add-on non più funzionante.

Per effettuare un'installazione controllata e replicabile si preferisce scaricare l'archivio zip dal repository kodi.tv e salvarlo sul filesystem locale di Kodi. Dalla pagina principale Add-ons ⇒ Search ⇒ Cancel ⇒ Install from zip file. Eventuali add-on richiesti verranno comunque scaricati automaticamente da internet e salvati in $HOME/.kodi/addons/packages/, dove sarà possibile copiare lo zip per motivi di backup.

Per attivare tutte le funzionalità dell'Add-on è necessario registrarsi presso Google e ottenere le seguenti componenti:

• API key - Si tratta di un identificatore unico necessario per autenticare le richieste del nostro progetto rispetto alle API di Google. Viene utilizzato al fine di controllare i limiti di utilizzo ed eventualmente la contabilità del servizio, quindi in generale è sufficiente avere una sola API key anche se abbiamo diversi dispositivi che la usano. Abbiamo impostato come limitazioni della chiave Nessuna.
• Client ID - Rappresenta un browser o un device che si interfaccia con le API di Google. Nel nostro caso è l'add-on YouTube su Kodi. Se si installano diverse istanze dall'add-on (ad esempio su diversi apparati Kodi), si dovrebbero usare Client ID diversi. Si deve attivare un ID di tipo Applicazione Desktop.
• Client secret - Passowrd segreta associata al Client ID.

La procedura si avvia dalla pagina web https://console.developers.google.com/, nella scheda Credenziali. Cliccando il link Crea Credenziali si inizia creando una Chiave API con nessuna restrizione; eventualmente è possibile limitare la chiave ad utilizzare solo le YouTube Data API. Quindi si crea una ID client OAuth 2.0 di tipo Applicazione Desktop.

Quando avremo utilizzato l'add-on, nella Dashboard risulteranno le richieste YouTube Data API v3.

Sarebbe possibile digitare le tre stringhe (API key, Client ID e Client secret) nell'interfaccia di configurazione del plugin Kodi, ma è di gran lunga preferibile fare un copia e incolla direttamente nel file di configurazione. Per fare questo è sufficiente dal Kodi Main menu ⇒ Add-ons ⇒ YouTube aprire il Context menu ⇒ Settings e quindi la scheda API. Si imposta un valore vuoto per i tre parametri:

• API Key
• API Id - Chiamata da Google Client ID.
• API Secret - Chiamata da Google Client secret..

Quindi si ferma il servizio Kodi in modo che i file di configurazione vengano salvati correttamente; a questo punto si può editare il file:

• $HOME/.kodi/userdata/addon_data/plugin.video.youtube/api_keys.json

per immettere le tre stringhe. ATTENZIONE: nell'ID Client va omessa la parte apps.googleusercontent.com, qualcosa del genere:

{
    "keys": {
        "developer": {},
        "personal": {
            "api_key": "TYsasyEOdtgScHJUKCwqedtQOpGKsGoIhgve78k",
            "client_id": "4539196390100-4fkdvc6dks4osha234skdiepsakx7ska",
            "client_secret": "230f912cbea6f2a13355373b"
        }
    }
}

Gli stessi parametri dovrebbero essere salvati anche nel file $HOME/.kodi/userdata/addon_data/plugin.video.youtube/settings.xml:

    <setting id="youtube.api.key">TYsasyEOdtgScHJUKCwqedtQOpGKsGoIhgve78k</setting>
    <setting id="youtube.api.id">4539196390100-4fkdvc6dks4osha234skdiepsakx7ska</setting>
    <setting id="youtube.api.secret">230f912cbea6f2a13355373b</setting>

Se non è possibile collegarsi via terminale SSH all'host Kodi (ad esempio se gira su sistema operativo Android e non è stato installato un server ssh) è possibile inserire le chiavi da pagina web. È necessario apire la pagina Settings dell'add-on; nella sezione API abilitare la voce Enable API configuration page. Quindi nella sezione Advanced configurare manualmente il valore di IP Address (è possibile conoscere l'indirzzo nel menu Settings ⇒ System information di Kodi) e Port (valore predefinito 50152). A questo punto sarà possibile puntare un browser all'indirizzo del tipo http://192.168.33.47:50152/youtube/api e copiare le tre stringhe.

Al primo avvio dell'add-on è necessario eseguire l'opzione Sign In del menu. In effetti tale operazione deve essere eseguita due volte, in entrambi i casi sullo schermo di Kodi viene visualizzato un codice che deve essere digitato per conferma nella pagina web https://google.com/device, avendo fatto login con il nostro account Google. Questa è la procedura prevista da Google che consente di associare un dispositivo al proprio account. Durante questa operazione il sito Google avvisa che Questa app non è stata verificata, cioè stiamo concedendo all'add-on la possibilità di accedere al nostro account, ma Google non si assume la responsabilità di ciò che la app potrà fare.

La procedura di Sign-In dell'addon con la relativa autorizzazione online su https://google.com/device viene in effetti eseguita due volte (con due codici diversi) ed è indispensabile completarle entrambe. Se la procedura viene eseguita una volta sola (e di conseguenza l'addon non funziona) è molto probabile che la versione dell'addon sia obsoleta, ad esempio la versione 7.1.1.6 disponibile per Kodi 20.1 Nexus sul repository ufficiale non funziona.

È necessario installare una versione più recente, ad esempio la v7.2.0+beta.8 scaricata direttamente dal repository GitHub Releases. La versione generica plugin.video.youtube-7.2.0+beta.8.zip funziona correttamente su Kodi Nexus.

Dopo aver effettuato l'aggiornamento da file zip, per sicurezza si effettua il Sign-Out dall'addon e quindi si riavvia Kodi. A questo punto il Sign-In avviene correttamente chiedendo l'autorizzazione due volte.

L'add-on TubeCast per Kodi dipende dall'add-on YouTube.

• script.tubecast - Provata la versione 1.4.4 su Kodi 17.6, RaspiOS Debian 9.11.

Si tratta di un Cast V1 protocol server, in grado di ricevere comandi dall'app Youtube mobile e quindi mandare a tutto schermo un video proveniente dal sito YuoTube a seguito di un comando impartito dalla app sullo smartphone.

Una volta installato l'add-on, questo genera un codice univico per il pairing che verrà utilizzato dalla app mobile per riconoscere Kodi come dispositivo compatibile cast v1 protocol. L'add-on funziona solo se l'app Youtube continuerà a supportare tale protocollo.

Dopo aver individuato un video nell'app Youtube, si tocca l'icona Trasmetti a…; lo smartphone dovrebbe elencare tutti i dispositivi compatibili chromecast nella rete locale e quindi consentire di inviare il video al nostro Kodi. Il device Kodi viene presentato con il nome che è stato impostato in Settings ⇒ Service settings ⇒ Device name.

• API Key Creation - How To