Capitoli YouTube da un VOD di Twitch

Hai ricaricato su YouTube lo stream di quattro ore di ieri sera e se ne sta lì come un unico blocco ininterrotto. La barra di avanzamento non dà a chi guarda nessun punto ovvio da cui partire, così il VOD resta quasi fermo mentre a lavorare sono le clip. I capitoli cambiano la forma di quella pagina, e YouTube è preciso su come vanno scritti.

Cosa richiede YouTube

Tre requisiti arrivano dritti dalla pagina di assistenza di YouTube sull'aggiunta dei capitoli ai video. Trattali come le condizioni che il blocco deve soddisfare perché YouTube ne ricavi i capitoli.

• Il primo timestamp deve essere 00:00. Non 00:04, non 00:11.
• Servono almeno tre timestamp, in ordine crescente.
• Ogni capitolo deve durare almeno 10 secondi.

Assicurati che il primo timestamp che elenchi inizi con 00:00. Il video deve avere almeno tre timestamp elencati in ordine crescente. La durata minima dei capitoli video è di 10 secondi.

Guida di YouTube, Aggiungere capitoli ai video

I timestamp stanno nella descrizione del video. YouTube può anche generare i capitoli da solo, e la stessa pagina di assistenza ci va cauta: «Non tutti i video sono idonei ai capitoli automatici, e non tutti i video idonei avranno i capitoli automatici». Un elenco manuale prevale su quello che ha prodotto: la pagina dice che l'opzione «avrà la precedenza sui capitoli video automatici». I capitoli automatici puoi anche disattivarli su un singolo video dalla sua pagina dei dettagli, o su tutto il canale da YouTube Studio, sotto Impostazioni, Caricamenti predefiniti, Impostazioni avanzate.

Perché servono a uno stream ricaricato

Un VOD di stream ha una forma scomoda per YouTube. Dura tanto, non ha un'apertura d'effetto e nei primi minuti spesso ci sei tu che sistemi OBS. I capitoli rendono leggibile la barra di avanzamento: YouTube la divide in segmenti etichettati ed elenca i titoli sotto il player, così chi arriva da una clip atterra sul cambio di gioco invece che sulla prova del microfono. È una questione di navigazione per un video che fa soprattutto da sottofondo, ed è tutto qui il motivo per farlo.

Da dove arrivano i capitoli di ClipEZ

ClipEZ esegue il rilevamento dei capitoli come fase dell'analisi, dopo la trascrizione. La chiamata vede la trascrizione e la durata dello stream: tempi di inizio dei segmenti e testo dei segmenti, niente di più. Non le arrivano né il log della chat, né la forma d'onda, né i fotogrammi del video. Il prompt chiede un indice a maglie larghe per uno stream continuo: un gioco nuovo, un'attività nuova, una pausa lunga, un problema tecnico, la chiusura. Dice anche al modello di unire i capitoli vicini che coprono la stessa attività e di saltare un confine quando non è sicuro.

Vale la pena conoscere due dettagli di implementazione. Ogni tempo di inizio di un capitolo viene agganciato al confine esatto di un segmento della trascrizione, così un capitolo comincia dove comincia una frase. E il numero di capitoli previsto deriva dalla durata dello stream — circa uno ogni quindici minuti, con un tetto di venti — passato al modello come minimo e massimo indicativi, non come quota. Il prompt gli dice di restituirne meno quando lo stream è omogeneo, così tre ore dello stesso gioco tornano con meno capitoli di uno stream variety della stessa durata.

Un capitolo lungo può portare dei sottocapitoli: un tentativo su un boss, un problema tecnico dentro una fase più lunga. Dentro ClipEZ servono a navigare. Il formato dei capitoli di YouTube è piatto, quindi niente di annidato sopravvive quando incolli il blocco in una descrizione.

Produrre il blocco per la descrizione

Ecco la parte che sorprende. L'esportazione dei capitoli YouTube legge i tuoi tagli. I capitoli rilevati ti servono a trovare i confini; il file viene costruito da quello che hai segnato.

1. Segna un taglio in ogni punto che vuoi diventi un capitolo. Salta a un capitolo rilevato, verifica che sia un vero cambio di fase e segna lì.
2. Contrassegna quei tagli per l'export, così compaiono nella lista delle clip della finestra di esportazione.
3. Spunta Capitoli YT nella finestra di esportazione e lancia l'esportazione.

ClipEZ scrive un solo file, youtube-chapters.txt, nella cartella di output — di default una cartella accanto al tuo video sorgente e con il suo stesso nome. I tagli vengono ordinati per tempo di inizio prima che si scriva qualsiasi cosa, quindi l'ordine in cui li hai segnati non conta. Ogni riga è un timestamp e un titolo. Il titolo è quello della clip quando hai generato i metadati delle clip, altrimenti l'etichetta che hai scritto sul taglio, altrimenti un semplice Chapter 3. Sotto l'ora il timestamp esce come MM:SS; oltre l'ora compare anche il campo delle ore.

Se il primo taglio non parte dall'origine, ClipEZ antepone una riga 00:00 Intro perché il blocco soddisfi il primo requisito di YouTube. Un taglio che comincia in un punto qualsiasi entro il primo secondo esce già come 00:00, e in quel caso la riga Intro viene saltata: due righe 00:00 romperebbero l'insieme. Un file finito è fatto così:

00:00 Intro
40:37 His crit build suddenly deletes the entire room
58:03 Gets saved by a resurrection relic after barely surviving the puppet fight
1:07:11 Survives an impossible boss attack and kills him mid-monologue
1:09:20 Thinks he died, then discovers he actually won

Dove si rompe

• I timestamp sono posizioni nel VOD sorgente. Se tagli l'intro prima di caricare, ogni capitolo slitta di quanto hai tolto e il blocco intero va fuori posto. Carica il VOD così com'è, oppure rifai i segni dopo aver tagliato.
• YouTube ricava la durata di un capitolo dalla distanza dal timestamp successivo. La durata del tuo taglio non c'entra, quindi due tagli distanti cinque secondi producono un capitolo di cinque secondi e restano sotto il minimo di 10 secondi di YouTube.
• Servono tre timestamp. Un solo taglio segnato più la riga Intro automatica ne fanno due.
• I titoli finiscono testuali in una descrizione pubblica e compaiono nel tooltip della barra di avanzamento. Tienili corti.
• I capitoli non sono disponibili su ogni video. La pagina di assistenza di YouTube dice che se il canale ha avvertimenti attivi, o se il contenuto può risultare inappropriato per alcuni spettatori, la funzione non sarà disponibile.

Cosa non fa ClipEZ qui

Non carica niente, non scrive la tua descrizione e non tocca il tuo canale. L'esportazione è un file di testo sul tuo disco. Apri il video in YouTube Studio, incolli il blocco nella descrizione e salvi. Se per quel video i capitoli automatici erano attivi, l'elenco che hai incollato li sostituisce.

Il rilevamento dei capitoli ti risparmia il giro in cui scorri una timeline di quattro ore cercando di ricordare quando hai cambiato gioco. L'esportazione ti risparmia la formattazione. Quali fasi meritino una riga resta una tua decisione, ed è la parte che avresti comunque giudicato meglio di un modello che legge una trascrizione.