YouTube Live Manager (by LucaFox)

Plugin WordPress per gestire dal backend la creazione e la gestione delle dirette YouTube tramite YouTube Data API v3 / Live Streaming API.

Versione stabile corrente: 0.2.8
Nota: la versione 0.2.9 è stata scartata e non va usata, perché simulava la rigenerazione delle stream key creando/eliminando stream YouTube invece di usare il vero comando “Reimposta” di YouTube Studio, che non risulta esposto via API pubblica.

Funzioni principali

• Collegamento OAuth al canale YouTube.
• Pagina impostazioni canale e credenziali Google Cloud.
• Dati default per le dirette.
• Gestione chiavi streaming / profili OBS.
• Sincronizzazione chiavi streaming esistenti da YouTube.
• Creazione di una nuova diretta singola.
• Gestione dirette ricorrenti.
• Sincronizzazione dirette già programmate da YouTube.
• Console “In diretta ora” con stato broadcast, stato stream e salute streaming.
• Comandi test, go live e stop.
• Cambio chiave streaming/profilo OBS sulle dirette programmate.
• Opzione avanzata per forzare il cambio chiave anche in testing/live, con consenso esplicito.
• Eliminazione dirette programmate.
• Upload/selezione miniatura da libreria media WordPress.
• Selezione playlist.
• Opzioni auto start, auto stop, DVR e impostazione replay come non in elenco al termine.
• Log diagnostico.

Requisiti

• WordPress 6.0 o superiore.
• PHP 8.0 o superiore.
• Canale YouTube abilitato allo streaming live.
• Progetto Google Cloud con YouTube Data API v3 abilitata.
• Credenziali OAuth 2.0 di tipo Web application.

Installazione

Da ZIP

1. Crea lo ZIP della cartella plugin oppure scarica una release già pronta.
2. In WordPress vai su Plugin → Aggiungi nuovo → Carica plugin.
3. Carica lo ZIP.
4. Attiva il plugin.
5. Vai in YouTube Live Manager → Impostazioni canale.

Da Git

Copia o clona la repository nella cartella plugin di WordPress:

cd wp-content/plugins
git clone https://github.com/TUO-UTENTE/youtube-live-manager.git

Poi attiva il plugin dal backend WordPress.

Configurazione OAuth Google / YouTube

1. Apri Google Cloud Console.
2. Crea o seleziona un progetto.
3. Abilita YouTube Data API v3.
4. Configura la schermata di consenso OAuth.
5. Crea credenziali OAuth Client ID di tipo Web application.
6. In WordPress vai su YouTube Live Manager → Impostazioni canale.
7. Copia il Redirect URI mostrato dal plugin.
8. Incollalo in Google Cloud tra gli Authorized redirect URIs.
9. Copia nel plugin Client ID e Client Secret.
10. Salva e poi premi Collega account YouTube.

Per uso personale puoi lasciare l’app OAuth in modalità test, aggiungendo il tuo account Google tra i tester autorizzati.

Menu backend

L’ordine del menu è:

1. In diretta ora
2. Nuova diretta
3. Dirette ricorrenti
4. Nuova diretta ricorrente
5. Default dirette
6. Chiavi streaming
7. Impostazioni canale
8. Log / Diagnostica

La voce In diretta ora diventa rossa se il plugin rileva almeno uno stream active.

Cron e automazioni

Il plugin usa WP-Cron con intervallo a 5 minuti per le automazioni. In produzione è consigliato configurare un cron reale del server che richiami wp-cron.php, così la creazione delle dirette ricorrenti non dipende dalle visite al sito.

Esempio:

*/5 * * * * curl -s https://www.example.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1

Note tecniche su YouTube API

La logica del plugin usa:

• liveBroadcasts.insert per creare una diretta.
• liveStreams.insert per creare uno stream/chiave.
• liveBroadcasts.bind per associare broadcast e stream.
• liveBroadcasts.transition per passare a testing, live o complete.
• liveStreams.list per recuperare stato e integrità dello stream.
• liveBroadcasts.list per recuperare dirette programmate e attive.
• thumbnails.set per caricare una miniatura.
• playlistItems.insert per aggiungere il video a una playlist.

Limitazioni note

• YouTube non espone pubblicamente via API il comando “Reimposta” della stream key visibile in YouTube Studio.
• Il plugin non rigenera quindi le stream key esistenti.
• Per reimpostare davvero una chiave, usare YouTube Studio e poi premere Sincronizza chiavi da YouTube nel plugin.
• Il cambio chiave durante una diretta testing o live è una funzione di emergenza e può interrompere o rendere instabile la diretta.
• La rimozione della miniatura vale per la configurazione del plugin; YouTube API non offre un vero comando equivalente a “delete thumbnail” per togliere una miniatura già caricata.

Struttura repository

youtube-live-manager.php
includes/
  class-ylm-activator.php
  class-ylm-admin.php
  class-ylm-logger.php
  class-ylm-scheduler.php
  class-ylm-youtube-client.php
assets/
  admin.css
.github/workflows/
  build-release.yml

Stato release

• Corrente stabile: v0.2.8.
• v0.2.9: scartata, non usare.

Licenza

Copyright © 2026 LucaFox. Tutti i diritti riservati, salvo diversa indicazione futura.