Chapitres YouTube depuis une VOD Twitch

Tu as mis le stream de quatre heures d’hier soir sur YouTube, et il est là, d’un seul bloc. La barre de progression n’offre aucun point d’entrée évident, alors la VOD tourne au ralenti pendant que les clips font le travail. Les chapitres changent la forme de cette page, et YouTube est précis sur la manière de les écrire.

Ce que YouTube exige

Trois exigences viennent directement de la page d’aide de YouTube sur l’ajout de chapitres vidéo. Vois-les comme des conditions que le bloc doit remplir avant que YouTube en tire des chapitres.

• Le premier horodatage doit être 00:00. Pas 00:04, pas 00:11.
• Il te faut au moins trois horodatages, dans l’ordre croissant.
• Chaque chapitre doit durer au moins 10 secondes.

Assure-toi que le premier horodatage de ta liste commence par 00:00. Ta vidéo doit comporter au moins trois horodatages indiqués dans l’ordre croissant. La durée minimale des chapitres vidéo est de 10 secondes.

Aide YouTube, Ajouter des chapitres vidéo

Les horodatages se placent dans la description de la vidéo. YouTube sait aussi générer des chapitres tout seul, et la même page d’aide reste prudente là-dessus : « Les chapitres automatiques ne sont pas disponibles pour toutes les vidéos, et les vidéos éligibles n’en auront pas toutes. » Une liste manuelle prend le pas sur ce que YouTube a produit — la page indique que l’option « remplace les chapitres vidéo automatiques ». Tu peux aussi désactiver les chapitres automatiques pour une seule vidéo depuis sa page de détails, ou pour toute la chaîne dans YouTube Studio sous Paramètres, Valeurs par défaut de l’importation, Paramètres avancés.

Pourquoi un stream remis en ligne en a besoin

Une VOD de stream est un format mal taillé pour YouTube. Elle dure longtemps, elle ne démarre pas dans le vif du sujet, et les premières minutes te montrent souvent en train de régler OBS. Les chapitres rendent la barre de progression lisible : YouTube la découpe en segments étiquetés et liste les titres sous le lecteur, si bien que quelqu’un arrivé depuis un clip tombe sur le changement de jeu plutôt que sur le test du micro. Ça règle un problème de navigation sur une vidéo qu’on regarde surtout en fond, et c’est tout l’argument pour le faire.

D’où viennent les chapitres de ClipEZ

Dans ClipEZ, la détection de chapitres est une étape de l’analyse, après la transcription. L’appel voit la transcription et la durée du stream — les temps de début des segments et leur texte, rien de plus. Ni historique de chat, ni forme d’onde, ni images de la vidéo. Le prompt demande une table des matières d’ensemble pour un seul stream continu : un nouveau jeu, une nouvelle activité, une longue pause, un problème technique, la conclusion. Il dit aussi au modèle de fusionner deux chapitres voisins qui couvrent la même activité, et de laisser tomber une frontière quand il n’est pas sûr.

Deux détails d’implémentation valent d’être connus. Chaque début de chapitre est calé sur une frontière exacte de segment de transcription, donc un chapitre commence là où commence une phrase. Et le nombre de chapitres visé découle de la durée du stream — environ un toutes les quinze minutes, plafonné à vingt, transmis au modèle comme un plancher et un plafond indicatifs plutôt que comme un quota. Le prompt lui dit d’en renvoyer moins quand le stream est homogène : trois heures sur un seul jeu reviennent avec moins de chapitres qu’un stream variety de la même durée.

Un chapitre long peut porter des sous-chapitres — une tentative de boss, un problème technique à l’intérieur d’une phase plus longue. Ils servent à naviguer dans ClipEZ. Le format de chapitres de YouTube est plat : rien d’imbriqué ne survit à un collage dans une description.

Produire le bloc de description

C’est là que ça surprend. L’export Chapitres YT lit tes clips. Les chapitres détectés servent à repérer les frontières ; le fichier, lui, est construit à partir de ce que tu as marqué.

1. Marque un clip à chaque endroit que tu veux voir devenir un chapitre. Saute à un chapitre détecté, vérifie qu’il y a bien un changement de phase, et marque là.
2. Sélectionne ces clips pour l’export, pour qu’ils apparaissent dans la liste de clips de la fenêtre d’export.
3. Coche Chapitres YT dans la fenêtre d’export et lance l’export.

ClipEZ écrit un seul fichier, youtube-chapters.txt, dans le dossier de sortie — par défaut un dossier placé à côté de ta vidéo source et portant son nom. Les clips sont triés par temps de début avant la moindre écriture, donc l’ordre dans lequel tu les as marqués n’a aucune importance. Chaque ligne est un horodatage suivi d’un titre. Le titre est celui du clip quand tu as généré les métadonnées de clip, sinon l’étiquette que tu as tapée sur le clip, sinon un simple Chapter 3. Sous une heure, l’horodatage s’écrit MM:SS ; au-delà d’une heure, le champ des heures apparaît.

Si le premier clip ne commence pas à zéro, ClipEZ ajoute en tête une ligne 00:00 Intro pour que le bloc satisfasse la première exigence de YouTube. Un clip qui commence n’importe où dans la première seconde s’écrit déjà 00:00, et dans ce cas la ligne Intro est omise — deux lignes 00:00 casseraient tout le bloc. Un fichier terminé ressemble à ça :

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

Là où ça casse

• Les horodatages sont des positions dans la VOD source. Coupe l’intro avant de mettre en ligne et chaque chapitre se décale d’autant, ce qui fait tomber le bloc entier à côté. Mets la VOD en ligne telle quelle, ou refais tes marques après avoir coupé.
• YouTube déduit la durée d’un chapitre de l’écart avec l’horodatage suivant. La durée de ton clip n’entre pas en jeu : deux clips espacés de cinq secondes donnent un chapitre de cinq secondes, sous le minimum de 10 secondes de YouTube.
• Il te faut trois horodatages. Un seul clip marqué plus la ligne Intro automatique n’en font que deux.
• Les titres sont collés tels quels dans une description publique et apparaissent dans l’infobulle de la barre de progression. Garde-les courts.
• Les chapitres ne sont pas disponibles sur toutes les vidéos. La page d’aide de YouTube précise que si la chaîne a des avertissements actifs, ou si le contenu peut être inapproprié pour certains spectateurs, la fonctionnalité ne sera pas disponible.

Ce que ClipEZ ne fait pas ici

Il ne met rien en ligne, n’écrit pas ta description et ne touche pas à ta chaîne. L’export est un fichier texte sur ton disque. Tu ouvres la vidéo dans YouTube Studio, tu colles le bloc dans la description et tu enregistres. Si les chapitres automatiques étaient activés sur cette vidéo, ta liste collée les remplace.

La détection de chapitres t’évite le passage où tu parcours une timeline de quatre heures en essayant de te rappeler quand tu as changé de jeu. L’export t’évite la mise en forme. Quelles phases méritent une ligne, c’est toujours toi qui en décides, et c’est justement ce que tu jugeras toujours mieux qu’un modèle qui lit une transcription.