Téléchargements de base
Sans aucune option, yt-dlp choisit la meilleure combinaison qu’il peut fusionner et nomme le fichier d’après le titre. C’est étonnamment souvent la bonne commande.
yt-dlp URL
Avant de télécharger quelque chose de gros, il vaut la peine de voir ce qui est réellement proposé. Ceci affiche le tableau des formats et s’arrête sans rien télécharger.
yt-dlp -F URL
La colonne de gauche de ce tableau est l’id de format, que vous pouvez ensuite demander directement. Deux ids reliés par + signifient « télécharge les deux et fusionne-les ».
yt-dlp -f 137+140 URL
Qualité et sélection du format
Les ids de format écrits en dur cassent dès qu’un site change son échelle d’encodage. Une expression de sélection est la version durable : demandez les propriétés voulues et laissez yt-dlp trouver la meilleure correspondance.
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL
À lire ainsi : le meilleur flux vidéo d’une hauteur d’au plus 1080 plus le meilleur audio, et si cette paire n’existe pas, le meilleur fichier unique d’une hauteur d’au plus 1080. C’est ce repli après la barre oblique qui empêche la commande d’échouer sur les sites ne publiant que des flux progressifs.
Fusionner deux flux produit un conteneur que yt-dlp doit choisir. MP4 se lit partout ; MKV accepte tout ce qu’on lui donne, ce qui compte dès que sous-titres et chapitres entrent en jeu.
yt-dlp -f "bv*+ba" --merge-output-format mp4 URL
Pour exprimer une préférence plutôt qu’une limite stricte, triez au lieu de filtrer. Ceci privilégie le 1080p et le MP4 mais télécharge quand même quelque chose si aucun des deux n’est disponible.
yt-dlp -S "res:1080,ext:mp4" URL
Audio et MP3
Extraire l’audio nécessite ffmpeg — c’est de loin la raison la plus fréquente pour laquelle la commande ci-dessous échoue sur une installation neuve.
yt-dlp -x --audio-format mp3 URL
Ajouter la pochette et les tags coûte deux flags de plus et rend le résultat utilisable dans une bibliothèque musicale, au lieu d’un dossier de fichiers anonymes.
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata URL
--audio-quality 0 signifie débit variable au meilleur réglage, pas « qualité zéro ». S’il vous faut un débit fixe, indiquez-le : --audio-quality 320K.
Quand la source est déjà en AAC ou en Opus, convertir en MP3 réencode et perd de la qualité pour rien. Garder l’original est à la fois plus rapide et meilleur.
yt-dlp -x --audio-format best URL
Sous-titres
Les sous-titres incrustés voyagent avec le fichier ; des fichiers .srt séparés sont plus faciles à éditer et à passer à autre chose.
yt-dlp --embed-subs --sub-langs en URL yt-dlp --write-subs --sub-langs en,vi --convert-subs srt URL
Les sous-titres automatiques sont une option distincte. Sans elle, une vidéo sans sous-titres humains ne produit rien du tout, et aucune erreur.
yt-dlp --write-auto-subs --sub-langs en --convert-subs srt --skip-download URL
Playlists et chaînes
Une URL YouTube appartient souvent à la fois à une vidéo et à une playlist, et yt-dlp doit deviner ce que vous vouliez. Dites-le explicitement.
yt-dlp --no-playlist URL yt-dlp --yes-playlist URL
Pour tout ce qui est long, le fichier d’archive compte plus que n’importe quelle autre option ici : il note ce qui a déjà été téléchargé, si bien qu’une nouvelle exécution reprend là où elle s’était arrêtée au lieu de tout recommencer.
yt-dlp --yes-playlist -i \ --download-archive archive.txt \ -o "%(playlist_index)02d - %(title)s.%(ext)s" \ URL
Combiné à -i, une vidéo bloquée géographiquement ou supprimée n’interrompt plus les deux cents autres. Pour prendre une tranche plutôt que tout, -I accepte des plages et des listes : -I 1:10, -I "1,3,7-10".
Extraits, chapitres et sponsors
Vous pouvez télécharger une partie d’une vidéo au lieu de son intégralité. L’astérisque initial indique un horodatage plutôt qu’un nom de chapitre, et les guillemets sont obligatoires — bash développe un * nu contre vos noms de fichiers.
yt-dlp --download-sections "*00:01:30-00:03:00" URL
SponsorBlock utilise des marqueurs proposés par la communauté pour couper entièrement des segments, ou pour les laisser en place sous forme de chapitres que vous sautez vous-même.
yt-dlp --sponsorblock-remove default URL yt-dlp --sponsorblock-mark all --embed-chapters URL
Noms de fichiers et dossiers
Le modèle de sortie contrôle les deux. Une barre oblique crée un répertoire, donc un seul modèle peut organiser toute une archive.
yt-dlp -o "%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s" URL
Les titres contiennent régulièrement des caractères que certains systèmes de fichiers refusent. --restrict-filenames ramène tout à de l’ASCII simple, ce qui en vaut la peine pour tout ce qui sera déplacé d’une machine à l’autre.
Dans un fichier .bat Windows, chaque % doit être doublé — %%(title)s — sinon l’interpréteur de commandes avale le modèle avant que yt-dlp ne le voie. Le générateur le fait pour vous quand vous téléchargez un .bat.
Les erreurs que vous rencontrerez vraiment
ffmpeg not found
Tout ce qui fusionne, convertit, incruste ou découpe a besoin de ffmpeg dans votre PATH. Installez-le, puis confirmez avec ffmpeg -version.
Sign in to confirm you are not a bot
Essayez d’abord --impersonate chrome, puis --cookies-from-browser. Si les deux échouent, mettez yt-dlp à jour — cette vérification-là change souvent et le correctif arrive généralement dans une version en quelques jours.
Unable to extract player response
Presque toujours un yt-dlp périmé. Mettez-le à jour avant de changer quoi que ce soit d’autre : yt-dlp -U, ou votre gestionnaire de paquets si vous l’avez installé ainsi.
Requested format is not available
Votre sélecteur n’a rien trouvé. Lancez -F pour voir ce qui existe, et préférez un tri (-S) à un filtre strict afin d’avoir toujours un repli.
HTTP Error 403
L’URL a été signée pour une autre session ou une autre région. Relancez avec des cookies frais, ajoutez --impersonate chrome, ou essayez --geo-bypass.
Garder yt-dlp à jour
Une mise à jour corrige plus de bugs signalés que n’importe quel flag. Si vous avez installé le binaire autonome :
yt-dlp -U
Installé via un gestionnaire de paquets, mettez-le à jour de la même façon — -U refusera, et il a raison.