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

De OSWiki
Aller à la navigation Aller à la recherche
(24 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
youtube-dl - télécharger des vidéos à partir de youtube.com ou d'autres plateformes vidéo
youtube-dl - télécharger des vidéos à partir de youtube.com ou d'autres plateformes vidéo
Traduction des options du README.md
[https://github.com/ytdl-org/youtube-dl/blob/master/README.md#readme source]
=INSTALLATION=
=INSTALLATION=


Ligne 536 : Ligne 539 :
     --add-metadata                  Écrire les métadonnées dans le fichier vidéo
     --add-metadata                  Écrire les métadonnées dans le fichier vidéo


     --metadata-from-title FORMAT    Parse additional metadata like song title /
     --metadata-from-title FORMAT    Analyser les métadonnées supplémentaires comme le
                                     artist from the video title. The format
                                     titre de chanson /l'artiste du titre de la vidéo.  
                                     syntax is the same as --output. Regular
                                     La syntaxe du format est la même que --output.  
                                     expression with named capture groups may
                                     Une expression régulière avec ''named capture groups''
                                     also be used. The parsed parameters replace
                                     peut aussi être utilisée. Les paramètres analysés remplacent
                                     existing values. Example: --metadata-from-
                                     les valeurs existantes. Exemple: --metadata-from-
                                     title "%(artist)s - %(title)s" matches a
                                     title "%(artist)s - %(title)s" correspond à
                                     title like "Coldplay - Paradise". Example
                                     un  titre comme "Coldplay - Paradise". Exemple
                                     (regex): --metadata-from-title
                                     (regex): --metadata-from-title
                                     "(?P<artist>.+?) - (?P<title>.+)"
                                     "(?P<artist>.+?) - (?P<title>.+)"


     --xattrs                        Write metadata to the video file's xattrs
     --xattrs                        Écrire les métadonnées dans les xattrs du fichier vidéo
                                     (using dublin core and xdg standards)
                                     (en utilisant les normes dublin core et xdg)


     --fixup POLICY                  Automatically correct known faults of the
     --fixup POLICY                  Corriger automatiquement les défauts connus du
                                     file. One of never (do nothing), warn (only
                                     fichier. Une des options suivantes : never (ne rien faire),  
                                    emit a warning), detect_or_warn (the
                                    warn (emet un avertissement), detect_or_warn (l'option
                                     default; fix file if we can, warn
                                     par défaut; corrige le fichier si c'est possible, autrement
                                     otherwise)
                                     envoie un avertissement)


     --prefer-avconv                  Prefer avconv over ffmpeg for running the
     --prefer-avconv                  Préférer avconv à ffmpeg pour exécuter
                                     postprocessors
                                     le post-traitement.


     --prefer-ffmpeg                  Prefer ffmpeg over avconv for running the
     --prefer-ffmpeg                  Préférer ffmpeg à avconv pour exécuter
                                     postprocessors (default)
                                     le post-traitement.(défaut)


     --ffmpeg-location PATH          Location of the ffmpeg/avconv binary;
     --ffmpeg-location PATH          Emplacement du binaire ffmpeg/avconv ;
                                     either the path to the binary or its
                                     soit le chemin d'accès au répertoire binaire
                                     containing directory.
                                     ou son contenu.


     --exec CMD                      Execute a command on the file after
     --exec CMD                      Exécute une commande sur le fichier après
                                     downloading and post-processing, similar to
                                     le téléchargement et le post-traitement, similaire à
                                     find's -exec syntax. Example: --exec 'adb
                                     trouver -exec syntax. Exemple: --exec 'adb
                                     push {} /sdcard/Music/ && rm {}'
                                     push {} /sdcard/Music/ && rm {}'


     --convert-subs FORMAT            Convert the subtitles to other format
     --convert-subs FORMAT            Convertir les sous-titres dans un autre format
                                     (currently supported: srt|ass|vtt|lrc)
                                     (actuellement supporté : srt|ass|vtt|lrc)
 




<!--
=CONFIGURATION=
=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
Notez que les options du fichier de configuration sont les mêmes que celles utilisées dans les appels en ligne de commande, donc '''il ne doit pas y avoir d'espace''' après "-" ou "--", par exemple "o" ou "--proxy" mais pas "- o" ou "-- proxy".


You can configure youtube-dl by placing any supported command line option to a configuration file. On Linux and macOS, the system wide configuration file is located at `/etc/youtube-dl.conf` and the user wide configuration file at `~/.config/youtube-dl/config`. On Windows, the user wide configuration file locations are `%APPDATA%\youtube-dl\config.txt` or `C:\Users\<user name>\youtube-dl.conf`. Note that by default configuration file may not exist so you may need to create it yourself.
Vous pouvez utiliser `--ignore-config` si vous voulez désactiver le fichier de configuration pour une exécution particulière de youtube-dl.


For example, with the following configuration file youtube-dl will always extract the audio, not copy the mtime, use a proxy and save all videos under `Movies` directory in your home directory:
Vous pouvez également utiliser `--config-location` si vous souhaitez utiliser un fichier de configuration personnalisé pour une exécution particulière de youtube-dl.
```
 
# Lines starting with # are comments
=== Authentication with `.netrc` file===


# Always extract audio
Vous pouvez également configurer le stockage automatique des informations d'identification pour les extracteurs qui prennent en charge l'authentification (en fournissant un nom d'utilisateur et un mot de passe avec `--nom d'utilisateur` et `--mot de passe`) afin de ne pas passer les informations d'identification comme arguments de ligne de commande à chaque exécution de youtube-dl et d'empêcher le suivi des mots de passe en texte clair dans l'historique des commandes du shell. Vous pouvez y parvenir en utilisant un fichier [https://stackoverflow.com/tags/.netrc/info `.netrc`] par extracteur. Pour cela, vous devrez créer un fichier `.netrc` dans votre `$HOME` et limiter les permissions de lecture/écriture à vous seul :
-x


# Do not copy the mtime
touch $HOME/.netrc
--no-mtime
chmod a-rwx,u+rw $HOME/.netrc


# Use this proxy
--proxy 127.0.0.1:3128


# Save all videos under Movies directory in your home directory
Ensuite, vous pouvez ajouter des références pour un extracteur dans le format suivant, où ''extracteur'' est le nom de l'extracteur en minuscules :
-o ~/Movies/%(title)s.%(ext)s
```


Note that options in configuration file are just the same options aka switches used in regular command line calls thus there **must be no whitespace** after `-` or `--`, e.g. `-o` or `--proxy` but not `- o` or `-- proxy`.
machine <extractor> login <login> password <password>


You can use `--ignore-config` if you want to disable the configuration file for a particular youtube-dl run.
Par exemple:


You can also use `--config-location` if you want to use custom configuration file for a particular youtube-dl run.
machine youtube login myaccount@gmail.com password my_youtube_password
machine twitch login my_twitch_account_name password my_twitch_password


### Authentication with `.netrc` file
Pour activer l'authentification avec le fichier `.netrc`, vous devez passer `--netrc` à youtube-dl ou le placer dans le [[#CONFIGURATION fichier de configuration]].


You may also want to configure automatic credentials storage for extractors that support authentication (by providing login and password with `--username` and `--password`) in order not to pass credentials as command line arguments on every youtube-dl execution and prevent tracking plain text passwords in the shell command history. You can achieve this using a [`.netrc` file](https://stackoverflow.com/tags/.netrc/info) on a per extractor basis. For that you will need to create a `.netrc` file in your `$HOME` and restrict permissions to read/write by only you:
Sous Windows, vous pouvez également avoir besoin de configurer manuellement la variable d'environnement "%HOME%". Par exemple :
```
touch $HOME/.netrc
chmod a-rwx,u+rw $HOME/.netrc
```
After that you can add credentials for an extractor in the following format, where *extractor* is the name of the extractor in lowercase:
```
machine <extractor> login <login> password <password>
```
For example:
```
machine youtube login myaccount@gmail.com password my_youtube_password
machine twitch login my_twitch_account_name password my_twitch_password
```
To activate authentication with the `.netrc` file you should pass `--netrc` to youtube-dl or place it in the [configuration file](#configuration).


On Windows you may also need to setup the `%HOME%` environment variable manually. For example:
set HOME=%USERPROFILE%
```
set HOME=%USERPROFILE%
```


=MODÈLE DE SORTIE=
=MODÈLE DE SORTIE=


The `-o` option allows users to indicate a template for the output file names.
L'option "-o" permet aux utilisateurs d'indiquer un modèle pour les noms des fichiers de sortie.
 
[[#Exemples de modèles de sortie | Voir des exemples]]
 
 
L'usage de base n'est pas de définir des arguments pour un modèle lors du téléchargement d'un seul fichier, comme dans :
youtube-dl -o funny_video.flv "https://some/video"
 
Toutefois, le modèle peut contenir des séquences spéciales qui seront remplacées lors du téléchargement de chaque vidéo. Les séquences spéciales peuvent être formatées au moyen d' [https://docs.python.org/2/library/stdtypes.html#string-formatting opérations de formatage de chaîne en python]. Par exemple, `%(NAME)s` ou `%(NAME)05d`. Pour clarifier, il s'agit d'un symbole de pourcentage suivi d'un nom entre parenthèses, suivi d'opérations de formatage. Les noms autorisés ainsi que le type de séquence sont:


**tl;dr:** [navigate me to examples](#output-template-examples).
* '''id''' (chaîne): Identifiant de vidéo
* '''title''' (chaîne): Titre de la vidéo
*'''url''' (chaîne): URL de la vidéo
*'''ext''' (chaîne): Extension du fichier de la vidéo
* '''alt_title''' (chaîne): Titre secondaire  de la vidéo.
* '''display_id''' (chaîne): Un autre identifiant pour la vidéo
* '''uploader''' (chaîne): Nom complet de l'expéditeur de la vidéo
* '''license''' (chaîne): Nom de la licence de la vidéo
* '''creator''' (chaîne): Créateur de la vidéo
* '''release_date''' (chaîne): La date (AAAAMMJJ) à laquelle la vidéo a été diffusée
* '''timestamp''' (numérique): Horodatage UNIX du moment où la vidéo est devenue disponible
* '''upload_date''' (chaîne): Date de téléchargement de la vidéo (AAAAMMJJ)
* '''uploader_id''' (chaîne): Pseudo ou identifiant de l'expéditeur de la vidéo
* '''channel''' (chaîne): Nom complet de la chaîne sur laquelle la vidéo est téléchargée
* '''channel_id''' (chaîne): Id de la chaîne.
* '''location''' (chaîne): Lieu physique où la vidéo a été filmée
* '''duration''' (numérique): Durée de la vidéo en secondes
* '''view_count''' (numérique): Nombre d'utilisateurs qui ont regardé la vidéo sur la plateforme
* '''like_count''' (numérique): Nombre d'évaluations positives de la vidéo
* '''dislike_count''' (numérique): Nombre d'évaluations négatives de la vidéo
* '''repost_count''' (numérique): Nombre de reposts de la vidéo
* '''average_rating''' (numérique): Note moyenne donnée par les utilisateurs, l'échelle utilisée dépend de la page web
* '''comment_count''' (numérique): Nombre de commentaires sur la vidéo
* '''age_limit''' (numérique): Restriction d'âge pour la vidéo (années)
* '''is_live''' (boolean): Si cette vidéo est un flux en direct ou une vidéo de longueur fixe
* '''start_time''' (numérique): Temps en secondes où la copie doit commencer, comme spécifié dans l'URL
* '''end_time''' (numérique): Temps en secondes où la copie doit se terminer, comme spécifié dans l'URL
* '''format''' (chaîne): Une description du format lisible par l'homme
* '''format_id''' (chaîne): Code de format spécifié par '''--format'''
* '''format_note''' (chaîne): Informations complémentaires sur le format
* '''width''' (numérique): Largeur de la vidéo
* '''height''' (numérique): Hauteur de la vidéo
* '''resolution''' (chaîne): Description textuelle de la largeur et de la hauteur
* '''tbr''' (numérique): Débit binaire moyen de l'audio et de la vidéo en KBit/s
* '''abr''' (numérique): Débit binaire audio moyen en KBit/s
* '''acodec''' (chaîne): Nom du codec audio utilisé
* '''asr''' (numérique): Taux d'échantillonnage audio en Hertz
* '''vbr''' (numérique):  Débit binaire vidéo moyen en KBit/s
* '''fps''' (numérique): Fréquence d'images (Frame par seconde)
* '''vcodec''' (chaîne): Nom du codec vidéo utilisé
* '''container''' (chaîne): Nom du format du conteneur
* '''filesize''' (numérique): Le nombre d'octets, s'il est connu à l'avance
* '''filesize_approx''' (numérique): Une estimation du nombre d'octets
* '''protocol''' (chaîne): Le protocole qui sera utilisé pour le téléchargement proprement dit
* '''extractor''' (chaîne): Nom de l'extracteur
* '''extractor_key''' (chaîne): Nom clé de l'extracteur
* '''epoch''' (numérique): Unix epoch when creating the file
* '''autonumber''' (numérique): Numéro à cinq chiffres qui sera augmenté à chaque téléchargement, en commençant par zéro
* '''playlist''' (chaîne): Nom ou identifiant de la playlist qui contient la vidéo
* '''playlist_index''' (numérique): Index de la vidéo dans la playlist, complété par des zéros de tête en fonction de la longueur totale de la playlist
* '''playlist_id''' (chaîne): Identifiant de la playlist
* '''playlist_title''' (chaîne): Titre de la playlist
* '''playlist_uploader''' (chaîne): Nom complet de l'uploader de la playlist
* '''playlist_uploader_id''' (chaîne): Pseudonyme ou identifiant de l'uploader de la playlist


The basic usage is not to set any template arguments when downloading a single file, like in `youtube-dl -o funny_video.flv "https://some/video"`. However, it may contain special sequences that will be replaced when downloading each video. The special sequences may be formatted according to [python string formatting operations](https://docs.python.org/2/library/stdtypes.html#string-formatting). For example, `%(NAME)s` or `%(NAME)05d`. To clarify, that is a percent symbol followed by a name in parentheses, followed by formatting operations. Allowed names along with sequence type are:
Disponible pour la vidéo qui appartient à un chapitre ou à une section logique :


- `id` (string): Video identifier
*'''chapter''' (chaîne): Nom ou titre du chapitre auquel la vidéo appartient.
- `title` (string): Video title
*'''chapter_number''' (numérique): Numéro du chapitre auquel la vidéo appartient.
- `url` (string): Video URL
*'''chapter_id''' (chaîne): Id du chapitre auquel la vidéo appartient.
- `ext` (string): Video filename extension
- `alt_title` (string): A secondary title of the video
- `display_id` (string): An alternative identifier for the video
- `uploader` (string): Full name of the video uploader
- `license` (string): License name the video is licensed under
- `creator` (string): The creator of the video
- `release_date` (string): The date (YYYYMMDD) when the video was released
- `timestamp` (numeric): UNIX timestamp of the moment the video became available
- `upload_date` (string): Video upload date (YYYYMMDD)
- `uploader_id` (string): Nickname or id of the video uploader
- `channel` (string): Full name of the channel the video is uploaded on
- `channel_id` (string): Id of the channel
- `location` (string): Physical location where the video was filmed
- `duration` (numeric): Length of the video in seconds
- `view_count` (numeric): How many users have watched the video on the platform
- `like_count` (numeric): Number of positive ratings of the video
- `dislike_count` (numeric): Number of negative ratings of the video
- `repost_count` (numeric): Number of reposts of the video
- `average_rating` (numeric): Average rating give by users, the scale used depends on the webpage
- `comment_count` (numeric): Number of comments on the video
- `age_limit` (numeric): Age restriction for the video (years)
- `is_live` (boolean): Whether this video is a live stream or a fixed-length video
- `start_time` (numeric): Time in seconds where the reproduction should start, as specified in the URL
- `end_time` (numeric): Time in seconds where the reproduction should end, as specified in the URL
- `format` (string): A human-readable description of the format
- `format_id` (string): Format code specified by `--format`
- `format_note` (string): Additional info about the format
- `width` (numeric): Width of the video
- `height` (numeric): Height of the video
- `resolution` (string): Textual description of width and height
- `tbr` (numeric): Average bitrate of audio and video in KBit/s
- `abr` (numeric): Average audio bitrate in KBit/s
- `acodec` (string): Name of the audio codec in use
- `asr` (numeric): Audio sampling rate in Hertz
- `vbr` (numeric): Average video bitrate in KBit/s
- `fps` (numeric): Frame rate
- `vcodec` (string): Name of the video codec in use
- `container` (string): Name of the container format
- `filesize` (numeric): The number of bytes, if known in advance
- `filesize_approx` (numeric): An estimate for the number of bytes
- `protocol` (string): The protocol that will be used for the actual download
- `extractor` (string): Name of the extractor
- `extractor_key` (string): Key name of the extractor
- `epoch` (numeric): Unix epoch when creating the file
- `autonumber` (numeric): Five-digit number that will be increased with each download, starting at zero
- `playlist` (string): Name or id of the playlist that contains the video
- `playlist_index` (numeric): Index of the video in the playlist padded with leading zeros according to the total length of the playlist
- `playlist_id` (string): Playlist identifier
- `playlist_title` (string): Playlist title
- `playlist_uploader` (string): Full name of the playlist uploader
- `playlist_uploader_id` (string): Nickname or id of the playlist uploader


Available for the video that belongs to some logical chapter or section:
Disponible pour la vidéo qui est un épisode d'une série ou d'un programme :


  - `chapter` (string): Name or title of the chapter the video belongs to
*'''series''' (chaîne): Titre de la série ou du programme auquel l'épisode vidéo appartient
- `chapter_number` (numeric): Number of the chapter the video belongs to
*'''season''' (chaîne): Titre de la saison à laquelle l'épisode vidéo appartient.
- `chapter_id` (string): Id of the chapter the video belongs to
*'''season_number''' (numérique): Numéro de la saison à laquelle l'épisode vidéo appartient.
*'''season_id''' (chaîne): Id de la saison à laquelle l'épisode vidéo  appartient.
*'''episode''' (chaîne): Titre de l'épisode vidéo.
*'''episode_number''' (numérique): Numéro de l'épisode vidéo dans la saison.
*'''episode_id''' (chaîne): Id de l'épisode vidéo.


Available for the video that is an episode of some series or programme:
Disponible pour le média qui est une piste ou une partie d'un album de musique :


- `series` (string): Title of the series or programme the video episode belongs to
*'''track''' (chaîne): Titre de la piste.
- `season` (string): Title of the season the video episode belongs to
*'''track_number''' (numérique): Numéro de la piste dans un album ou un disque.
- `season_number` (numeric): Number of the season the video episode belongs to
*'''track_id''' (chaîne): Id de la piste.
- `season_id` (string): Id of the season the video episode belongs to
*'''artist''' (chaîne): Artiste(s) de la piste.
- `episode` (string): Title of the video episode
*'''genre''' (chaîne): Genre(s) de la piste.
- `episode_number` (numeric): Number of the video episode within a season
*'''album''' (chaîne): Titre de l'album auquel appartient la piste.
- `episode_id` (string): Id of the video episode
*'''album_type''' (chaîne): Type de l'album
*'''album_artist''' (chaîne): Liste de tous les artistes figurant sur l'album.
*'''disc_number''' (numérique): Numéro du disque ou autre support physique auquel la piste appartient
*'''release_year''' (numérique): Année (YYYY) de sortie de l'album


Available for the media that is a track or a part of a music album:


- `track` (string): Title of the track
Chaque séquence susmentionnée, lorsqu'elle est référencée dans un modèle de sortie, sera remplacée par la valeur réelle correspondant au nom de la séquence. Notez que la présence de certaines des séquences n'est pas garantie, car elles dépendent des métadonnées obtenues par un extracteur particulier. Ces séquences seront remplacées par "NA".
- `track_number` (numeric): Number of the track within an album or a disc
- `track_id` (string): Id of the track
- `artist` (string): Artist(s) of the track
- `genre` (string): Genre(s) of the track
- `album` (string): Title of the album the track belongs to
- `album_type` (string): Type of the album
- `album_artist` (string): List of all artists appeared on the album
- `disc_number` (numeric): Number of the disc or other physical medium the track belongs to
- `release_year` (numeric): Year (YYYY) when the album was released


Each aforementioned sequence when referenced in an output template will be replaced by the actual value corresponding to the sequence name. Note that some of the sequences are not guaranteed to be present since they depend on the metadata obtained by a particular extractor. Such sequences will be replaced with `NA`.
Par exemple pour '''-o %(title)s-%(id)s.%(ext)s''' et une vidéo mp4 avec le titre '''youtube-dl test video''' et l'id '''BaW_jenozKcj''', cela résultera en un fichier '''youtube-dl test video-BaW_jenozKcj.mp4''' créé dans le répertoire courant.


For example for `-o %(title)s-%(id)s.%(ext)s` and an mp4 video with title `youtube-dl test video` and id `BaW_jenozKcj`, this will result in a `youtube-dl test video-BaW_jenozKcj.mp4` file created in the current directory.
Pour les séquences numériques, vous pouvez utiliser un formatage en rapport avec les chiffres, par exemple, '''%(view_count)05d''' donnera une chaîne de caractères avec un compte de vues rempli de zéros jusqu'à 5 caractères, comme dans '''00042'''.


For numeric sequences you can use numeric related formatting, for example, `%(view_count)05d` will result in a string with view count padded with zeros up to 5 characters, like in `00042`.
Les modèles de sortie peuvent également contenir un chemin hiérarchique arbitraire, par exemple '''-o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' ''' qui aura pour résultat de télécharger chaque vidéo dans un répertoire correspondant à ce modèle de chemin. Tout répertoire manquant sera automatiquement créé pour vous.


Output templates can also contain arbitrary hierarchical path, e.g. `-o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s'` which will result in downloading each video in a directory corresponding to this path template. Any missing directory will be automatically created for you.
Pour utiliser des pourcentages littéraux dans un modèle de sortie, utilisez "%%". Pour sortir sur stdout, utilisez '''-o -'''.


To use percent literals in an output template use `%%`. To output to stdout use `-o -`.
Le modèle par défaut actuel est '''%(title)s-%(id)s.%(ext)s'''.


The current default template is `%(title)s-%(id)s.%(ext)s`.
Dans certains cas, vous ne voulez pas de caractères spéciaux tels que 中, espaces, ou &, comme par exemple lors du transfert du nom de fichier téléchargé vers un système Windows ou le nom de fichier par un canal non sécurisé 8bit. Dans ces cas, ajoutez le drapeau '''-restrict-filenames''' pour obtenir un titre plus court :


In some cases, you don't want special characters such as 中, spaces, or &, such as when transferring the downloaded filename to a Windows system or the filename through an 8bit-unsafe channel. In these cases, add the `--restrict-filenames` flag to get a shorter title:
===Modèle de sortie et fichiers batch Windows===


#### Output template and Windows batch files
Si vous utilisez un modèle de sortie dans un fichier batch Windows, vous devez alors échapper les caractères en pourcentage ('''%''') en les doublant, de sorte que '''-o "%(title)s-%(id)s.%(ext)s"''' devienne '''-o "%%(title)s-%%(id)s.%%(ext)s"'''. Cependant, vous ne devez pas toucher aux "%" qui ne sont pas des caractères simples, par exemple les variables d'environnement pour l'expansion doivent rester intactes : '''-o "C:\%HOMEPATH%\Desktop\%%(title)s.%%(ext)s"'''.


If you are using an output template inside a Windows batch file then you must escape plain percent characters (`%`) by doubling, so that `-o "%(title)s-%(id)s.%(ext)s"` should become `-o "%%(title)s-%%(id)s.%%(ext)s"`. However you should not touch `%`'s that are not plain characters, e.g. environment variables for expansion should stay intact: `-o "C:\%HOMEPATH%\Desktop\%%(title)s.%%(ext)s"`.
===Exemples de modèles de sortie===


#### Output template examples
Notez que sur Windows, vous devrez peut-être utiliser des guillemets doubles au lieu de guillemets simples.


Note that on Windows you may need to use double quotes instead of single.
$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc
youtube-dl test video ''_ä↭𝕐.mp4    # Toutes sortes de personnages bizarres


```bash
$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc --restrict-filenames
$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc
youtube-dl_test_video_.mp4         # Un simple nom de fichier
youtube-dl test video ''_ä↭𝕐.mp4   # All kinds of weird characters


$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc --restrict-filenames
# Télécharger les vidéos de la playlist de YouTube dans un répertoire séparé indexé par ordre des vidéos dans une playlist
youtube-dl_test_video_.mp4          # A simple file name
$ youtube-dl -o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re


# Download YouTube playlist videos in separate directory indexed by video order in a playlist
# Téléchargez toutes les listes de lecture de la chaîne/utilisateur YouTube en gardant chaque playlist dans un répertoire séparé :
$ youtube-dl -o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re
$ youtube-dl -o '%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/user/TheLinuxFoundation/playlists


# Download all playlists of YouTube channel/user keeping each playlist in separate directory:
# Téléchargez le cours Udemy en gardant chaque chapitre dans un répertoire séparé sous le répertoire MyVideos de votre domicile
$ youtube-dl -o '%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/user/TheLinuxFoundation/playlists
$ youtube-dl -u user -p password -o '~/MyVideos/%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s' https://www.udemy.com/java-tutorial/


# Download Udemy course keeping each chapter in separate directory under MyVideos directory in your home
# Télécharger la saison entière de la série en gardant chaque série et chaque saison dans un répertoire séparé sous C:/MyVideos
$ youtube-dl -u user -p password -o '~/MyVideos/%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s' https://www.udemy.com/java-tutorial/
$ youtube-dl -o "C:/MyVideos/%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s" https://videomore.ru/kino_v_detalayah/5_sezon/367617


# Download entire series season keeping each series and each season in separate directory under C:/MyVideos
# Diffuser la vidéo en cours de téléchargement sur stdout
$ youtube-dl -o "C:/MyVideos/%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s" https://videomore.ru/kino_v_detalayah/5_sezon/367617
$ youtube-dl -o - BaW_jenozKc


# Stream the video being downloaded to stdout
$ youtube-dl -o - BaW_jenozKc
```


=SÉLECTION DU FORMAT=
=SÉLECTION DU FORMAT=


By default youtube-dl tries to download the best available quality, i.e. if you want the best quality you **don't need** to pass any special options, youtube-dl will guess it for you by **default**.
Par défaut, youtube-dl essaie de télécharger la meilleure qualité disponible, c'est-à-dire que si vous voulez la meilleure qualité,  vous  '''n'avez pas besoin''' de passer par des options spéciales, youtube-dl la devinera pour vous par '''par défaut'''.


But sometimes you may want to download in a different format, for example when you are on a slow or intermittent connection. The key mechanism for achieving this is so-called *format selection* based on which you can explicitly specify desired format, select formats based on some criterion or criteria, setup precedence and much more.
Mais parfois, vous voudrez télécharger dans un format différent, par exemple lorsque vous êtes sur une connexion lente ou intermittente. Le mécanisme clé pour y parvenir est ce que l'on appelle la '''sélection de format''', qui vous permet de spécifier explicitement le format souhaité, de sélectionner des formats en fonction d'un ou plusieurs critères, de définir des priorités et bien plus encore.


The general syntax for format selection is `--format FORMAT` or shorter `-f FORMAT` where `FORMAT` is a *selector expression*, i.e. an expression that describes format or formats you would like to download.
La syntaxe générale pour la sélection du format est '''--format FORMAT ''' ou plus court '''-f FORMAT ''' où '''FORMAT'''  est une '''expression de sélection''', c'est-à-dire une expression qui décrit le ou les formats que vous souhaitez télécharger.  


**tl;dr:** [navigate me to examples](#format-selection-examples).
[[#Exemples de sélection de formats|Voir des exemples]].


The simplest case is requesting a specific format, for example with `-f 22` you can download the format with format code equal to 22. You can get the list of available format codes for particular video using `--list-formats` or `-F`. Note that these format codes are extractor specific.  
Le cas le plus simple est de demander un format spécifique, par exemple avec "f 22" vous pouvez télécharger le format avec un code de format égal à 22. Vous pouvez obtenir la liste des codes de format disponibles pour une vidéo particulière en utilisant les formats "-liste" ou "-F". Notez que ces codes de format sont spécifiques à l'extracteur.  


You can also use a file extension (currently `3gp`, `aac`, `flv`, `m4a`, `mp3`, `mp4`, `ogg`, `wav`, `webm` are supported) to download the best quality format of a particular file extension served as a single file, e.g. `-f webm` will download the best quality format with the `webm` extension served as a single file.
Vous pouvez également utiliser une extension de fichier (actuellement `3gp`, `aac`, `flv`, `m4a`, `mp3`, `mp4`, `ogg`, `wav`, `webm` sont supportés) pour télécharger la meilleure qualité de format pour une extension de fichier particulière dans un seul fichier, par exemple '''-f webm''' téléchargera le format de meilleure qualité avec l'extension '''webm'' dans  un seul fichier.


You can also use special names to select particular edge case formats:
Vous pouvez également utiliser des noms spéciaux pour sélectionner des formats particuliers :
*'''best''': Sélectionne la meilleure qualité de format dans un seul fichier avec la vidéo et l'audio.
*'''worst''':Sélectionne la plus mauvaise qualité de format dans un seul fichier avec la vidéo et l'audio.
*'''bestvideo''': Sélectionne la meilleur qualité de format vidéo (par exemple, vidéo DASH). Peut ne pas être disponible.
*'''worstvideo''': Sélectionne la moins bonne qualité de format vidéo. Peut ne pas être disponible.
*'''bestaudio''': Sélectionne la meilleure qualité de format audio. Peut ne pas être disponible.
*'''worstaudio''': Sélectionne la moins bonne qualité de format audio. Peut ne pas être disponible.


- `best`: Select the best quality format represented by a single file with video and audio.
Par exemple, pour télécharger la vidéo de la pire qualité, vous pouvez utiliser le format '''-f worstvideo'''.
- `worst`: Select the worst quality format represented by a single file with video and audio.
- `bestvideo`: Select the best quality video-only format (e.g. DASH video). May not be available.
- `worstvideo`: Select the worst quality video-only format. May not be available.
- `bestaudio`: Select the best quality audio only-format. May not be available.
- `worstaudio`: Select the worst quality audio only-format. May not be available.


For example, to download the worst quality video-only format you can use `-f worstvideo`.
Si vous souhaitez télécharger plusieurs vidéos et qu'elles n'ont pas les mêmes formats disponibles, vous pouvez spécifier l'ordre de préférence en utilisant des slashes.


If you want to download multiple videos and they don't have the same formats available, you can specify the order of preference using slashes. Note that slash is left-associative, i.e. formats on the left hand side are preferred, for example `-f 22/17/18` will download format 22 if it's available, otherwise it will download format 17 if it's available, otherwise it will download format 18 if it's available, otherwise it will complain that no suitable formats are available for download.
'''''La traduction n'est pas encore terminée pour avoir des informations complètes, veuillez vous référer à la version anglaise (voir sources).'''''
<!--
Note that slash is left-associative, i.e. formats on the left hand side are preferred, for example `-f 22/17/18` will download format 22 if it's available, otherwise it will download format 17 if it's available, otherwise it will download format 18 if it's available, otherwise it will complain that no suitable formats are available for download.


If you want to download several formats of the same video use a comma as a separator, e.g. `-f 22,17,18` will download all these three formats, of course if they are available. Or a more sophisticated example combined with the precedence feature: `-f 136/137/mp4/bestvideo,140/m4a/bestaudio`.
If you want to download several formats of the same video use a comma as a separator, e.g. `-f 22,17,18` will download all these three formats, of course if they are available. Or a more sophisticated example combined with the precedence feature: `-f 136/137/mp4/bestvideo,140/m4a/bestaudio`.
Ligne 1 572 : Ligne 1 577 :


It may sound strange, but some bug reports we receive are completely unrelated to youtube-dl and relate to a different, or even the reporter's own, application. Please make sure that you are actually using youtube-dl. If you are using a UI for youtube-dl, report the bug to the maintainer of the actual application providing the UI. On the other hand, if your UI for youtube-dl fails in some way you believe is related to youtube-dl, by all means, go ahead and report the bug.
It may sound strange, but some bug reports we receive are completely unrelated to youtube-dl and relate to a different, or even the reporter's own, application. Please make sure that you are actually using youtube-dl. If you are using a UI for youtube-dl, report the bug to the maintainer of the actual application providing the UI. On the other hand, if your UI for youtube-dl fails in some way you believe is related to youtube-dl, by all means, go ahead and report the bug.
 
-->
=COPYRIGHT=
=COPYRIGHT=


youtube-dl is released into the public domain by the copyright holders.
youtube-dl est mis dans le domaine public par les détenteurs de droits d'auteur.


This README file was originally written by [Daniel Bolton](https://github.com/dbbolton) and is likewise released into the public domain.
Ce fichier README a été écrit à l'origine par [https://github.com/dbbolton Daniel Bolton]  et est également publié dans le domaine public.


-->
[[Catégorie:Tutoriels]]
[[Catégorie:Vidéos]]

Version du 4 août 2020 à 20:21

youtube-dl - télécharger des vidéos à partir de youtube.com ou d'autres plateformes vidéo Traduction des options du README.md

source

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

Notez que les options du fichier de configuration sont les mêmes que celles utilisées dans les appels en ligne de commande, donc il ne doit pas y avoir d'espace après "-" ou "--", par exemple "o" ou "--proxy" mais pas "- o" ou "-- proxy".

Vous pouvez utiliser `--ignore-config` si vous voulez désactiver le fichier de configuration pour une exécution particulière de youtube-dl.

Vous pouvez également utiliser `--config-location` si vous souhaitez utiliser un fichier de configuration personnalisé pour une exécution particulière de youtube-dl.

Authentication with `.netrc` file

Vous pouvez également configurer le stockage automatique des informations d'identification pour les extracteurs qui prennent en charge l'authentification (en fournissant un nom d'utilisateur et un mot de passe avec `--nom d'utilisateur` et `--mot de passe`) afin de ne pas passer les informations d'identification comme arguments de ligne de commande à chaque exécution de youtube-dl et d'empêcher le suivi des mots de passe en texte clair dans l'historique des commandes du shell. Vous pouvez y parvenir en utilisant un fichier `.netrc` par extracteur. Pour cela, vous devrez créer un fichier `.netrc` dans votre `$HOME` et limiter les permissions de lecture/écriture à vous seul :

touch $HOME/.netrc
chmod a-rwx,u+rw $HOME/.netrc


Ensuite, vous pouvez ajouter des références pour un extracteur dans le format suivant, où extracteur est le nom de l'extracteur en minuscules :

machine <extractor> login <login> password <password>

Par exemple:

machine youtube login myaccount@gmail.com password my_youtube_password
machine twitch login my_twitch_account_name password my_twitch_password

Pour activer l'authentification avec le fichier `.netrc`, vous devez passer `--netrc` à youtube-dl ou le placer dans le #CONFIGURATION fichier de configuration.

Sous Windows, vous pouvez également avoir besoin de configurer manuellement la variable d'environnement "%HOME%". Par exemple :

set HOME=%USERPROFILE%

MODÈLE DE SORTIE

L'option "-o" permet aux utilisateurs d'indiquer un modèle pour les noms des fichiers de sortie.

Voir des exemples


L'usage de base n'est pas de définir des arguments pour un modèle lors du téléchargement d'un seul fichier, comme dans :

youtube-dl -o funny_video.flv "https://some/video"

Toutefois, le modèle peut contenir des séquences spéciales qui seront remplacées lors du téléchargement de chaque vidéo. Les séquences spéciales peuvent être formatées au moyen d' opérations de formatage de chaîne en python. Par exemple, `%(NAME)s` ou `%(NAME)05d`. Pour clarifier, il s'agit d'un symbole de pourcentage suivi d'un nom entre parenthèses, suivi d'opérations de formatage. Les noms autorisés ainsi que le type de séquence sont:

  • id (chaîne): Identifiant de vidéo
  • title (chaîne): Titre de la vidéo
  • url (chaîne): URL de la vidéo
  • ext (chaîne): Extension du fichier de la vidéo
  • alt_title (chaîne): Titre secondaire de la vidéo.
  • display_id (chaîne): Un autre identifiant pour la vidéo
  • uploader (chaîne): Nom complet de l'expéditeur de la vidéo
  • license (chaîne): Nom de la licence de la vidéo
  • creator (chaîne): Créateur de la vidéo
  • release_date (chaîne): La date (AAAAMMJJ) à laquelle la vidéo a été diffusée
  • timestamp (numérique): Horodatage UNIX du moment où la vidéo est devenue disponible
  • upload_date (chaîne): Date de téléchargement de la vidéo (AAAAMMJJ)
  • uploader_id (chaîne): Pseudo ou identifiant de l'expéditeur de la vidéo
  • channel (chaîne): Nom complet de la chaîne sur laquelle la vidéo est téléchargée
  • channel_id (chaîne): Id de la chaîne.
  • location (chaîne): Lieu physique où la vidéo a été filmée
  • duration (numérique): Durée de la vidéo en secondes
  • view_count (numérique): Nombre d'utilisateurs qui ont regardé la vidéo sur la plateforme
  • like_count (numérique): Nombre d'évaluations positives de la vidéo
  • dislike_count (numérique): Nombre d'évaluations négatives de la vidéo
  • repost_count (numérique): Nombre de reposts de la vidéo
  • average_rating (numérique): Note moyenne donnée par les utilisateurs, l'échelle utilisée dépend de la page web
  • comment_count (numérique): Nombre de commentaires sur la vidéo
  • age_limit (numérique): Restriction d'âge pour la vidéo (années)
  • is_live (boolean): Si cette vidéo est un flux en direct ou une vidéo de longueur fixe
  • start_time (numérique): Temps en secondes où la copie doit commencer, comme spécifié dans l'URL
  • end_time (numérique): Temps en secondes où la copie doit se terminer, comme spécifié dans l'URL
  • format (chaîne): Une description du format lisible par l'homme
  • format_id (chaîne): Code de format spécifié par --format
  • format_note (chaîne): Informations complémentaires sur le format
  • width (numérique): Largeur de la vidéo
  • height (numérique): Hauteur de la vidéo
  • resolution (chaîne): Description textuelle de la largeur et de la hauteur
  • tbr (numérique): Débit binaire moyen de l'audio et de la vidéo en KBit/s
  • abr (numérique): Débit binaire audio moyen en KBit/s
  • acodec (chaîne): Nom du codec audio utilisé
  • asr (numérique): Taux d'échantillonnage audio en Hertz
  • vbr (numérique): Débit binaire vidéo moyen en KBit/s
  • fps (numérique): Fréquence d'images (Frame par seconde)
  • vcodec (chaîne): Nom du codec vidéo utilisé
  • container (chaîne): Nom du format du conteneur
  • filesize (numérique): Le nombre d'octets, s'il est connu à l'avance
  • filesize_approx (numérique): Une estimation du nombre d'octets
  • protocol (chaîne): Le protocole qui sera utilisé pour le téléchargement proprement dit
  • extractor (chaîne): Nom de l'extracteur
  • extractor_key (chaîne): Nom clé de l'extracteur
  • epoch (numérique): Unix epoch when creating the file
  • autonumber (numérique): Numéro à cinq chiffres qui sera augmenté à chaque téléchargement, en commençant par zéro
  • playlist (chaîne): Nom ou identifiant de la playlist qui contient la vidéo
  • playlist_index (numérique): Index de la vidéo dans la playlist, complété par des zéros de tête en fonction de la longueur totale de la playlist
  • playlist_id (chaîne): Identifiant de la playlist
  • playlist_title (chaîne): Titre de la playlist
  • playlist_uploader (chaîne): Nom complet de l'uploader de la playlist
  • playlist_uploader_id (chaîne): Pseudonyme ou identifiant de l'uploader de la playlist

Disponible pour la vidéo qui appartient à un chapitre ou à une section logique :

  • chapter (chaîne): Nom ou titre du chapitre auquel la vidéo appartient.
  • chapter_number (numérique): Numéro du chapitre auquel la vidéo appartient.
  • chapter_id (chaîne): Id du chapitre auquel la vidéo appartient.

Disponible pour la vidéo qui est un épisode d'une série ou d'un programme :

  • series (chaîne): Titre de la série ou du programme auquel l'épisode vidéo appartient
  • season (chaîne): Titre de la saison à laquelle l'épisode vidéo appartient.
  • season_number (numérique): Numéro de la saison à laquelle l'épisode vidéo appartient.
  • season_id (chaîne): Id de la saison à laquelle l'épisode vidéo appartient.
  • episode (chaîne): Titre de l'épisode vidéo.
  • episode_number (numérique): Numéro de l'épisode vidéo dans la saison.
  • episode_id (chaîne): Id de l'épisode vidéo.

Disponible pour le média qui est une piste ou une partie d'un album de musique :

  • track (chaîne): Titre de la piste.
  • track_number (numérique): Numéro de la piste dans un album ou un disque.
  • track_id (chaîne): Id de la piste.
  • artist (chaîne): Artiste(s) de la piste.
  • genre (chaîne): Genre(s) de la piste.
  • album (chaîne): Titre de l'album auquel appartient la piste.
  • album_type (chaîne): Type de l'album
  • album_artist (chaîne): Liste de tous les artistes figurant sur l'album.
  • disc_number (numérique): Numéro du disque ou autre support physique auquel la piste appartient
  • release_year (numérique): Année (YYYY) de sortie de l'album


Chaque séquence susmentionnée, lorsqu'elle est référencée dans un modèle de sortie, sera remplacée par la valeur réelle correspondant au nom de la séquence. Notez que la présence de certaines des séquences n'est pas garantie, car elles dépendent des métadonnées obtenues par un extracteur particulier. Ces séquences seront remplacées par "NA".

Par exemple pour -o %(title)s-%(id)s.%(ext)s et une vidéo mp4 avec le titre youtube-dl test video et l'id BaW_jenozKcj, cela résultera en un fichier youtube-dl test video-BaW_jenozKcj.mp4 créé dans le répertoire courant.

Pour les séquences numériques, vous pouvez utiliser un formatage en rapport avec les chiffres, par exemple, %(view_count)05d donnera une chaîne de caractères avec un compte de vues rempli de zéros jusqu'à 5 caractères, comme dans 00042.

Les modèles de sortie peuvent également contenir un chemin hiérarchique arbitraire, par exemple -o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' qui aura pour résultat de télécharger chaque vidéo dans un répertoire correspondant à ce modèle de chemin. Tout répertoire manquant sera automatiquement créé pour vous.

Pour utiliser des pourcentages littéraux dans un modèle de sortie, utilisez "%%". Pour sortir sur stdout, utilisez -o -.

Le modèle par défaut actuel est %(title)s-%(id)s.%(ext)s.

Dans certains cas, vous ne voulez pas de caractères spéciaux tels que 中, espaces, ou &, comme par exemple lors du transfert du nom de fichier téléchargé vers un système Windows ou le nom de fichier par un canal non sécurisé 8bit. Dans ces cas, ajoutez le drapeau -restrict-filenames pour obtenir un titre plus court :

Modèle de sortie et fichiers batch Windows

Si vous utilisez un modèle de sortie dans un fichier batch Windows, vous devez alors échapper les caractères en pourcentage (%) en les doublant, de sorte que -o "%(title)s-%(id)s.%(ext)s" devienne -o "%%(title)s-%%(id)s.%%(ext)s". Cependant, vous ne devez pas toucher aux "%" qui ne sont pas des caractères simples, par exemple les variables d'environnement pour l'expansion doivent rester intactes : -o "C:\%HOMEPATH%\Desktop\%%(title)s.%%(ext)s".

Exemples de modèles de sortie

Notez que sur Windows, vous devrez peut-être utiliser des guillemets doubles au lieu de guillemets simples.

$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc
youtube-dl test video _ä↭𝕐.mp4    # Toutes sortes de personnages bizarres
$ youtube-dl --get-filename -o '%(title)s.%(ext)s' BaW_jenozKc --restrict-filenames
youtube-dl_test_video_.mp4          # Un simple nom de fichier
# Télécharger les vidéos de la playlist de YouTube dans un répertoire séparé indexé par ordre des vidéos dans une playlist
$ youtube-dl -o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re
# Téléchargez toutes les listes de lecture de la chaîne/utilisateur YouTube en gardant chaque playlist dans un répertoire séparé :
$ youtube-dl -o '%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://www.youtube.com/user/TheLinuxFoundation/playlists
# Téléchargez le cours Udemy en gardant chaque chapitre dans un répertoire séparé sous le répertoire MyVideos de votre domicile
$ youtube-dl -u user -p password -o '~/MyVideos/%(playlist)s/%(chapter_number)s - %(chapter)s/%(title)s.%(ext)s' https://www.udemy.com/java-tutorial/
# Télécharger la saison entière de la série en gardant chaque série et chaque saison dans un répertoire séparé sous C:/MyVideos
$ youtube-dl -o "C:/MyVideos/%(series)s/%(season_number)s - %(season)s/%(episode_number)s - %(episode)s.%(ext)s" https://videomore.ru/kino_v_detalayah/5_sezon/367617
# Diffuser la vidéo en cours de téléchargement sur stdout
$ youtube-dl -o - BaW_jenozKc


SÉLECTION DU FORMAT

Par défaut, youtube-dl essaie de télécharger la meilleure qualité disponible, c'est-à-dire que si vous voulez la meilleure qualité, vous n'avez pas besoin de passer par des options spéciales, youtube-dl la devinera pour vous par par défaut.

Mais parfois, vous voudrez télécharger dans un format différent, par exemple lorsque vous êtes sur une connexion lente ou intermittente. Le mécanisme clé pour y parvenir est ce que l'on appelle la sélection de format, qui vous permet de spécifier explicitement le format souhaité, de sélectionner des formats en fonction d'un ou plusieurs critères, de définir des priorités et bien plus encore.

La syntaxe générale pour la sélection du format est --format FORMAT ou plus court -f FORMAT FORMAT est une expression de sélection, c'est-à-dire une expression qui décrit le ou les formats que vous souhaitez télécharger.

Voir des exemples.

Le cas le plus simple est de demander un format spécifique, par exemple avec "f 22" vous pouvez télécharger le format avec un code de format égal à 22. Vous pouvez obtenir la liste des codes de format disponibles pour une vidéo particulière en utilisant les formats "-liste" ou "-F". Notez que ces codes de format sont spécifiques à l'extracteur.

Vous pouvez également utiliser une extension de fichier (actuellement `3gp`, `aac`, `flv`, `m4a`, `mp3`, `mp4`, `ogg`, `wav`, `webm` sont supportés) pour télécharger la meilleure qualité de format pour une extension de fichier particulière dans un seul fichier, par exemple -f webm' téléchargera le format de meilleure qualité avec l'extension webm dans un seul fichier.

Vous pouvez également utiliser des noms spéciaux pour sélectionner des formats particuliers :

  • best: Sélectionne la meilleure qualité de format dans un seul fichier avec la vidéo et l'audio.
  • worst:Sélectionne la plus mauvaise qualité de format dans un seul fichier avec la vidéo et l'audio.
  • bestvideo: Sélectionne la meilleur qualité de format vidéo (par exemple, vidéo DASH). Peut ne pas être disponible.
  • worstvideo: Sélectionne la moins bonne qualité de format vidéo. Peut ne pas être disponible.
  • bestaudio: Sélectionne la meilleure qualité de format audio. Peut ne pas être disponible.
  • worstaudio: Sélectionne la moins bonne qualité de format audio. Peut ne pas être disponible.

Par exemple, pour télécharger la vidéo de la pire qualité, vous pouvez utiliser le format -f worstvideo.

Si vous souhaitez télécharger plusieurs vidéos et qu'elles n'ont pas les mêmes formats disponibles, vous pouvez spécifier l'ordre de préférence en utilisant des slashes.

La traduction n'est pas encore terminée pour avoir des informations complètes, veuillez vous référer à la version anglaise (voir sources).

COPYRIGHT

youtube-dl est mis dans le domaine public par les détenteurs de droits d'auteur.

Ce fichier README a été écrit à l'origine par Daniel Bolton et est également publié dans le domaine public.