Convertir les sous-titres YouTube JSON3 en SRT, VTT ou LRC

JSON3 est le format de sous-titres structuré utilisé en interne par YouTube. Il conserve le minutage en millisecondes, les décalages par mot et tous les segments de texte, mais presque aucun lecteur externe ne le comprend. Ce guide explique comment récupérer les sous-titres YouTube en JSON3, puis les convertir en quelques secondes en SRT, VTT ou LRC selon votre outil de destination.

Qu'est-ce que le format JSON3 ?

JSON3 est une représentation JSON du flux timedtext de YouTube. Chaque sous-titre est un événement contenant un temps de début en millisecondes (tStartMs), une durée (dDurationMs) et un ou plusieurs segments de texte (segs). Certains segments incluent aussi un décalage au niveau du mot (tOffsetMs) pour un minutage de type karaoké.

Comme il s'agit de JSON structuré, JSON3 conserve plus d'informations de minutage que les formats lus par les lecteurs vidéo classiques. C'est donc un excellent format intermédiaire, mais un mauvais format de livraison : téléchargez JSON3 pour la fidélité, puis convertissez-le.

Comment télécharger des sous-titres YouTube en JSON3

Option 1 : yt-dlp (recommandé)

La méthode la plus fiable est yt-dlp, le successeur activement maintenu de youtube-dl. Pour récupérer uniquement les sous-titres automatiques anglais, sans la vidéo :

yt-dlp --write-auto-subs --sub-lang en --sub-format json3 --skip-download "https://www.youtube.com/watch?v=VIDEO_ID"

Un fichier .json3 est créé dans le dossier courant. Si une piste relue par un humain existe, remplacez --write-auto-subs par --write-subs : elle est généralement plus précise.

Option 2 : API timedtext de YouTube

Le point d'accès timedtext peut renvoyer directement JSON3. Indiquez l'identifiant de la vidéo et le code de langue :

https://www.youtube.com/api/timedtext?v=VIDEO_ID&lang=en&fmt=json3

Les sous-titres générés automatiquement peuvent exiger des paramètres supplémentaires, et YouTube limite parfois cet accès.

Option 3 : extension de navigateur

Plusieurs extensions ajoutent un bouton de téléchargement aux pages YouTube et exportent en JSON3 ou VTT. C'est pratique pour un usage ponctuel, mais vous contrôlez moins bien la piste linguistique et le format de sortie qu'avec yt-dlp.

Pourquoi convertir JSON3 ?

Aucun lecteur standard, logiciel de montage ou application de paroles ne lit JSON3. Chaque format cible répond à un besoin précis :

• SRT pour la compatibilité universelle avec les lecteurs, téléviseurs, téléphones et outils de montage.
• VTT pour la vidéo web et le standard HTML5 WebVTT.
• LRC pour des paroles synchronisées dans un lecteur audio ou un logiciel de karaoké.

Le flux de conversion

1. Téléchargez le fichier JSON3. Utilisez yt-dlp ou l'API timedtext.
2. Choisissez le convertisseur. Ouvrez JSON vers SRT, JSON vers VTT ou JSON vers LRC selon la destination.
3. Déposez et convertissez. La conversion fonctionne dans votre navigateur ; le fichier ne quitte pas votre ordinateur.
4. Vérifiez le résultat. Ouvrez la sortie dans un éditeur texte ou lisez-la avec la vidéo pour contrôler le minutage.

Que devient le minutage pendant la conversion ?

• Décalages par mot : ils sont regroupés en début et fin de sous-titre, car SRT, VTT et LRC n'ont qu'un minutage par cue.
• Précision : SRT et VTT conservent les millisecondes ; LRC arrondit au centième de seconde.
• Temps de fin : conservés en SRT et VTT, supprimés en LRC, qui n'enregistre que les débuts.

Ces simplifications n'affectent normalement pas la lisibilité : le début et la fin de chaque ligne restent alignés avec l'image.

Problèmes courants et solutions

• Fichier vide ou minuscule : la piste demandée n'existe peut-être pas. Essayez un autre code avec --sub-lang et vérifiez le bouton CC.
• Minutage instable : les sous-titres automatiques restent approximatifs, surtout sur les longues vidéos. Préférez une piste humaine si disponible.
• Caractères mal affichés : JSON3 est en UTF-8 ; ouvrez aussi le fichier converti en UTF-8.
• Plusieurs pistes téléchargées : filtrez avec --sub-lang.

Confidentialité et sécurité des fichiers

Les sous-titres peuvent contenir des informations sensibles. En téléchargeant avec un outil local et en convertissant dans le navigateur, tout le flux reste sur votre machine : aucun envoi, aucun serveur tiers, aucun nettoyage ultérieur.

Prêt à convertir

JSON3 offre la capture la plus fidèle des sous-titres YouTube. La conversion en SRT, VTT ou LRC la rend réellement utilisable.