À propos du projet
youtube-dl est un programme en ligne de commande pour télécharger des vidéos depuis YouTube.com et de nombreuses autres plateformes vidéo. Il est écrit en Python, fonctionne sur tous les systèmes d'exploitation (Linux, macOS, Windows) et nécessite Python 2.6/2.7 ou 3.2+.
## Installation
Disponible via plusieurs méthodes :
- Téléchargement direct du binaire : `sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl -o /usr/local/bin/youtube-dl`
- pip : `sudo -H pip install --upgrade youtube-dl`
- macOS Homebrew : `brew install youtube-dl`
- macOS MacPorts : `sudo port install youtube-dl`
- Windows : Téléchargez le .exe et placez-le sur le PATH (pas dans System32).
## Fonctionnalités principales
- Téléchargement de vidéos et de sous-titres depuis plus de 1000 sites pris en charge grâce à des extracteurs dédiés.
- Support complet des playlists avec sélection par intervalle (`--playlist-start`, `--playlist-end`, `--playlist-items`), ordre inverse et ordre aléatoire.
- Sélection et filtrage des formats vidéo par résolution, conteneur, codec, taille de fichier, durée, nombre de vues et date.
- Contournement des restrictions géographiques via des en-têtes X-Forwarded-For falsifiés, codes pays personnalisés ou exceptions de blocage IP.
- Options réseau : proxys HTTP/HTTPS/SOCKS, forçage IPv4/IPv6, timeouts socket, agents utilisateur et référents personnalisés.
- Support des downloaders externes (aria2c, curl, ffmpeg, wget, axel, etc.) pour des scénarios de téléchargement avancés.
- Reprise des fichiers partiellement téléchargés ; retries configurables pour les fragments complets et individuels.
- Modélisation des noms de fichiers de sortie avec de nombreuses clés de métadonnées (titre, uploadé par, date de mise en ligne, résolution, format, etc.).
- Artefacts de sortie optionnels : vignettes (unique ou tous les formats), métadonnées `.info.json`, fichiers `.description`, `.annotations.xml`.
## Utilisation courante
Téléchargement basique : `youtube-dl <URL>`
Télécharger les éléments 5 à 10 d'une playlist : `youtube-dl --playlist-items 5-10 <playlist_URL>`
Sélectionner la meilleure qualité vidéo uniquement : `youtube-dl -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" <URL>`
Définir un modèle de sortie : `youtube-dl -o "%(title)s [%(id)s].%(ext)s" <URL>`
Télécharger les sous-titres : ajoutez `--write-subs --sub-langs en` à la commande.
Simulation sans téléchargement : `youtube-dl --skip-download <URL>`
Afficher les métadonnées JSON : `youtube-dl --dump-json <URL>`
Limiter le débit : `youtube-dl --limit-rate 50K <URL>`
## Configuration
Les options peuvent être placées dans des fichiers de configuration :
- Global : `/etc/youtube-dl.conf`
- Utilisateur : `~/.config/youtube-dl/config` (Linux/macOS) ou `%APPDATA%/youtube-dl/config.txt` (Windows)
Utilisez `--config-location` pour spécifier un chemin personnalisé, ou `--ignore-config` pour ignorer tout fichier de configuration.
## Intégration
youtube-dl peut être utilisé comme bibliothèque Python, intégrant la logique d'extraction et de téléchargement dans des scripts et applications.
## Licence
Publié dans le domaine public — libre de modifier, redistribuer et utiliser de quelque manière que ce soit.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.