youtube-segment-downloader 1.0.0

Téléchargez des segments spécifiques de vidéos YouTube en MP4

YouTube Segment Downloader

Un package Python simple et puissant pour télécharger des segments spécifiques de vidéos YouTube en format MP4.

✨ Fonctionnalités

• ✅ Télécharge uniquement le segment demandé (pas la vidéo complète)
• ✅ Qualité maximale disponible
• ✅ Format MP4 automatique
• ✅ Validation des URLs YouTube
• ✅ Gestion des erreurs robuste
• ✅ Interface CLI simple
• ✅ Utilisation programmatique en Python
• ✅ Affichage de la progression

📦 Installation

Via pip (Recommandé)

pip install youtube-segment-downloader

Depuis les sources

git clone https://github.com/yourusername/youtube-segment-downloader.git
cd youtube-segment-downloader
pip install -e .

📋 Prérequis

Le package nécessite ffmpeg installé sur votre système :

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install ffmpeg

macOS:

brew install ffmpeg

Windows: Téléchargez depuis https://ffmpeg.org/download.html

🚀 Utilisation

Interface en ligne de commande

Après installation, la commande yt-segment est disponible globalement :

yt-segment <URL> <début> <fin> [fichier_sortie]

Exemples:

# Télécharger de 15:21 à 30:21
yt-segment "https://www.youtube.com/watch?v=dQw4w9WgXcQ" "15:21" "30:21"

# Avec un nom de fichier personnalisé
yt-segment "https://www.youtube.com/watch?v=dQw4w9WgXcQ" "15:21" "30:21" "mon_extrait.mp4"

# Format avec heures (1h15m30s à 1h45m00s)
yt-segment "https://www.youtube.com/watch?v=dQw4w9WgXcQ" "1:15:30" "1:45:00"

Utilisation programmatique en Python

from youtube_segment_downloader import download_segment

# Télécharger un segment
success = download_segment(
    url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    start_time="15:21",
    end_time="30:21",
    output_file="mon_segment.mp4",
    verbose=True
)

if success:
    print("Téléchargement réussi!")

En tant que module Python

python -m youtube_segment_downloader "URL" "15:21" "30:21"

📝 Formats de temps acceptés

• MM:SS - Minutes:Secondes (ex: "15:21")
• HH:MM:SS - Heures:Minutes:Secondes (ex: "1:15:30")

🔧 Comment ça marche

Le package utilise:

1. yt-dlp avec l'option --download-sections pour télécharger uniquement la partie demandée
2. ffmpeg pour découper et fusionner la vidéo et l'audio
3. Format de sortie MP4 pour une compatibilité maximale

⚠️ Notes importantes

• Respectez les droits d'auteur et les conditions d'utilisation de YouTube
• Assurez-vous d'avoir une connexion internet stable
• Les temps doivent être valides (le temps de fin doit être après le début)
• Le fichier sera sauvegardé dans le répertoire courant

🐛 Dépannage

"RuntimeError: yt-dlp n'est pas installé"

pip install yt-dlp

"RuntimeError: ffmpeg n'est pas installé"

• Installez ffmpeg selon votre système d'exploitation (voir Prérequis)

"ValueError: URL YouTube invalide"

• Vérifiez que l'URL commence par https://www.youtube.com/watch?v= ou https://youtu.be/

Le téléchargement est lent

• C'est normal, yt-dlp télécharge et traite la vidéo en temps réel

🧪 Tests

Pour exécuter les tests :

pip install pytest
pytest tests/

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

• Signaler des bugs
• Proposer de nouvelles fonctionnalités
• Soumettre des pull requests

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

🔗 Liens

• PyPI
• GitHub
• Issues

📊 Changelog

Voir CHANGELOG.md pour l'historique des versions.

---

Utilisez-le de manière responsable et respectez les droits d'auteur ! 🎬