Downloader de Transcrição de Vídeo
./scripts/vtd.js pode:
- Imprimir uma transcrição como um parágrafo limpo (timestamps opcionais).
- Baixar vídeo/áudio/legendas.
Comportamento da transcrição:
- YouTube: buscar via
youtube-transcript-plusquando possível. - Caso contrário: extrair legendas via
yt-dlpe depois limpar em um parágrafo.
Configuração
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
Transcrição (padrão: parágrafo limpo)
./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
Baixar vídeo / áudio / legendas
./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 + escolher)
Liste os formatos disponíveis (IDs de formato, resolução, contêiner, somente áudio, etc):
./scripts/vtd.js formats --url 'https://…'
Baixe um ID de formato específico (exemplo):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140
Prefira contêiner MP4 sem reencodificação (remux quando possível):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4
Notas
- A saída padrão da transcrição é um único parágrafo. Use
--timestampsapenas quando solicitado. - Indicações entre colchetes como
[Music]são removidas por padrão; mantenha-as via--keep-brackets. - Passe argumentos extras do
yt-dlpapós--para fallback detranscript,download,audio,subs,formats.
./scripts/vtd.js formats --url 'https://…' -- -v
Solução de problemas (apenas quando necessário)
- Faltando
yt-dlp/ffmpeg:
brew install yt-dlp ffmpeg
- Verificar:
yt-dlp --version
ffmpeg -version | head -n 1