CH01 / Outils open source

yt-dlp : le guide pratique complet

Mis à jour le Rédaction Video Downloader Info10 segments~5 min

L'essentiel

  1. yt-dlp est un logiciel libre en ligne de commande qui télécharge l'audio et la vidéo de milliers de sites ; il est placé dans le domaine public par la licence Unlicense.
  2. Il s'exécute en local sous Windows, macOS et Linux : vos liens ne transitent jamais par un site convertisseur tiers.
  3. yt-dlp a besoin de FFmpeg pour fusionner les flux audio et vidéo séparés, mode de diffusion habituel de la haute définition.
  4. Trois options font l'essentiel du travail : -f (quel format), -S (comment classer les formats) et -o (comment nommer le fichier).
  5. yt-dlp ne contourne pas les DRM : il sert pour vos propres contenus, les contenus sous licence libre ou ceux que vous avez l'autorisation de conserver.
Fenêtre de terminal, l'interface dans laquelle s'exécute yt-dlp
Image: Kitty-terminal-emulator-rendering-image,Vitaly Zdanevich,CC BY-SA 4.0,via Wikimedia Commons.

yt-dlp est l’outil open source de référence pour enregistrer une vidéo en ligne sur votre propre disque. Vous lui donnez l’adresse d’une page, il repère les flux multimédias derrière le lecteur, télécharge les meilleurs et, avec FFmpeg, assemble un fichier unique et lisible. C’est un programme en ligne de commande, ce qui peut intimider, mais cinq ou six options suffisent pour la quasi-totalité des usages. Ce guide les présente dans l’ordre où vous en aurez besoin.

Avant d’aller plus loin : yt-dlp est un outil, pas une autorisation. Utilisez-le pour vos propres publications, pour des œuvres du domaine public ou sous licence Creative Commons, ou pour des contenus que vous avez explicitement le droit de conserver. Notre page télécharger une vidéo est-il légal ? détaille les règles, notamment l’exception de copie privée du droit français.

Qu’est-ce que yt-dlp et pourquoi les professionnels l’utilisent-ils ?

yt-dlp est un fork de l’ancien projet youtube-dl, maintenu sur GitHub par une communauté de bénévoles et publié sous Unlicense, une licence qui place le code dans le domaine public. Sa liste de sites pris en charge compte bien plus d’un millier d’extracteurs : grandes plateformes, chaînes de télévision, archives de musées, sites de conférences.

Archivistes, chercheurs OSINT et journalistes de données le préfèrent pour trois raisons :

  • Il tourne en local. Rien ne passe par un serveur tiers, contrairement aux sites « convertisseurs » (voir les risques des sites de téléchargement en ligne).
  • Il est scriptable. La même commande traite une vidéo ou une liste de dix mille, avec un fichier d’archive qui ignore ce que vous avez déjà.
  • Il est transparent. Chaque option est documentée dans le README et le code peut être audité.

Comment installer yt-dlp sans risque ?

Récupérez toujours yt-dlp par un canal officiel cité dans le wiki d’installation du projet :

Système Méthode recommandée Mise à jour
Windows winget install yt-dlp ou l’exécutable yt-dlp.exe des versions GitHub winget upgrade yt-dlp ou yt-dlp -U
macOS brew install yt-dlp brew upgrade yt-dlp
Linux pip install -U "yt-dlp[default]" dans un environnement virtuel, ou le paquet de la distribution pip install -U "yt-dlp[default]"

Installez ensuite FFmpeg, que yt-dlp appelle pour fusionner et convertir les flux. Sous Windows, les compilations distribuées via winget conviennent (par exemple winget install Gyan.FFmpeg) ; sous macOS, brew install ffmpeg ; sous Linux, le gestionnaire de paquets. Vérifiez que les deux répondent :

yt-dlp --version
ffmpeg -version

Les sites modifient souvent leurs lecteurs et yt-dlp publie des correctifs très régulièrement. La plupart des pannes du type « ça marchait hier » disparaissent après une mise à jour. Les versions récentes peuvent aussi exiger un moteur JavaScript externe pour certains sites : le README indique les prérequis du moment, consultez-le plutôt que de vieux tutoriels.

Comment voir les formats disponibles ?

L’option -F (F majuscule) liste tous les formats proposés, sans rien télécharger :

yt-dlp -F "https://example.org/watch/ma-conference"

Vous obtenez un tableau avec un identifiant de format, l’extension, la résolution, les codecs et le débit. Les lignes marquées video only ou audio only sont des flux séparés qu’il faudra fusionner. C’est normal avec le streaming adaptatif comme HLS ou MPEG-DASH.

Comment choisir la qualité avec -f et -S ?

-f sélectionne des formats ; -S les classe. Le comportement par défaut prend déjà la meilleure vidéo et le meilleur audio : ces options ne servent que si vous avez une contrainte.

# Meilleure vidéo jusqu'à 1080p + meilleur audio, sinon meilleur fichier combiné
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL

# Même idée par tri : viser 1080p, puis des codecs compatibles MP4
yt-dlp -S "res:1080,ext:mp4:m4a" URL
  • bv* désigne la meilleure vidéo (avec ou sans son), ba le meilleur audio, b le meilleur fichier combiné.
  • La barre / est un repli : si la première expression ne trouve rien, la suivante est essayée.
  • -S "res:1080" signifie « préférer la résolution la plus proche de 1080 sans la dépasser ». ext:mp4:m4a favorise une vidéo MP4 avec un son M4A, lisible partout, y compris sur les vieux téléviseurs.

Le tri -S est généralement plus robuste que les filtres stricts de -f, car il se dégrade proprement quand le format exact n’existe pas. Pour choisir un codec, lisez notre comparatif AV1, VP9, H.264 et HEVC.

Comment nommer et ranger les fichiers ?

Le modèle de sortie -o utilise des champs au format %(...)s :

yt-dlp -o "%(uploader)s/%(upload_date)s - %(title)s [%(id)s].%(ext)s" URL

Inclure [%(id)s] est une bonne habitude : les titres changent et se ressemblent, les identifiants non. Ajoutez --restrict-filenames si les fichiers doivent circuler vers des systèmes qui n’aiment ni les espaces ni les accents, et --windows-filenames si vous enregistrez depuis Linux sur un disque Windows ou exFAT.

Comment récupérer sous-titres, métadonnées et miniatures ?

yt-dlp --write-subs --write-auto-subs --sub-langs "fr,en" --embed-subs \
       --embed-metadata --embed-thumbnail URL
  • --write-subs récupère les sous-titres fournis par l’auteur ; --write-auto-subs ajoute les sous-titres générés automatiquement quand ils existent.
  • --embed-subs les intègre au fichier (MKV et MP4 le permettent) pour qu’ils ne se perdent pas.
  • --embed-metadata inscrit titre, date et description dans le conteneur.

Les formats SRT et WebVTT sont détaillés dans notre guide des sous-titres.

Comment extraire uniquement l’audio ?

yt-dlp -x --audio-format best URL

-x extrait l’audio. --audio-format best conserve le codec d’origine sans réencodage, donc sans perte. Forcer mp3 réencode et dégrade un peu la qualité à chaque passage : lisez Opus, AAC ou MP3 avant de choisir.

Comment archiver une chaîne ou une playlist sans doublons ?

yt-dlp --download-archive archive.txt \
       -o "%(playlist_index)03d - %(title)s [%(id)s].%(ext)s" \
       --sleep-interval 5 --max-sleep-interval 15 URL_PLAYLIST

--download-archive note l’identifiant de chaque vidéo terminée dans archive.txt ; la fois suivante, elles sont ignorées. Une sauvegarde nocturne de votre propre chaîne devient ainsi légère et relançable à volonté. Les options de pause espacent les requêtes : c’est courtois envers le serveur et limite le risque de bridage.

Comment enregistrer ses réglages dans un fichier de configuration ?

Plutôt que de retaper les options, placez-les dans un fichier de configuration, une option par ligne. yt-dlp lit notamment %APPDATA%\yt-dlp\config.txt sous Windows et ~/.config/yt-dlp/config sous Linux et macOS :

-o %(uploader)s/%(title)s [%(id)s].%(ext)s
-S res:1080,ext:mp4:m4a
--embed-metadata
--embed-subs
--sub-langs fr.*,en.*

--ignore-config permet de lancer une commande ponctuelle sans ce fichier.

Quelles sont les limites de yt-dlp ?

  • Flux protégés par DRM (Widevine, FairPlay, PlayReady) : ils ne sont pas téléchargeables sous forme exploitable, et contourner une mesure technique de protection est interdit en France (article L335-3-1 du Code de la propriété intellectuelle). Notre page DRM et Widevine explique pourquoi.
  • Comptes et cookies. --cookies-from-browser permet à yt-dlp de réutiliser votre session pour des contenus auxquels vous avez accès, comme vos propres vidéos privées. Ne partagez jamais le fichier de cookies exporté : il vaut votre mot de passe.
  • Évolution des sites. Les extracteurs cassent quand les sites changent ; la mise à jour règle la plupart des cas.
  • Conditions d’utilisation. Certaines plateformes interdisent le téléchargement dans leurs conditions, même quand le droit d’auteur le permettrait. Lisez-les pour le service concerné.

Si vous préférez cliquer plutôt que taper, les interfaces graphiques pour yt-dlp enveloppent le même moteur dans une fenêtre.

Outils open source de ce guide

OutilLicence
yt-dlpUnlicense (domaine public)
FFmpegLGPL 2.1+ (certaines compilations GPL)

Questions fréquentes

yt-dlp est-il sûr ?

Le projet officiel est open source et publié sur GitHub (github.com/yt-dlp/yt-dlp). Téléchargez-le uniquement depuis ce dépôt, depuis PyPI ou via le gestionnaire de paquets de votre système. Les copies proposées sur des portails de téléchargement peuvent être reconditionnées avec des logiciels malveillants.

Pourquoi yt-dlp télécharge-t-il l'audio et la vidéo en deux fichiers ?

Beaucoup de sites stockent la vidéo haute définition et l'audio dans des flux séparés. yt-dlp télécharge les deux et demande à FFmpeg de les fusionner. Sans FFmpeg, vous obtenez deux fichiers ou un format combiné de moindre qualité.

Comment mettre à jour yt-dlp ?

Avec l'exécutable autonome, lancez yt-dlp -U. Avec pip, lancez pip install -U yt-dlp. Si vous êtes passé par winget, Homebrew ou votre distribution Linux, mettez à jour via ce même gestionnaire pour qu'il garde la trace de la version installée.

yt-dlp est-il légal en France ?

Le logiciel est légal et utilisé par des archivistes, des chercheurs et des journalistes. Ce qui peut être illicite, c'est le contenu téléchargé : une œuvre protégée sans autorisation, une source illicite, ou un service dont les conditions interdisent le téléchargement. Notre guide sur la légalité du téléchargement détaille la copie privée.

Quelle différence entre yt-dlp et youtube-dl ?

yt-dlp est né comme fork de youtube-dl. Il ajoute notamment le tri des formats avec -S, l'intégration SponsorBlock, une meilleure gestion des playlists et des mises à jour bien plus fréquentes. La plupart des options de youtube-dl fonctionnent encore, mais les comportements par défaut diffèrent.

Sources et données ouvertes

  1. README et référence des options de yt-dlp · Projet yt-dlp (GitHub)
  2. Wiki d'installation de yt-dlp · Projet yt-dlp
  3. Liste des sites pris en charge · Projet yt-dlp
  4. The Unlicense · unlicense.org
  5. Code de la propriété intellectuelle (art. L122-5 copie privée, art. L335-3-1 mesures techniques) · Légifrance