Toutes les ressources

Outils · 7 min

yt-dlp, le repo à 183 000 étoiles qui télécharge n'importe quelle vidéo en ligne

Une seule commande, une URL, et la vidéo est sur ton disque. YouTube en 4K, un Reel Insta, un TikTok, un Twitch VOD, ou juste l'audio en MP3.

Ce qu’il y a dedans

  • C'est quoi exactement yt-dlp
  • Setup en 5 minutes
  • Mes 3 conseils
  • Les limites à garder en tête

Une seule commande, une URL, et la vidéo est sur ton disque. YouTube en 4K, un Reel Insta, un TikTok, un Twitch VOD, ou juste l'audio en MP3. C'est gratuit, c'est du domaine public, ça tourne en local, et ça marche sur 1 731 sites différents. Voici le setup complet, les 5 usages qui servent vraiment en business, et les limites que personne ne te dit.


C'est quoi exactement yt-dlp

Open source sur GitHub : github.com/yt-dlp/yt-dlp. C'est un projet communautaire né en 2020 comme fork de youtube-dl. Il est sous licence Unlicense, ce qui veut dire domaine public : tu peux l'utiliser, le modifier, l'intégrer dans un produit que tu vends, sans rien demander à personne.

Trois choses qu'il fait, et qui expliquent pourquoi tout le monde le pille :

  1. Il connaît 1 731 sites, pas juste YouTube.

Chaque site supporté a son propre « extracteur » maintenu par la communauté. La liste couvre YouTube, Instagram (posts, Reels, Stories), TikTok, Facebook (y compris les Reels et la bibliothèque publicitaire), X, Twitch (clips, VOD, streams), Vimeo, Dailymotion, Reddit, LinkedIn, Loom, plus des centaines de chaînes de télé nationales et de plateformes régionales. Tu colles l'URL, il devine tout seul quel extracteur utiliser.

  1. Il te laisse choisir exactement ce que tu récupères.

Pas « télécharger la vidéo » comme un bloc. Tu peux demander la meilleure qualité disponible, ou plafonner à 1080p pour économiser du disque, ou ne prendre que la piste audio et la convertir en MP3, ou récupérer les sous-titres automatiques dans un fichier à part. Sur une playlist ou une chaîne entière, c'est une seule commande.

  1. Il tourne entièrement chez toi.

Aucun serveur intermédiaire, aucun compte, aucune clé API, aucun crédit IA consommé. Le fichier passe de la plateforme à ton disque dur, sans détour. Pour un truc que tu vas peut-être lancer sur des vidéos internes ou des rushes clients, ça compte.


Setup en 5 minutes

Étape 1 | Installer yt-dlp

Sur Windows, dans PowerShell :

code
winget install yt-dlp.yt-dlp

Sur Mac, avec Homebrew :

code
brew install yt-dlp

Sans gestionnaire de paquets, en passant par Python (marche partout) :

code
python -m pip install -U "yt-dlp[default]"

Ferme ton terminal et rouvre-le après l'installation, sinon la commande ne sera pas encore reconnue.

Étape 2 | Installer ffmpeg

Sur Windows :

code
winget install Gyan.FFmpeg

Sur Mac :

code
brew install ffmpeg

Cette étape est celle que 90 % des gens sautent, et c'est celle qui explique la moitié des « ça marche pas » sur Reddit. Sans ffmpeg, yt-dlp télécharge quand même, mais il se rabat sur un format unique et tu récupères du 720p en pensant avoir demandé du 4K.

Étape 3 | Installer deno pour un support YouTube complet

Sur Windows :

code
winget install DenoLand.Deno

Sur Mac :

code
brew install deno

Tu peux sauter cette étape et y revenir seulement si YouTube te renvoie une erreur. Sur les autres plateformes (Insta, TikTok, Twitch), ça ne change rien.

Étape 4 | Vérifier que tout est en place

code
yt-dlp --version
ffmpeg -version

Si les deux répondent avec un numéro de version, tu es bon.

Étape 5 | Premier test

Prends l'URL d'une de tes propres vidéos et lance :

code
yt-dlp "https://ton-url-ici"

Le fichier atterrit dans le dossier où ton terminal est ouvert. Pour choisir où il va :

code
yt-dlp -P "C:\Users\toi\Downloads" "https://ton-url-ici"

Mes 3 conseils

  1. Avant de chercher pourquoi ça plante, mets à jour. Les plateformes changent leur code régulièrement, et ça casse les extracteurs. Le projet publie des correctifs en quelques jours, mais ta version locale, elle, reste figée. 8 fois sur 10, un « ça marchait la semaine dernière » se règle avec une mise à jour. La commande dépend de comment tu l'as installé : winget upgrade yt-dlp sur Windows, brew upgrade yt-dlp sur Mac, ou python -m pip install -U "yt-dlp[default]" si tu es passé par pip. Le yt-dlp -U que tu vois partout ne fonctionne que sur le binaire téléchargé à la main.
  2. La qualité par défaut n'est pas toujours la meilleure. yt-dlp choisit un compromis raisonnable, pas le maximum. Si tu veux du 1080p propre en MP4 lisible partout, sois explicite : -S "res:1080" --merge-output-format mp4. Et si tu veux vraiment le maximum disponible : -f "bestvideo+bestaudio/best". Sur du contenu que tu vas remonter, la différence se voit immédiatement.
  3. Sur une chaîne entière, mets un frein. Lancer un téléchargement de 300 vidéos à pleine vitesse, c'est le meilleur moyen de te faire couper. Ajoute --limit-rate 2M (2 Mo par seconde) et --sleep-interval 5 (5 secondes entre deux vidéos). Ça prend plus longtemps, ça finit sans se faire bloquer.

Les limites à garder en tête

  1. C'est une ligne de commande, pas une application. Il n'y a pas de fenêtre, pas de bouton, pas de barre de progression jolie. Si l'idée d'ouvrir un terminal te bloque, l'outil ne te servira pas, même installé. La bonne nouvelle c'est que 90 % des usages tiennent dans une seule commande que tu copies-colles en changeant l'URL.
  2. Ça casse, et ça se répare. Certains extracteurs sont marqués « currently broken » dans la doc officielle à un moment donné (les profils utilisateur Instagram, par exemple, ont été cassés à plusieurs reprises). C'est le prix d'un projet communautaire qui court derrière des plateformes qui ne veulent pas être scrapées. Ce n'est jamais définitif, mais tu peux tomber sur une semaine où le site que tu visais ne passe pas.
  3. YouTube durcit le jeu en continu. Limitation de débit, vérifications côté navigateur, obligation d'un runtime JavaScript pour certaines vidéos. Ça reste la plateforme la mieux supportée, mais c'est aussi celle où tu croiseras le plus d'erreurs techniques, et celle où tu auras le plus besoin de mettre à jour souvent.
  4. Le cadre légal n'est pas un détail, et personne ne te le dit. Trois choses à séparer clairement.

D'abord les conditions d'utilisation. YouTube et Instagram interdisent contractuellement le téléchargement en dehors des fonctions qu'ils fournissent eux-mêmes. Ce n'est pas du pénal, c'est du contrat. Concrètement, le risque se matérialise surtout quand tu utilises tes propres cookies de session (l'usage n°4) : là tu es identifiable, et une suspension de compte est possible. Si tu tiens à un compte, utilise un compte secondaire pour ça.

Ensuite le droit d'auteur. En France, l'exception de copie privée autorise la copie pour ton usage strictement personnel depuis une source licite. Elle ne couvre ni la rediffusion, ni la monétisation, ni le partage à ton audience ou à ton équipe. Télécharger la vidéo d'un concurrent pour l'analyser dans ton coin et télécharger la même vidéo pour la reposter, ce sont deux situations juridiquement très différentes.

Enfin le risque plateforme sur le repost. Instagram réduit activement la distribution des contenus repostés sans apport propre, filigrane d'une autre plateforme inclus. Donc même en mettant le droit de côté, reposter la vidéo de quelqu'un d'autre est un mauvais calcul pour ton compte.

La ligne simple et sûre : télécharge ce qui est à toi, ce que tu as le droit d'utiliser, et ce que tu analyses en interne. Ne republie pas le travail des autres. Ceci n'est pas un avis juridique, et si l'enjeu est sérieux, fais valider ton cas.


Le mot de la fin

Tous les sites de téléchargement pleins de pub, toutes les extensions louches, toutes les applis à 29 € : ils font tourner ce programme et te revendent le résultat dégradé. Installer yt-dlp directement, c'est enlever l'intermédiaire.

Mais l'intérêt réel n'est pas là. Il est dans le fait qu'une vidéo devienne un fichier sur ton disque. Un fichier, tu peux le découper, le transcrire, le donner à analyser, le remonter. Une vidéo dans une app, tu peux juste la regarder. C'est ça que tu débloques.

Installe-le ce soir avec les deux commandes de l'étape 1 et 2. Prends l'URL de ton dernier Reel, lance yt-dlp "URL". Tu auras le fichier avant d'avoir fini de lire cette phrase.

S’inscrire à la newsletter

Pas le temps de tout monter toi-même ?

Je structure ta boîte : systèmes, process et un OS qui fait tourner l’opérationnel sans que tout repasse par toi. On commence par un diagnostic de 45 minutes : on regarde comment ta boîte tourne, ce qui te coûte le plus, et tu repars avec un récap écrit.

ou écris-moi :@capitain.aimaxence@corelabs.studio