Qu'est-ce que yt-dlp ?
yt-dlp est un téléchargeur audio et vidéo en ligne de commande qui prend en charge bien plus d'un millier de sites. Né d'un fork de youtube-dl (en passant par youtube-dlc, désormais inactif), c'est aujourd'hui le projet réellement maintenu des deux, avec un sélecteur de formats bien plus riche, l'intégration de SponsorBlock, la prise en charge native de l'incorporation des sous-titres, des chapitres et des métadonnées, et un système de plugins pour vos propres extracteurs.
⚡ Fonctionnalités clés de yt-dlp
🌐 Des milliers de sites
Plus de 1 700 extracteurs couvrant plateformes vidéo, diffuseurs, hébergeurs de podcasts et sites d'actualité, plus un extracteur générique qui trouve les médias sur les pages pour lesquelles personne n'a écrit d'extracteur.
🎚️ Sélection fine des formats
-f et -S offrent un véritable langage d'expressions sur la résolution, le codec, le débit et le conteneur : vous demandez exactement le flux voulu au lieu de celui par défaut.
🎧 Extraction audio
-x --audio-format mp3 extrait la piste audio et la réencode ; avec --embed-thumbnail et --embed-metadata, vous obtenez des fichiers étiquetés que tous les lecteurs comprennent.
💬 Sous-titres et chapitres
Téléchargez ou incorporez les sous-titres dans toutes les langues disponibles, conservez les sous-titres automatiques et écrivez les marqueurs de chapitre directement dans le fichier — ou découpez dessus.
⏭️ SponsorBlock
Marquez ou supprimez les segments sponsorisés, les intros et l'autopromotion dès le téléchargement grâce à la base SponsorBlock, sans repasser par un logiciel de montage.
🍪 Cookies et sessions
--cookies-from-browser lit une session connectée directement dans Firefox ou Chromium, pour que les contenus privés, soumis à une limite d'âge ou réservés aux membres fonctionnent.
apt upgrade vous maintient à jour.
📦 Installation depuis deb.griffo.io
Étape 1 : ajouter le dépôt
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updateÉtape 2 : installer yt-dlp
# Installer le dernier yt-dlp
sudo apt install yt-dlp
# Vérifier l'installation
yt-dlp --version# Installer le dernier yt-dlp
apt install yt-dlp
# Vérifier l'installation
yt-dlp --versionÉtape 3 : installer ffmpeg (vivement recommandé)
# yt-dlp a besoin de ffmpeg pour fusionner les flux vidéo et audio séparés,
# extraire l'audio et incorporer sous-titres ou miniatures
sudo apt install ffmpeg
# Les complétions bash, zsh et fish sont fournies avec le paquet —
# rien à configurer. Ouvrez un nouveau shell et appuyez sur Tab :
yt-dlp --embed-<Tab>
# La page de manuel est installée elle aussi
man yt-dlp# yt-dlp a besoin de ffmpeg pour fusionner les flux vidéo et audio séparés,
# extraire l'audio et incorporer sous-titres ou miniatures
apt install ffmpeg
# Les complétions bash, zsh et fish sont fournies avec le paquet —
# rien à configurer. Ouvrez un nouveau shell et appuyez sur Tab :
yt-dlp --embed-<Tab>
# La page de manuel est installée elle aussi
man yt-dlp🎯 Exemples d'utilisation de base
Téléchargements au quotidien :
# Télécharger une vidéo dans la meilleure qualité disponible
yt-dlp 'https://example.com/watch?v=...'
# Le meilleur MP4 jusqu'à 1080p
yt-dlp -S 'res:1080,ext:mp4' 'URL'
# Audio seul, en MP3 étiqueté
yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata 'URL'
# Voir tous les formats proposés avant de choisir
yt-dlp -F 'URL'Sous-titres, chapitres et sponsors :
# Incorporer les sous-titres anglais, y compris automatiques
yt-dlp --embed-subs --sub-langs en --write-auto-subs 'URL'
# Écrire les marqueurs de chapitre dans le fichier
yt-dlp --embed-chapters 'URL'
# Supprimer segments sponsorisés et intros dès le téléchargement
yt-dlp --sponsorblock-remove sponsor,intro 'URL'
# Récupérer une seule section plutôt que toute la vidéo
yt-dlp --download-sections '*00:01:30-00:04:00' 'URL'Playlists, archives et automatisation :
# Toute une playlist, dans des dossiers rangés par auteur
yt-dlp -o '%(uploader)s/%(title)s.%(ext)s' 'PLAYLIST_URL'
# Suivre une chaîne sans retélécharger l'existant
yt-dlp --download-archive seen.txt 'CHANNEL_URL'
# Contenu privé ou soumis à une limite d'âge, via une session du navigateur
yt-dlp --cookies-from-browser firefox 'URL'
# Téléchargements plus rapides via aria2c
yt-dlp --downloader aria2c --downloader-args aria2c:'-x 8 -s 8' 'URL'🔧 Intégrations avec d'autres outils
yt-dlp est le moteur de téléchargement qu'attendent beaucoup d'autres logiciels :
- ffmpeg : fusion, remux, extraction audio et incorporation passent par lui
- mpv : lit une URL directement en la confiant à yt-dlp à la volée
- aria2 : téléchargeur externe optionnel pour des transferts parallèles et segmentés
- Serveurs multimédias : les bibliothèques Jellyfin, Kodi et Navidrome sont souvent remplies via les modèles de sortie de yt-dlp
- Fichiers de configuration : placez vos options habituelles dans
~/.config/yt-dlp/configet cessez de les retaper
🚀 Pourquoi choisir deb.griffo.io ?
- Debian officiel: disponible, mais figé à la version livrée avec la release, avec des mois de correctifs d'extracteurs de retard
- pip / pipx: à jour, mais hors d'apt, et la PEP 668 rend un
pip installsystème peu commode sur Debian - deb.griffo.io: dernière version avec mises à jour automatiques
- ✅ Des extracteurs qui fonctionnent: la version la plus récente, celle qui fait que les téléchargements aboutissent
- ✅ Aucune installation manuelle: pas de pip, pas de virtualenv, pas d'auto-mise à jour écrivant dans
/usr/local/bin - ✅ Mises à jour automatiques: paquets mis à jour dans les heures qui suivent chaque version upstream
- ✅ Paquet complet: la version officielle upstream, la page de manuel
yt-dlp.1et les complétions bash, zsh et fish - ✅ Toutes les architectures: livré en
Architecture: all, donc amd64, arm64, armhf, riscv64 et les autres installent le même paquet - ✅ Multi-distribution: fonctionne sur Bookworm, Trixie, Forky et Sid
- ✅ Maintenance facile: mises à jour avec les commandes apt habituelles
📦 Dépôt de construction du paquet
Les paquets Debian sont construits et maintenus automatiquement dans ce dépôt GitHub :
- 📺 yt-dlp-debian - Constructions des dernières versions
🔗 Paquets associés
Également disponibles sur deb.griffo.io :
- termusic - Lecteur de musique en terminal pour tout ce que vous téléchargez
- lowfi - Lecteur radio lofi minimaliste
- viu - Afficher miniatures et images dans le terminal
- Yazi - Gestionnaire de fichiers en terminal pour parcourir votre collection