Un téléchargeur YouTube simple et efficace qui permet de télécharger des vidéos individuelles, des playlists complètes et des chaînes entières en format audio MP3.

• Téléchargement de vidéos YouTube individuelles
• Téléchargement de playlists complètes
• Téléchargement de chaînes YouTube entières
• Conversion automatique en MP3 (192 kbps)
• Détection automatique du type d'URL
• Barre de progression en temps réel
• Organisation des fichiers par playlist/chaîne

• Python 3.7 ou supérieur
• FFmpeg (requis pour la conversion audio)

Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg

1. Clonez ou téléchargez ce dépôt

2. Installez les dépendances Python:

pip install -r requirements.txt

3. Rendez le script exécutable (Linux/macOS):

chmod +x youtube_downloader.py

python youtube_downloader.py [OPTIONS] URL

Télécharger une vidéo:

python youtube_downloader.py https://www.youtube.com/watch?v=VIDEO_ID

Télécharger une playlist:

python youtube_downloader.py https://www.youtube.com/playlist?list=PLAYLIST_ID

Télécharger une chaîne entière:

python youtube_downloader.py https://www.youtube.com/@NOM_CHAINE

Spécifier un dossier de destination:

python youtube_downloader.py -o /chemin/vers/dossier https://www.youtube.com/watch?v=VIDEO_ID

Forcer le type de téléchargement:

python youtube_downloader.py -t playlist https://www.youtube.com/playlist?list=PLAYLIST_ID

• -o, --output : Dossier de destination (défaut: downloads)
• -t, --type : Type de téléchargement (auto, video, playlist, channel)
• -h, --help : Afficher l'aide

downloads/
├── video1.mp3                    # Vidéos individuelles
├── video2.mp3
├── Ma Playlist/                  # Playlists
│   ├── chanson1.mp3
│   ├── chanson2.mp3
│   └── chanson3.mp3
└── Nom de la Chaîne/            # Chaînes
    ├── video1.mp3
    └── video2.mp3

• Vidéo: https://www.youtube.com/watch?v=VIDEO_ID
• Playlist: https://www.youtube.com/playlist?list=PLAYLIST_ID
• Chaîne (nouveau format): https://www.youtube.com/@USERNAME
• Chaîne (ancien format): https://www.youtube.com/channel/CHANNEL_ID
• Chaîne (user): https://www.youtube.com/user/USERNAME

• Utilise yt-dlp pour le téléchargement (fork maintenu de youtube-dl)
• Qualité audio: MP3 192 kbps
• Gestion des erreurs robuste
• Confirmation avant téléchargement de chaînes complètes
• Affichage coloré dans le terminal

Erreur "ffmpeg not found":

• Installez FFmpeg (voir section Prérequis)

Erreur de téléchargement:

• Vérifiez que l'URL est valide
• Certaines vidéos peuvent être protégées ou restreintes
• Mettez à jour yt-dlp: pip install --upgrade yt-dlp

Vidéos manquantes dans une playlist:

• Certaines vidéos peuvent être privées ou supprimées
• Le script continue malgré les erreurs (option ignoreerrors)

Ce projet est fourni à des fins éducatives. Respectez les conditions d'utilisation de YouTube et les droits d'auteur.

Le téléchargement de contenus protégés par des droits d'auteur peut être illégal dans votre juridiction. Utilisez cet outil de manière responsable et uniquement pour du contenu dont vous avez le droit de télécharger.