video-download
Téléchargez des vidéos et de l'audio à partir d'URLs en utilisant yt-dlp directement. Aucun script wrapper nécessaire.
Prérequis
- yt-dlp :
brew install yt-dlpoupip install yt-dlp - ffmpeg :
brew install ffmpegouapt install ffmpeg(requis pour fusionner les flux vidéo+audio)
Mettez à jour yt-dlp régulièrement pour suivre les changements des sites : yt-dlp -U ou pip install -U yt-dlp.
Commandes
Télécharger la meilleure qualité
yt-dlp "URL" -o "%(title)s.%(ext)s" --merge-output-format mp4
Télécharger une résolution spécifique
# 720p
yt-dlp "URL" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4
# 1080p
yt-dlp "URL" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4
Audio uniquement
yt-dlp "URL" -x --audio-format mp3 --audio-quality 0
Télécharger les sous-titres
# Télécharger la vidéo avec les sous-titres anglais
yt-dlp "URL" --write-subs --sub-langs en --merge-output-format mp4
# Télécharger la vidéo avec plusieurs langues de sous-titres
yt-dlp "URL" --write-subs --sub-langs "en,es,fr" --merge-output-format mp4
# Télécharger uniquement les sous-titres (pas de vidéo)
yt-dlp "URL" --write-subs --sub-langs en --skip-download
Obtenir les métadonnées (sans téléchargement)
yt-dlp "URL" --dump-json --no-download
Lister les formats disponibles
yt-dlp "URL" -F
Spécifier un répertoire de sortie
yt-dlp "URL" -o "./downloads/%(title)s.%(ext)s" --merge-output-format mp4
Préréglages de qualité
| Qualité | Indicateur de format |
|---|---|
| Meilleure | -f "bestvideo+bestaudio/best" (par défaut) |
| 1080p | -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" |
| 720p | -f "bestvideo[height<=720]+bestaudio/best[height<=720]" |
| 480p | -f "bestvideo[height<=480]+bestaudio/best[height<=480]" |
| Pire | -f "worstvideo+worstaudio/worst" |
Variables de modèle de sortie
Variables courantes pour les modèles -o :
| Variable | Description |
|---|---|
%(title)s | Titre de la vidéo |
%(ext)s | Extension du fichier |
%(id)s | Identifiant de la vidéo |
%(uploader)s | Nom du créateur/chaîne |
%(upload_date)s | Date de publication (AAAAMMJJ) |
%(duration)s | Durée en secondes |
%(resolution)s | Résolution de la vidéo |
Conseils
- Utilisez toujours
--merge-output-format mp4pour éviter de vous retrouver avec des fichiers.webmou.mkv. - Utilisez
--no-downloadavec--dump-jsonpour les requêtes de métadonnées uniquement – aucun fichier écrit sur le disque. - Si un téléchargement échoue avec des erreurs HTTP, mettez d'abord à jour yt-dlp (
yt-dlp -U). - Utilisez
-f "bestvideo[height<=720]+bestaudio"pour économiser de la bande passante lorsque la résolution complète n'est pas nécessaire. - yt-dlp gère automatiquement la limitation de débit et les tentatives.
- La sortie
--dump-jsonincluttitle,duration,uploader,view_count,description,formats,subtitles, et bien plus encore.
Dépannage
- "yt-dlp : commande introuvable" : Installez-le (
pip install yt-dlp) et assurez-vous que votre PATH inclut le répertoire bin de pip. - "ffmpeg : commande introuvable" : Installez ffmpeg. Sans lui, les téléchargements échouent lorsque la vidéo et l'audio sont des flux séparés (courant sur YouTube pour la HD).
- Les téléchargements échouent ou renvoient des erreurs : Exécutez
yt-dlp -Upour mettre à jour. Les sites changent fréquemment et yt-dlp publie des correctifs régulièrement.