Code source.
https://github.com/HackTechDev/downloadSubtitleTranslationYoutube
downloadSubtitleTranslation
Récupère les sous-titres d'une vidéo YouTube dans sa langue d'origine, ainsi que leur traduction en français (ou dans une autre langue).
Démarrage rapide
./get_subtitles.py "https://www.youtube.com/watch?v=CIUQ-ylpe2Y"
Résultat dans subtitles/ :
| Fichier | Contenu |
|---|---|
<titre> [<id>].<langue d'origine>.srt |
Sous-titres d'origine, horodatés |
<titre> [<id>].<langue d'origine>.txt |
Texte d'origine brut |
<titre> [<id>].fr.srt |
Traduction française, horodatée |
<titre> [<id>].fr.txt |
Traduction française en texte brut |
Fonctionnalités
- Sous-titres manuels en priorité, sinon sous-titres automatiques de YouTube.
- Traduction via la traduction automatique de YouTube (aucune clé d'API nécessaire).
- Fusion des sous-titres qui se chevauchent dans les
.srt: blocs de 2 lignes au maximum, sans superposition. - Contournement des blocages courants : cookies du navigateur, IPv4 forcée, essai de plusieurs clients YouTube.
Options
./get_subtitles.py [-o DOSSIER] [-l LANGUE] [-b NAVIGATEUR] [-m LIGNES] URL
| Option | Défaut | Rôle |
|---|---|---|
-o |
subtitles |
Dossier de sortie |
-l |
fr |
Langue de traduction |
-b |
firefox |
Navigateur pour les cookies (none pour désactiver) |
-m |
2 |
Lignes maximum par sous-titre |
Prérequis
- Python 3.9+
- yt-dlp à jour
- Firefox (ou un autre navigateur) connecté à YouTube
Documentation
- MANUEL.md : installation, utilisation détaillée et dépannage
- ANALYSE.md : choix techniques, obstacles rencontrés et limites
- EXAMPLE.md : exemple complet sur une vraie vidéo