Sommaire11 parties
yt-dlp est un téléchargeur audio et vidéo en ligne de commande, écrit en Python et compatible avec des milliers de sites. C’est un fork de youtube-dl, lui-même basé sur youtube-dlc, un projet aujourd’hui inactif. Cet article passe en revue l’installation, les canaux de mise à jour et les dépendances à prévoir pour qu’il fonctionne bien.
En bref
- Téléchargeur audio et vidéo en ligne de commande, compatible avec des milliers de sites
- Fork de youtube-dl, basé sur youtube-dlc qui n’est plus actif
- Binaires pour Windows, macOS et Linux, ou installation avec pip
- ffmpeg est fortement recommandé, avec un moteur JavaScript pour YouTube
- Licence Unlicense, avec des réserves sur certains binaires
Qu’est-ce que yt-dlp ?
yt-dlp se décrit comme un téléchargeur audio et vidéo en ligne de commande riche en fonctions. Il se pilote depuis un terminal et prend en charge des milliers de sites, dont la liste est tenue dans le dépôt du projet.
Il est né comme fork de youtube-dl, en s’appuyant sur youtube-dlc, désormais inactif. Pour qui cherche une alternative à youtube-dl, c’est donc l’un de ses héritiers directs. Le dépôt a été créé le 26 octobre 2020 et le code est en Python à 100 %.
Ce que yt-dlp sait faire
Le README organise ses options par thèmes, ce qui donne une idée de l’étendue des réglages. Il serait trop long de tout détailler ici : la documentation complète reste la référence.
Parmi les familles d’options citées, on trouve notamment :
- la sélection, le filtrage et le tri des formats disponibles
- les sous-titres et les miniatures
- SponsorBlock, pour traiter certains segments des vidéos
- le post-traitement après téléchargement
- l’authentification, les réglages réseau et la gestion des restrictions géographiques
- un modèle de nom de fichier, la modification des métadonnées, les extensions (plugins) et l’intégration dans un programme Python
Installer yt-dlp
Trois voies existent : les binaires publiés avec chaque version, pip, ou un gestionnaire de paquets tiers. Le README recommande le binaire yt-dlp.exe pour Windows (Win8 et plus), yt-dlp_macos pour macOS (10.15 et plus), et le fichier yt-dlp pour Linux et BSD, ce dernier nécessitant Python.
D’autres variantes existent pour Linux (x86_64, aarch64, armv7l, musl) et pour Windows (x86 et ARM64). Les instructions détaillées se trouvent dans le wiki du projet.
Python 3.10 et plus (CPython), ou 3.11 et plus (PyPy), sont pris en charge. Les notes de la version du 4 juillet 2026 indiquent que la version de Python minimale recommandée passe à 3.11, car la 3.10 arrive en fin de vie en octobre 2026 et son support sera bientôt abandonné.
Mettre à jour yt-dlp et choisir son canal
Avec les binaires officiels, yt-dlp -U met l’outil à jour. Avec pip, il suffit de relancer la commande d’installation. Le README prévient aussi qu’une version de plus de 90 jours déclenche un avertissement, que l’on peut masquer avec --no-update.
Trois canaux existent : stable (par défaut, publié à un rythme à peu près mensuel), nightly et master. Le projet précise que la version stable peut être périmée et cassée par des changements côté sites. Il recommande nightly aux utilisateurs réguliers, et demande de l’essayer avant tout rapport de bug.
Voici les commandes données par le README pour passer à nightly :
# To update to nightly from stable executable/binary:
yt-dlp --update-to nightly
# To install nightly with pip:
python -m pip install -U --pre "yt-dlp[default]"Les dépendances à connaître pour yt-dlp
Toutes les dépendances sont facultatives, mais ffmpeg, ffprobe, yt-dlp-ejs et un moteur JavaScript pris en charge sont « fortement recommandés ». ffmpeg sert à fusionner des fichiers vidéo et audio séparés et à plusieurs tâches de post-traitement. Il faut le programme lui-même, pas le paquet Python du même nom.
Pour un support complet de YouTube, il faut yt-dlp-ejs et un moteur JavaScript : deno (recommandé), node.js, bun ou QuickJS. Les notes du 9 juin 2026 relèvent les versions minimales : Deno 2.3.0, Node 22 et plus, et un support de Bun déprécié, limité aux versions 1.2.11 à 1.3.14.
D’autres modules ajoutent des fonctions : curl_cffi pour imiter un navigateur sur les sites qui contrôlent l’empreinte TLS, mutagen pour intégrer les miniatures, websockets ou pycryptodomex pour certains flux.
Où en est le projet
Au 17 octobre 2026, le dépôt compte 198 774 étoiles, 17 336 forks, 1 759 contributeurs et 2 713 tickets et demandes de fusion ouverts. Le code a été modifié pour la dernière fois le 10 octobre 2026, et la dernière version publiée est la 2026.08.19, parue le 19 août 2026.
Les notes de version récentes touchent aussi à la sécurité. Celle du 9 juin 2026 restreint --exec aux conversions sûres : la plupart des utilisateurs peuvent remplacer %(...)s par %(...)q. Celle du 4 juillet 2026 corrige une faille liée à --write-link (CVE-2026-55404) et annonce que les binaires Windows officiels exigeront bientôt Windows 10 ou plus.
Licence de yt-dlp
Le code de yt-dlp est sous licence Unlicense. Le dépôt git et les paquets PyPI ne contiennent que du code sous cette licence.
Certains fichiers de version embarquent d’autres composants : les exécutables empaquetés avec PyInstaller incluent du code GPLv3+, si bien que l’ensemble relève de la GPLv3+. Le détail figure dans le fichier THIRD_PARTY_LICENSES.txt du projet.
Quelques repères
- Fork : Un fork est une copie d’un projet logiciel qui évolue ensuite de son côté, avec ses propres modifications et sa propre équipe.
- Ligne de commande : C’est une façon d’utiliser un programme en tapant des instructions écrites dans un terminal, plutôt qu’en cliquant dans une fenêtre.
- Post-traitement : Ce sont les opérations appliquées à un fichier une fois téléchargé, par exemple le convertir, l’assembler avec un autre ou y ajouter des informations.
Questions fréquentes
yt-dlp est-il une alternative à youtube-dl ?
Oui, yt-dlp est un fork de youtube-dl. Il est basé sur youtube-dlc, un projet désormais inactif.
Comment installer yt-dlp sur Windows, macOS ou Linux ?
Tu peux télécharger un binaire publié avec chaque version (yt-dlp.exe pour Windows, yt-dlp_macos pour macOS, yt-dlp pour Linux et BSD), utiliser pip ou passer par un gestionnaire de paquets tiers. Le wiki du projet détaille chaque cas.
yt-dlp permet-il de récupérer les sous-titres et les miniatures d’une vidéo ?
Oui, le README de yt-dlp consacre des familles d’options aux sous-titres et aux miniatures. Il ne détaille pas ces options dans l’extrait de documentation consulté ici : la liste complète se trouve dans le README du projet.
Faut-il installer ffmpeg pour utiliser yt-dlp ?
C’est fortement recommandé, sans être obligatoire. ffmpeg est requis pour fusionner des fichiers vidéo et audio séparés et pour plusieurs tâches de post-traitement.
À retenir
yt-dlp est un téléchargeur en ligne de commande publié sous licence Unlicense, qui prend en charge des milliers de sites. Pour de bons résultats, le projet recommande le canal nightly, ffmpeg, et pour YouTube yt-dlp-ejs avec un moteur JavaScript.
