« Youtube-dl » : différence entre les versions
Aller à la navigation
Aller à la recherche
| Ligne 546 : | Ligne 546 : | ||
<noinclude> | <noinclude> | ||
<!-- | |||
=CONFIGURATION= | =CONFIGURATION= | ||
Version du 30 juillet 2020 à 15:52
youtube-dl - télécharger des vidéos à partir de youtube.com ou d'autres plateformes vidéo
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 Write subtitle file
--write-auto-sub Write automatically generated subtitle file
(YouTube only)
--all-subs Download all the available subtitles of the
video
--list-subs List all available subtitles for the video
--sub-format FORMAT Subtitle format, accepts formats
preference, for example: "srt" or
"ass/srt/best"
--sub-lang LANGS Languages of the subtitles to download
(optional) separated by commas, use --list-
subs for available language tags
Options d'authentification
-u, --username USERNAME Login with this account ID
-p, --password PASSWORD Account password. If this option is left
out, youtube-dl will ask interactively.
-2, --twofactor TWOFACTOR Two-factor authentication code
-n, --netrc Use .netrc authentication data
--video-password PASSWORD Video password (vimeo, smotri, youku)
Options Adobe Pass
--ap-mso MSO Adobe Pass multiple-system operator (TV
provider) identifier, use --ap-list-mso for
a list of available MSOs
--ap-username USERNAME Multiple-system operator account login
--ap-password PASSWORD Multiple-system operator account password.
If this option is left out, youtube-dl will
ask interactively.
--ap-list-mso List all supported multiple-system
operators
Options de post-traitement
-x, --extract-audio Convert video files to audio-only files
(requires ffmpeg or avconv and ffprobe or
avprobe)
--audio-format FORMAT Specify audio format: "best", "aac",
"flac", "mp3", "m4a", "opus", "vorbis", or
"wav"; "best" by default; No effect without
-x
--audio-quality QUALITY Specify ffmpeg/avconv audio quality, insert
a value between 0 (better) and 9 (worse)
for VBR or a specific bitrate like 128K
(default 5)
--recode-video FORMAT Encode the video to another format if
necessary (currently supported:
mp4|flv|ogg|webm|mkv|avi)
--postprocessor-args ARGS Give these arguments to the postprocessor
-k, --keep-video Keep the video file on disk after the post-
processing; the video is erased by default
--no-post-overwrites Do not overwrite post-processed files; the
post-processed files are overwritten by
default
--embed-subs Embed subtitles in the video (only for mp4,
webm and mkv videos)
--embed-thumbnail Embed thumbnail in the audio as cover art
--add-metadata Write metadata to the video file
--metadata-from-title FORMAT Parse additional metadata like song title /
artist from the video title. The format
syntax is the same as --output. Regular
expression with named capture groups may
also be used. The parsed parameters replace
existing values. Example: --metadata-from-
title "%(artist)s - %(title)s" matches a
title like "Coldplay - Paradise". Example
(regex): --metadata-from-title
"(?P<artist>.+?) - (?P<title>.+)"
--xattrs Write metadata to the video file's xattrs
(using dublin core and xdg standards)
--fixup POLICY Automatically correct known faults of the
file. One of never (do nothing), warn (only
emit a warning), detect_or_warn (the
default; fix file if we can, warn
otherwise)
--prefer-avconv Prefer avconv over ffmpeg for running the
postprocessors
--prefer-ffmpeg Prefer ffmpeg over avconv for running the
postprocessors (default)
--ffmpeg-location PATH Location of the ffmpeg/avconv binary;
either the path to the binary or its
containing directory.
--exec CMD Execute a command on the file after
downloading and post-processing, similar to
find's -exec syntax. Example: --exec 'adb
push {} /sdcard/Music/ && rm {}'
--convert-subs FORMAT Convert the subtitles to other format
(currently supported: srt|ass|vtt|lrc)