# yt-dlp : télécharger audio et vidéo en ligne de commande > yt-dlp est un outil open source en ligne de commande pour télécharger audio, vidéo, sous-titres et miniatures depuis des milliers de sites. - Type : projet open source - Famille : Outils dev · Téléchargeur audio et vidéo - Habitat : Terminal · Python - Niveau : intermédiaire - Langage : Python - Licence : Unlicense - Étoiles GitHub : 198828 (relevé le 17 octobre 2026) - Source : https://github.com/yt-dlp/yt-dlp - Publié le : 17 octobre 2026 - Page : https://geekus.fr/projets/yt-dlp/ 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. Sources : - [yt-dlp](https://github.com/yt-dlp/yt-dlp) (README) - [GitHub](https://github.com/yt-dlp/yt-dlp/releases) (notes de version) Mots-clés : téléchargement, cli, python, vidéo, sponsorblock --- Fiche publiée par Geekus : https://geekus.fr/projets/yt-dlp/