« Youtube-dl » : différence entre les versions

De OSWiki
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)