Descargador de Transcripciones de Video
./scripts/vtd.js puede:
- Imprimir una transcripción como un párrafo limpio (timestamps opcionales).
- Descargar video/audio/subtítulos.
Comportamiento de la transcripción:
- YouTube: obtener mediante
youtube-transcript-pluscuando sea posible. - De lo contrario: extraer subtítulos vía
yt-dlp, luego limpiarlos para convertirlos en un párrafo.
Configuración
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
Transcripción (por defecto: párrafo limpio)
./scripts/vtd.js transcript --url 'https://…'
./scripts/vtd.js transcript --url 'https://…' --lang en
./scripts/vtd.js transcript --url 'https://…' --timestamps
./scripts/vtd.js transcript --url 'https://…' --keep-brackets
Descargar video / audio / subtítulos
./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 en
Formatos (listar + elegir)
Listar formatos disponibles (ids de formato, resolución, contenedor, solo audio, etc.):
./scripts/vtd.js formats --url 'https://…'
Descargar un id de formato específico (ejemplo):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140
Preferir contenedor MP4 sin recodificación (remezclar cuando sea posible):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4
Notas
- La salida de transcripción por defecto es un solo párrafo. Usa
--timestampssolo cuando se solicite. - Las indicaciones entre corchetes como
[Música]se eliminan por defecto; consérvalas mediante--keep-brackets. - Pasa argumentos adicionales de
yt-dlpdespués de--para la opcióntranscript(fallback),download,audio,subs,formats.
./scripts/vtd.js formats --url 'https://…' -- -v
Solución de problemas (solo cuando sea necesario)
- Falta
yt-dlp/ffmpeg:
brew install yt-dlp ffmpeg
- Verificar:
yt-dlp --version
ffmpeg -version | head -n 1