Video Transcript Downloader
./scripts/vtd.js kann:
- Ein Transkript als sauberen Absatz ausgeben (wahlweise mit Zeitstempeln).
- Video/Audio/Untertitel herunterladen.
Verhalten bei Transkripten:
- YouTube: Abruf über
youtube-transcript-plus, wenn möglich. - Andernfalls: Untertitel via
yt-dlpextrahieren und als Absatz bereinigen.
Einrichtung
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
CLI-Syntax:
./scripts/vtd.js --help
./scripts/vtd.js transcript --help
Unterbefehle unterstützen fokussierte Hilfe ohne Angabe von --url.
Transkript (Standard: bereinigter Absatz)
./scripts/vtd.js transcript --url 'https://…'
./scripts/vtd.js transcript --url 'https://…' --lang de
./scripts/vtd.js transcript --url 'https://…' --timestamps
./scripts/vtd.js transcript --url 'https://…' --keep-brackets
Video / Audio / Untertitel herunterladen
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js audio --url 'https://…' --output-dir ~/Downloads
./scripts/vtd.js subs --url 'https://…' --output-dir ~/Downloads --lang de
Formate (Auflisten + Auswählen)
Verfügbare Formate auflisten (Format-IDs, Auflösung, Container, Audio-only usw.):
./scripts/vtd.js formats --url 'https://…'
Eine bestimmte Format-ID herunterladen (Beispiel):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140
MP4-Container bevorzugen ohne Neucodierung (Remux wenn möglich):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4
Hinweise
- Standardmäßig wird das Transkript als einzelner Absatz ausgegeben. Verwende
--timestampsnur auf Anfrage. - Hinweise in eckigen Klammern wie
[Musik]werden standardmäßig entfernt; mit--keep-bracketsbleiben sie erhalten. - Zusätzliche
yt-dlp-Argumente nach--fürtranscript-Fallback,download,audio,subs,formatsübergeben.
./scripts/vtd.js formats --url 'https://…' -- -v
Fehlerbehebung (nur bei Bedarf)
- Fehlende
yt-dlp- oderffmpeg-Installation:
brew install yt-dlp ffmpeg
- Überprüfung:
yt-dlp --version
ffmpeg -version | head -n 1