Youtube-dl
youtube-dl - télécharger des vidéos à partir de youtube.com ou d'autres plateformes vidéo Traduction des options du README.md
INSTALLATION
Pour installer Youtube-dl immédiatement pour tous les utilisateurs d'UNIX (Linux, macOS, etc.), tapez
sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl -o /usr/local/bin/youtube-dl sudo chmod a+rx /usr/local/bin/youtube-dl
Si vous n'avez pas curl, vous pouvez aussi utiliser un wget récent :
sudo wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl sudo chmod a+rx /usr/local/bin/youtube-dl
Les utilisateurs de Windows télécharger un fichier .exe et le placer n'importe où dans leur PATH sauf `%SYSTEMROOT%\System32` (par exemple ne pas utiliser `C:\Windows\System32`).
Vous pouvez aussi utiliser pip:
sudo -H pip install --upgrade youtube-dl
Cette commande mettra à jour youtube-dl si vous l'avez déjà installé. Voir la page pypi See the pypi page pour plus d'informations.
Les utilisateurs de macOS peuvent installer Youtube-dl avec with Homebrew:
brew install youtube-dl
Ou avec MacPorts:
sudo port install youtube-dl
Ou encore , se reporter aux instructions pour développeur pour savoir comment consulter et travailler avec le dépôt git. Pour d'autres options, y compris les signatures PGP, voir la page de téléchargement youtube-dl.
DESCRIPTION
youtube-dl est un programme en ligne de commande permettant de télécharger des vidéos de YouTube.com et de quelques autres sites. Il nécessite l'interpréteur Python, version 2.6, 2.7 ou 3.2+, et n'est pas spécifique à une plate-forme. Il devrait fonctionner sur votre système Unix, sur Windows ou sur macOS. Il est publié dans le domaine public, ce qui signifie que vous pouvez le modifier, le redistribuer ou l'utiliser comme vous le souhaitez.
youtube-dl [OPTIONS] URL [URL...]
OPTIONS
-h, --help Affiche ce texte d'aide et quitte
--version Affiche la version du programme est quitte
-U, --update Met à jour ce programme vers la dernière version.
Assurez-vous d'avoir les droits suffisants
(lancer avec sudo si nécessaire)
-i, --ignore-errors Poursuivre même après une erreur de téléchargement,
par exemple pour sauter les vidéos non disponibles
dans une playlist
--abort-on-error Abandonner le téléchargement d'autres vidéos (dans
la liste de lecture ou la ligne de commande) si
une erreur se produit.
--dump-user-agent Afficher l'identification du navigateur actuel
--list-extractors Liste de tous les opérateurs d'extraction soutenus
exemple : Youtube ou Viméo ou Peertube
--extractor-descriptions Description des résultats de tous les opérateurs
d'extraction soutenus
--force-generic-extractor Forcer l'extraction à utiliser l'opérateur
générique
--default-search PREFIX Utilisez ce préfix pour les URLs non qualifiées.
Par exemple "gvsearch2:" downloads two videos
from google videos for youtube-dl "large
apple".
Utilisez la valeur "auto" pour laisser deviner
youtube-dl ("auto_warning" pour émettre un
avertissement s'il y a une supposition). "error" ne fait
que lancer une erreur. La valeur par défaut "fixup_error"
répare les URLs cassées, mais envoie une erreur si
ce n'est pas possible au lieu de chercher.
--ignore-config Ne pas lire les fichiers de configuration. Quand cette option
est utilisée dans le fichier de configuration global
/etc/youtube-dl.conf: Ne pas lire la configuration de l'utilisateur
dans ~/.config/youtube-dl/config (%APPDATA%/youtube-dl/config.txt
sous Windows)
--config-location PATH Emplacement du fichier de configuration ; soit
le chemin d'accès à la configuration ou au
répertoir qui la contient.
--flat-playlist Ne pas extraire les vidéos d'une playlist mais,
les lister uniquement.
--mark-watched Marquer les vidéos regardées (YouTube uniquement)
--no-mark-watched Ne pas marquer les vidéos regardées (YouTube uniquement)
--no-color Ne pas émettre de codes de couleur en sortie
Options de réseau
--proxy URL Utilisez le proxy HTTP/HTTPS/SOCKS spécifié.
Pour activer le proxy SOCKS, spécifiez un schéma
approprié. Par exemple socks5://127.0.0.1:1080/.
Passez une chaîne vide (--proxy "") pour une
connexion directe.
--socket-timeout SECONDS Le temps d'attente avant d'abandonner, en secondes
--source-address IP Adresse IP côté client à laquelle se connecter.
-4, --force-ipv4 Effectuez toutes les connexions via IPv4.
-6, --force-ipv6 Effectuez toutes les connexions via IPv6.
Restriction Géographique
--geo-verification-proxy URL Utilisez ce proxy pour vérifier l'adresse IP
de certains sites à accès limité. Le proxy par
défaut spécifié par --proxy (ou aucun, si l'option
n'est pas présente) est utilisé pour
le téléchargement proprement dit.
--geo-bypass Contourner la restriction géographique en falsifiant
l'en-tête HTTP X-Forwarded-For
--no-geo-bypass Ne pas contourner la restruction géographique en falsifiant
l'en-tête HTTP X-Forwarded-For
--geo-bypass-country CODE Contournement forcé de la restriction géographique
grâce à un code pays ISO 3166-2 à deux lettres
explicitement fourni
--geo-bypass-ip-block IP_BLOCK Contournement forcé de la restriction géographique
avec un bloc IP explicitement fourni
dans la notation CIDR
Sélection vidéo
--playlist-start NUMBER Commencer la playlist de vidéos à (par défaut, 1)
--playlist-end NUMBER Terminer la playlit de vidéos à (par défaut, la dernière)
--playlist-items ITEM_SPEC Éléments de la playlist de vidéos à télécharger.
Spécifiez les indices des vidéos dans la playlist
séparés par une virgule comme ceci: "--playlist-items
1,2,5,8" si vous voulez télécharger les vidéos
indexées 1, 2, 5, 8 dans la playlist. Vous pouvez
spécifier un intervalle : "--playlist-items
1-3,7,10-13", cela téléchargera les vidéos
d'index 1, 2, 3, 7, 10, 11, 12 et 13.
--match-title REGEX Télécharger uniquement les titres correspondants
(regex ou sous chaîne sub-string)
--reject-title REGEX Sauter le téléchargement pour les titres correspondants
(regex ou sous chaîne sub-string)
--max-downloads NUMBER Abandon après le téléchargement de NUMBER fichiers
--min-filesize SIZE Ne pas télécharger de vidéo plus petites que
SIZE (exemple: 50k ou 44.6m)
--max-filesize SIZE Ne pas télécharger de vidéo plus grandes que SIZE
(exemple : 50k or 44.6m)
--date DATE Télécharger uniquement les vidéos mises en ligne
à la date DATE
--datebefore DATE Télécharger uniquement les vidéos mises en ligne
au plus tard à la date DATE (c'est-à-dire inclusif)
--dateafter DATE Télécharger uniquement les vidéos mises en ligne
à partir de la date DATE (c'est-à-dire inclusif)
--min-views COUNT Ne pas télécharger de vidéo avec un compte de vues
inférieur à COUNT
--max-views COUNT Ne pas télécharger de vidéo avec un compte de vues
supérieur à COUNT
--match-filter FILTER Filtre vidéo générique. Indiquez n'importe quelle clé (voir
"#MODÈLE DE SORTIE" pour avoir la liste des
clés disponibles) pour vérifier si la clé est
présente, !key pour vérifier si la clé n'est pas
présente, key > NUMBER (par exemple "comment_count
> 12", cela marche aussi avec >=, <, <=, !=, =) pour
comparer avec un nombre, key = 'LITERAL'
(par exemple "uploader = 'Mike Smith'", cela fonctionne
aussi avec !=) pour comparer avec une chaîne littérale
et & pour obtenir des correspondances multiples. Les valeurs
qui ne sont pas connues sont exclues à moins que vous
n'ajoutiez un point d'interrogation (?) après l'opérateur.
Par exemple, pour sélectionner les vidéos qui ont été
aimées plus de 100 fois et désapprouvées
moins de 50 fois (ou la fonctionnalité dislike
n'est pas disponible pour un service donné),
mais qui a aussi une description,
utilisez --match-filter "like_count > 100 &
dislike_count <? 50 & description" .
--no-playlist Télécharger seulement la vidéo, si l'URL renvoie
à une vidéo et à une playlist.
--yes-playlist Télécharger la playlist, si l'URL renvoie
à une vidéo et à une playlist.
--age-limit YEARS Télécharger seulement les vidéos qui correspondent
à l'âge YEARS
--download-archive FILE Télécharger uniquement les vidéos qui ne figurent pas dans
dans le fichier d'archives. Enregistrer les IDs de toutes
les vidéos téléchargées dans le fichier.
--include-ads Téléchargez également les annonces
(expérimental)
Options de téléchargement
-r, --limit-rate RATE Taux de téléchargement maximum en octets par seconde
(exemple: 50K or 4.2M)
-R, --retries RETRIES Nombre de tentatives (10 par défaut), ou
"infinite".
--fragment-retries RETRIES Nombre d'essais pour un fragment (10 par défaut
ou "infinite" (DASH, hlsnative et
ISM)
--skip-unavailable-fragments Sauter les fragments non disponibles (DASH, hlsnative
and ISM)
--abort-on-unavailable-fragment Abandonner le téléchargement lorsqu'un fragment n'est pas
disponible.
--keep-fragments Conservez les fragments téléchargés sur le disque
une fois le téléchargement terminé; les fragments sont
supprimés par défaut.
--buffer-size SIZE Taille du buffer de téléchargement (exemple : 1024 ou 16K)
(par défaut est égal à 1024)
--no-resize-buffer Ne pas ajuster automatiquement la taille du buffer
Par défaut, la taille du buffer est
automatiquement redimensionnée à partir d'une valeur
initiale de SIZE.
--http-chunk-size SIZE Taille des blocs pour un téléchargement par transfert HTTP
par bloc (exemple : 10485760 ou 10M) (par défaut
cette option est désactiviée). Peut être utile pour contourner
la limitation de la bande passante imposée par un serveur web
(experimental)
--playlist-reverse Télécharger les vidéos dans l'ordre inverse d'une playlist.
--playlist-random Télécharger les vidéos d'une playlist dans un ordre aléatoire.
--xattr-set-filesize Définir le fichier xattribute ytdl.filesize
avec la taille estimée du fichier
--hls-prefer-native Utilisez le téléchargeur HLS natif à la place de
ffmpeg
--hls-prefer-ffmpeg Utiliser ffmpeg à la place du téléchargeur HLS
natif.
--hls-use-mpegts Utilisez le conteneur mpegts pour les vidéos HLS,
ce qui permet de lire la vidéo pendant
son téléchargement (certains lecteurs ne permettent pas
cette lecture)
--external-downloader COMMAND Utilisez le téléchargeur externe spécifié.
Soutenus actuellement :
aria2c,avconv,axel,curl,ffmpeg,httpie,wget
--external-downloader-args ARGS Fournir ces arguments au téléchargeur extérne.
Options du système de fichiers
-a, --batch-file FILE Fichier contenant les URLs à télécharger ('-' pour
stdin), une URL par ligne. Les lignes qui commencent
par '#', ';' or ']' sont considérées comme des
commentaires et sont ignorées.
--id Utiliser uniquement l'identifiant de la vidéo dans
le nom du fichier.
-o, --output TEMPLATE Modèle de nom de fichier de sortie, voir
"#MODÈLE DE SORTIE" pour avoir toutes les informations.
--autonumber-start NUMBER Précisez la valeur de départ pour %(autonumber)s
(Par défaut c'est 1)
--restrict-filenames Limiter les noms de fichiers aux seuls ASCII,
et éviter les "&" et les espaces dans
les noms de fichier.
-w, --no-overwrites Ne pas écraser les fichiers
-c, --continue Forcer la reprise des fichiers partiellement téléchargés.
Par défaut, youtube-dl va reprendre les
téléchargements si possible.
--no-continue Ne pas forcer la reprise des fichiers partiellement téléchargés.
(recommencer depuis le début)
--no-part Ne pas utiliser de fichier .part - écrire directement
dans le fichier de sortie
--no-mtime Ne pas utiliser l'en-tête Last-modified pour fixer
l'heure de modification du fichier
--write-description Ecrire la description de la vidéo dans un fichier
.description
--write-info-json Écrire les métadonnées vidéo dans un fichier .info.json
--write-annotations Écrivez des annotations vidéo dans un fichier
.annotations.xml
--load-info-json FILE Fichier JSON contenant les informations de la vidéo
(créé avec l'option "--write-info-json")
--cookies FILE Fichier permettant de lire les cookies File to read et
de les placer dans un cookies jar
--cache-dir DIR Localisation dans le système de fichiers où youtube-dl
peut stocker certaines informations de téléchargement
en permanence. Par défaut
$XDG_CACHE_HOME/youtube-dl ou
~/.cache/youtube-dl . À l'heure actuelle, seuls
les fichiers du lecteur YouTube (pour les vidéos
dont les signatures sont masquées) sont mises en cache,
mais cela pourrait changer
--no-cache-dir Désactiver la mise en cache du système de fichiers
--rm-cache-dir Supprimer tous les fichiers de cache du système de fichiers
Images miniatures
--write-thumbnail Écrire l'image miniature sur le disque
--write-all-thumbnails Ecrire tous les formats d'images miniatures sur le disque
--list-thumbnails Simuler et répertorier tous les formats de vignettes
disponibles.
Verbiage / Options de simulation
-q, --quiet Activer le mode silencieux.
--no-warnings Ignorer les avertissements.
-s, --simulate Ne pas télécharger la vidéo et ne rien écrire
sur le disque.
--skip-download Ne pas télécharger la vidéo
-g, --get-url Simuler, silencieux mais imprimer l'URL
-e, --get-title Simuler, silencieux mais imprimer le titre
--get-id Simuler, silencieux mais imprimer l'id
--get-thumbnail Simuler, en silence mais imprimer l'URL de
la vignette
--get-description Simuler, en silence mais imprimer la description
de la vidéo.
--get-duration Simuler, en silence mais imprimer la taille de
la vidéo.
--get-filename Simuler, en silence mais imprimer le nom du fichier
de sortie
--get-format Simuler, en silence mais imprimer le format
de sortie
-j, --dump-json Simuler, en silence mais imprimer les informations JSON.
Voir "#MODÈLE DE SORTIE" pour avoir une description
des clés disponibles.
-J, --dump-single-json Simuler, en silence mais imprimer les informations JSON
pour chaque argument de la ligne de commande. Si l'URL
renvoie vers une playlist, mettre l'ensemble des informations
de la playlist sur une seule ligne.
--print-json Taire et imprimer les informations de la vidéos en
JSON (La vidéo est en cours de téléchargement).
--newline Barre de progression des résultats sous forme de nouvelles lignes
--no-progress Ne pas afficher la barre de progression
--console-title Afficher la progression dans la barre de titre de la console
-v, --verbose Imprimer diverses informations de débogage
--dump-pages Imprimer les pages téléchargées encodées en avec base64
pour déboguer les problèmes (très verbeux)
--write-pages Ecrire les pages intermédiaires téléchargées dans les
fichier dans le répertoire courant pour déboguer
des problèmes
--print-traffic Afficher le trafic HTTP envoyé et lu
-C, --call-home Contacter le serveur youtube-dl pour débogage
--no-call-home Ne pas contacter le serveur youtube-dl pour
débogage
Solutions de contournement
--encoding ENCODING Forcer l'encodage spécifié (expérimental)
--no-check-certificate Supprimer la validation des certificats HTTPS
--prefer-insecure Utilise une connexion non chiffrée pour récupérer
des informations sur la vidéo. (Actuellement
uniquement pour YouTube).
--user-agent UA Spécifier un agent utilisateur personnalisé
--referer URL Indiquer un référent personnalisé, à utiliser si
l'accès à la vidéo est limité à un seul domaine.
--add-header FIELD:VALUE Spécifier un en-tête HTTP personnalisé et sa valeur,
séparé par deux points ':'. Vous pouvez utiliser
cette option plusieurs fois.
--bidi-workaround Contournez les terminaux qui ne prennent pas
en charge les textes bidirectionnels. Nécessite
un bidiv ou fribidi exécutable dans PATH.
--sleep-interval SECONDS Nombre de seconde à attendre avant chaque
téléchargement quand cette option est utilisée seule
ou limite inférieure de la fourchette
pour une attente randomisée avant chaque
téléchargement (nombre minimum de secondes possible
à attendre) lorsqu'il est utilisé avec
--max-sleep-interval.
--max-sleep-interval SECONDS Limite supérieure d'une plage d'attente randomisée
avant chaque téléchargement (nombre de secondes maximum
possible à attendre). Ne doit être utilisé
qu'avec l'option --min-sleep-interval.
Options de format vidéo
-f, --format FORMAT Code de format vidéo, voir "#SÉLECTION DU FORMAT" pour avoir toutes les informations à ce sujet.
--all-formats Télécharger tous les formats vidéo disponibles
--prefer-free-formats Préfére les formats vidéo gratuits, à moins qu'un
format spécifique ne soit demandé.
-F, --list-formats Liste de tous les formats disponibles des vidéos
demandées.
--youtube-skip-dash-manifest Ne pas télécharger les manifestes DASH et
les données relatives aux vidéos sur YouTube.
--merge-output-format FORMAT Si une fusion est nécessaire ( par exemple :
bestvideo+bestaudio), au format de
conteneur donné. Un de ces formats : mkv, mp4, ogg,
webm, flv. Ignorée si aucune fusion n'est requise.
Options de sous-titrage
--write-sub Rédiger un fichier de sous-titres
--write-auto-sub Rédiger un fichier de sous-titres généré automatiquement
(YouTube seulement)
--all-subs Télécharger tous les sous-titres disponibles de la
vidéo.
--list-subs Liste de tous les sous-titres disponibles pour la vidéo.
--sub-format FORMAT Format des sous-titres, accepte les préférences
de format, par exemple: "srt" ou
"ass/srt/best"
--sub-lang LANGS Langues des sous-titres à télécharger
(optionel) séparées par des virgules, utiliser --list-subs
pour obtenir les balises linguistiques disponibles.
Options d'authentification
-u, --username USERNAME Se connecter avec l'identifiant d'un compte
-p, --password PASSWORD Mot de passe du compte. Si cette option est omise,
youtube-dl le demandera de manière interactive.
-2, --twofactor TWOFACTOR Code d'authentification à deux facteurs
-n, --netrc Utiliser les données d'authentification .netrc
--video-password PASSWORD Mot de passe de la vidéo (vimeo, smotri, youku)
Options Adobe Pass
--ap-mso MSO Adobe Pass opérateur multi-système ( Fournisseur
TV) identifier, utilisez --ap-list-mso pour
obtenir la liste des MSOs disponibles.
--ap-username USERNAME Multiple-system operator account login
--ap-password PASSWORD Multiple-system operator account password.
Si cette option est omise, youtube-dl
demandera le mot de passe de manière interactive.
--ap-list-mso Liste de tous les opérateurs multi-systèmes
pris en charge.
Options de post-traitement
-x, --extract-audio Convertir des fichiers vidéo en fichiers audio uniquement
(nécessite ffmpeg ou avconv et ffprobe ou
avprobe)
--audio-format FORMAT Spécifier le format audio: "best", "aac",
"flac", "mp3", "m4a", "opus", "vorbis", or
"wav"; "best" Par défaut; Pas d'effet sans
-x
--audio-quality QUALITY Spécifier la qualité audio ffmpeg/avconv,
insérer une valeur entre 0 (meilleur) et 9 (pire)
pour VBR ou un bitrate spécifique de type 128K
(Par défault 5)
--recode-video FORMAT Encode la vidéo vers un nouveau format si
nécessaire (actuellement soutenu :
mp4|flv|ogg|webm|mkv|avi)
--postprocessor-args ARGS Donne ces arguments au post-processeur
-k, --keep-video Conservez le fichier vidéo sur disque après
le post-traitement ; la vidéo est effacée par défaut.
--no-post-overwrites Ne pas écraser les fichiers post-traités ;
les fichiers post-traités sont écrasés par
défaut.
--embed-subs Intégrer les sous-titres dans la vidéo (seulement pour
les vidéos mp4, webm et mkv )
--embed-thumbnail Vignette incorporée dans l'audio comme couverture
--add-metadata Écrire les métadonnées dans le fichier vidéo
--metadata-from-title FORMAT Analyser les métadonnées supplémentaires comme le
titre de chanson /l'artiste du titre de la vidéo.
La syntaxe du format est la même que --output.
Une expression régulière avec named capture groups
peut aussi être utilisée. Les paramètres analysés remplacent
les valeurs existantes. Exemple: --metadata-from-
title "%(artist)s - %(title)s" correspond à
un titre comme "Coldplay - Paradise". Exemple
(regex): --metadata-from-title
"(?P<artist>.+?) - (?P<title>.+)"
--xattrs Écrire les métadonnées dans les xattrs du fichier vidéo
(en utilisant les normes dublin core et xdg)
--fixup POLICY Corriger automatiquement les défauts connus du
fichier. Une des options suivantes : never (ne rien faire),
warn (emet un avertissement), detect_or_warn (l'option
par défaut; corrige le fichier si c'est possible, autrement
envoie un avertissement)
--prefer-avconv Préférer avconv à ffmpeg pour exécuter
le post-traitement.
--prefer-ffmpeg Préférer ffmpeg à avconv pour exécuter
le post-traitement.(défaut)
--ffmpeg-location PATH Emplacement du binaire ffmpeg/avconv ;
soit le chemin d'accès au répertoire binaire
ou son contenu.
--exec CMD Exécute une commande sur le fichier après
le téléchargement et le post-traitement, similaire à
trouver -exec syntax. Exemple: --exec 'adb
push {} /sdcard/Music/ && rm {}'
--convert-subs FORMAT Convertir les sous-titres dans un autre format
(actuellement supporté : srt|ass|vtt|lrc)
CONFIGURATION
Vous pouvez configurer youtube-dl en plaçant toute option de ligne de commande prise en charge dans un fichier de configuration. Sous Linux et MacOS, le fichier de configuration pour l'ensemble du système se trouve à l'adresse `/etc/youtube-dl.conf` et le fichier de configuration pour un utilisateur à l'adresse `~/.config/youtube-dl/config`. Sous Windows, le fichier de configuration utilisateur se trouve à l'emplacement `%APPDATA%\youtube-dl\config.txt` ou `C:\Users\<nom d'utilisateur>\youtube-dl.conf`. Notez que le fichier de configuration par défaut peut ne pas exister et que vous devrez donc le créer vous-même.
Par exemple, avec le fichier de configuration suivant, youtube-dl va toujours extraire l'audio, ne pas copier le mtime, utiliser un proxy et enregistrer toutes les vidéos dans le répertoire "Movies" de votre répertoire d'origine :
# Les lignes commençant par # sont des commentaires # Toujours extraire l'audio -x # Ne pas copier le mtime --no-mtime # Utiliser ce proxy --proxy 127.0.0.1:3128 # Enregistrez toutes les vidéos dans le répertoire Vidéos de votre répertoire personnel
-o ~/Movies/%(title)s.%(ext)s