Référence des options yt-dlp

Ce que vous voulez

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

Qualité maximale

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

format selector personnalisé

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

Container

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

Remux vers

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

Réencoder vers

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

Format audio

Le fichier vers lequel l'audio est converti.

Qualité audio

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é.

Langues des sous-titres

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

Sous-titres automatiques

Inclut les sous-titres générés par machine quand il n'y en a pas d'humains.

Traitement des playlists

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

Quels éléments

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

Fichier de suivi

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.

Ne télécharger qu'un extrait

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

Découper par chapitres

Écrit un fichier par chapitre au lieu d'un seul long.

Incruster la miniature

Utilise la miniature de la vidéo comme pochette.

Incruster les métadonnées

Écrit le titre, l'auteur et la date dans le fichier lui-même.

Incruster les chapitres

Ajoute des repères de chapitre entre lesquels votre lecteur peut sauter.

Enregistrer la miniature

Écrit l'image de pochette à côté de la vidéo.

Enregistrer la description

Écrit la description dans un fichier .description.

Enregistrer les métadonnées en JSON

Écrit tout ce que yt-dlp sait de la vidéo dans un fichier .info.json.

Supprimer des segments

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

Marquer les segments en chapitres

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

Modèle de nom de fichier

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

Dossier de téléchargement

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

Noms de fichiers sûrs (ASCII uniquement)

Retire les accents, les espaces et tout caractère qu'un système de fichiers pointilleux pourrait refuser.

Noms compatibles Windows

Retire les caractères que Windows refuse, même si vous travaillez sur un autre système.

Raccourcir les noms à

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

Écraser les fichiers existants

Remplace les fichiers déjà présents.

Ne jamais écraser

Saute tout ce qui est déjà téléchargé.

Reprendre les téléchargements interrompus

Repart de là où le téléchargement s'est arrêté.

Publié après

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

Publié avant

AAAAMMJJ, ou une date relative.

Taille minimale

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

Taille maximale

Saute tout ce qui est plus grand.

Arrêter après

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

Limite de débit

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

fragments en parallèle

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

Nouvelles tentatives

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

Proxy

URL d'un proxy HTTP, HTTPS ou SOCKS.

Contourner le blocage géographique

Feint l'origine de la requête. Fonctionne sur certains sites, pas sur tous.

Se faire passer pour un navigateur

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

Cookies depuis le navigateur

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

Fichier cookies

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

Enregistrer depuis le début

Démarre un direct au début plutôt qu'à l'instant présent.

Attendre le direct

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

User agent

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

Referer

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

Arguments d'extractor

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

Continuer malgré les erreurs

Saute les éléments en échec au lieu de s'arrêter. Indispensable sur les grandes playlists.

Lister les formats seulement

Affiche les formats disponibles et s'arrête sans télécharger.

Simuler

Fait tout sauf écrire le fichier.