Aller au contenu
yt-dlp

Télécharger les sous-titres YouTube — générateur de commandes yt-dlp

Composez une commande yt-dlp qui enregistre les sous-titres en .srt sans télécharger la vidéo.

Facultatif. Laissez vide et la commande se terminera par URL, à compléter vous-même.

Votre commande

yt-dlp --write-subs --convert-subs srt --sub-langs en --write-auto-subs --no-playlist -s 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
Bases

Audio seul extrait la piste sonore et jette la vidéo.

Vidéo et qualité

Plafonne la hauteur. yt-dlp choisit malgré tout la meilleure piste à ce niveau ou en dessous.

Le type de fichier dans lequel les pistes vidéo et audio séparées sont fusionnées.

Options avancées (3)

Remplace la liste de qualité. Pour ceux qui connaissent déjà la syntaxe des formats.

Réemballe les pistes sans réencoder. Rapide et sans perte.

Réencode la vidéo. Lent et avec perte — seulement si remux ne suffit pas.

Audio

Le fichier vers lequel l'audio est converti.

Le VBR offre le meilleur rapport taille/qualité ; un bitrate fixe est plus prévisible.

Sous-titres

L'incrustation les place dans la vidéo ; l'enregistrement écrit un .srt séparé à côté.

Séparées par des virgules. Écrivez all pour toutes les langues disponibles.

Playlists et chaînes

Que faire quand l'URL appartient à la fois à une vidéo et à une playlist.

Les plages et les listes fonctionnent, par exemple 1-10,15 ou -5::2 pour un élément sur deux depuis la fin.

Options avancées (1)

Note ce qui a déjà été téléchargé pour qu'une nouvelle exécution le saute. C'est ainsi qu'on garde une chaîne à jour.

Extraits et chapitres
Options avancées (2)

Une plage horaire comme *00:01:30-00:03:00, ou un nom de chapitre. L'astérisque de tête indique un horodatage.

Métadonnées et pochette
Options avancées (3)
SponsorBlock

Coupe du fichier les segments signalés par la communauté, d'après les données SponsorBlock.

Options avancées (1)

Conserve les segments mais les signale, pour que vous les sautiez vous-même.

Fichiers et dossiers

Les noms de champs s'écrivent dans %(...)s. Les barres obliques créent des dossiers.

Options avancées (4)

Où les fichiers sont écrits. Combiné au modèle ci-dessus, cela crée des sous-dossiers.

Longueur maximale du nom de fichier, en caractères.

Filtres
Options avancées (5)

AAAAMMJJ, ou une date relative comme now-1month.

AAAAMMJJ, ou une date relative.

Saute tout ce qui est plus petit. Accepte 5M, 500K et analogues.

Saute tout ce qui est plus grand.

Nombre de fichiers à télécharger avant de s'arrêter.

Réseau

Par exemple 2M ou 500K. Utile quand vous avez besoin du reste de la bande passante.

Options avancées (5)

Accélère les flux fragmentés. Quatre est un point de départ raisonnable.

Combien de fois réessayer une partie en échec. infinite est accepté.

URL d'un proxy HTTP, HTTPS ou SOCKS.

Fait ressembler les requêtes à celles d'un vrai navigateur. C'est le remède habituel à un 403 soudain.

Connexion et cookies

Lit directement votre session connectée. Nécessaire pour le contenu privé, restreint par âge ou réservé aux membres.

Options avancées (1)

Un cookies.txt au format Netscape exporté depuis votre navigateur.

Direct
Options avancées (2)

Interroge jusqu'à ce qu'un direct programmé commence. MIN-MAX est l'intervalle entre les vérifications, en secondes.

Contournements
Options avancées (3)

Obsolète au profit de --add-headers. Conservé parce que beaucoup de vieux tutoriels s'en servent encore.

Obsolète au profit de --add-headers.

Options propres à un site, par exemple youtube:player_client=web.

Sortie et débogage
Options avancées (2)
Réinitialiser

Les sous-titres sans la vidéo

Le mode simulation fait tout sauf écrire le fichier vidéo : vous gardez les sous-titres et vous évitez le téléchargement. La conversion en SRT exige ffmpeg.

Si rien n'apparaît, la vidéo n'a très probablement pas de sous-titres écrits par un humain — les automatiques sont une option distincte, et sans elle yt-dlp ne trouve rien et ne le dit pas non plus.

Le mode simulation est l'interrupteur porteur de cette page : sans lui, yt-dlp télécharge toute la vidéo et se contente d'enregistrer aussi les sous-titres — sur un fichier long comme un film, c'est beaucoup de transfert pour une piste de texte. Avec lui, l'exécution récupère les métadonnées, écrit les fichiers de sous-titres et ne touche jamais la vidéo. La contrepartie est que le mode simulation saute aussi l'écriture de la vignette et de la description auxquelles vous étiez peut-être habitué — ce sont des artefacts d'une exécution vidéo, pas de sous-titres.

La sélection de langue est le point délicat des téléchargements de sous-titres. --sub-langs en prend exactement la piste étiquetée « en » ; en-orig est le nom de YouTube pour la générée automatiquement, et en.* en motif attrape les deux plus les variantes régionales. Plusieurs langues prennent une liste séparée par des virgules. Si une vidéo a à la fois une piste humaine et une piste auto pour la même langue, ce sont deux éléments séparés, et télécharger les deux est un résultat légitime, pas un bug.

Les formats comptent quand le fichier de sous-titres part dans un éditeur : SRT est l'échange sûr, VTT porte la mise en forme que le lecteur web affiche, et les formats JSON3/_SRV de YouTube même sont destinés aux machines. L'interrupteur « convertir en SRT » traite le cas courant, exige ffmpeg et perd la mise en forme à dessein — les éditeurs veulent du texte, pas du balisage. Si la sortie paraît vide, vérifiez que le fichier existe avant de conclure que la conversion a échoué : un SRT de zéro octet signifie que la piste elle-même était vide.

Les sous-titres générés automatiquement méritent un avertissement : c'est de la transcription machine, avec tout ce que cela implique — homophones faux, pas de ponctuation, noms estropiés. Pour une vidéo dans une langue que vous lisez, ils sont un index de recherche ; pour tout ce que vous citerez, la piste humaine (quand elle existe) est celle qui vaut la peine d'être gardée. Les directs reçoivent leurs sous-titres automatiques en direct, enregistrés seulement après la fin du direct — les options d'enregistrement live de ce site concernent l'image, et les sous-titres d'un direct terminé se téléchargent avec les options de sous-titres normales.

Questions fréquentes

Comment télécharger des sous-titres sans la vidéo ?
Choisissez l'option .srt et activez la simulation : elle saute l'écriture du fichier vidéo tout en enregistrant les sous-titres.
Pourquoi aucun fichier de sous-titres n'est apparu ?
La vidéo n'a probablement pas de sous-titres humains. Activez les automatiques pour obtenir ceux générés par machine.
Comment choisir les langues de sous-titres ?
Séparez-les par des virgules, par exemple en,fr. all pour toutes les langues disponibles, ou un motif comme en.* pour toutes les variantes de l'anglais.
Peut-on obtenir du SRT au lieu du VTT ?
Oui — l'option .srt les convertit, et cela exige ffmpeg.