YouTube Transcript Downloader
Ein Skill zum Extrahieren und Verarbeiten von Untertiteln aus YouTube-Videos.
Prioritätsreihenfolge
1. yt-dlp-Installation prüfen
2. Verfügbare Untertitellisten anzeigen
3. Manuelle Untertitel priorisieren
4. Automatisch generierte Untertitel als Fallback
5. Letzter Ausweg: Whisper-Konvertierung
Voraussetzungen
# macOS
brew install yt-dlp
# Linux
sudo apt install yt-dlp
# Universell
pip install yt-dlp
Arbeitsablauf
Schritt 1: Untertitelliste prüfen
yt-dlp --list-subs "VIDEO_URL"
Schritt 2: Manuelle Untertitel herunterladen (empfohlen)
# Deutsche Untertitel
yt-dlp --write-sub --sub-lang de --skip-download "VIDEO_URL"
# Englische Untertitel
yt-dlp --write-sub --sub-lang en --skip-download "VIDEO_URL"
Schritt 3: Automatisch generierte Untertitel (Fallback)
yt-dlp --write-auto-sub --sub-lang de --skip-download "VIDEO_URL"
Schritt 4: VTT → Text konvertieren
# Zeitstempel aus VTT-Datei entfernen
sed '/^[0-9]/d; /^$/d; /-->/d' subtitle.de.vtt > transcript.txt
Ausgabeverarbeitung
Deduplizierung
Automatisch generierte Untertitel enthalten aufgrund von progressiven Captions viele Duplikate:
# Doppelte Zeilen entfernen
seen = set()
unique_lines = []
for line in lines:
if line not in seen:
seen.add(line)
unique_lines.append(line)
Zusammenfassung erstellen
Aus den extrahierten Untertiteln:
- Kerninhalte zusammenfassen
- Kapitel mit Zeitstempeln erstellen
- Schlüsselwörter extrahieren
Beispiele
Beispiel 1: Zusammenfassung eines Lehrvideos
Benutzer: Fasse dieses YouTube-Tutorial zusammen - https://youtube.com/watch?v=xxx
Claude:
1. Untertitel mit yt-dlp herunterladen
2. VTT → Text konvertieren
3. Kernzusammenfassung erstellen
4. Inhaltsverzeichnis mit Zeitstempeln bereitstellen
Beispiel 2: Mehrsprachige Untertitel extrahieren
Benutzer: Extrahiere sowohl englische als auch deutsche Untertitel aus diesem Video
Claude:
1. Verfügbare Sprachen mit --list-subs prüfen
2. Untertitel für jede Sprache herunterladen
3. Bereinigte Textdateien bereitstellen
Fehlerbehandlung
| Fehler | Ursache | Lösung |
|---|---|---|
yt-dlp not found | Nicht installiert | brew/apt/pip installieren |
No subtitles available | Keine Untertitel vorhanden | Whisper vorschlagen |
Invalid URL | URL-Fehler | URL-Format prüfen |
Video unavailable | Privat/gelöscht | Benutzer benachrichtigen |
Whisper-Fallback
Falls überhaupt keine Untertitel verfügbar sind (Benutzerbestätigung erforderlich):
# Dateigröße prüfen
yt-dlp --print filesize "VIDEO_URL"
# Nach Benutzerfreigabe Audio herunterladen
yt-dlp -x --audio-format mp3 "VIDEO_URL"
# Mit Whisper konvertieren
whisper audio.mp3 --language de --model base
Hinweis: Aufgrund von Bandbreiten-/Verarbeitungszeitaufwand ist eine Benutzerbestätigung erforderlich