Communitygithub.com

steipete/video-transcript-downloader

Baixe vídeos, áudio, legendas, transcrições, clipes e playlists usando yt-dlp.

O que é video-transcript-downloader?

O Video Transcript Downloader é uma habilidade prática para desenvolvedores e usuários de agentes de IA que precisam extrair transcrições, áudio ou vídeo de plataformas como YouTube e outras fontes suportadas pelo yt-dlp. Ela permite obter transcrições limpas em parágrafo único (com ou sem timestamps), baixar vídeos, áudio, legendas e listar formatos disponíveis. A ferramenta prioriza a API nativa do YouTube para transcrições via `youtube-transcript-plus`, mas cai graciosamente para o yt-dlp quando necessário, garantindo máxima cobertura. Compatível com Claude Code, Cursor, Codex e outros agentes, basta configurar as dependências com `npm ci` e usar os comandos CLI simples como `./scripts/vtd.js transcript`, `download` ou `subs`. A habilidade também oferece suporte a parâmetros extras do yt-dlp via `--` e opções para manter colchetes ou timestamps, tornando-a flexível para automação e integração em pipelines de processamento de mídia.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/video-transcript-downloader

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Video Transcript Downloader

./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: busca via youtube-transcript-plus quando possível.
  • Caso contrário: extrai legendas via yt-dlp e limpa em um parágrafo.

Configuração

cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci

Sintaxe da CLI:

./scripts/vtd.js --help
./scripts/vtd.js transcript --help

Subcomandos suportam ajuda focada sem exigir --url.

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)

Listar formatos disponíveis (IDs de formato, resolução, contêiner, só áudio, etc.):

./scripts/vtd.js formats --url 'https://…'

Baixar um ID de formato específico (exemplo):

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140

Preferir contêiner MP4 sem re-encoder (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 --timestamps apenas quando solicitado.
  • Marcadores entre colchetes como [Music] são removidos por padrão; mantenha-os com --keep-brackets.
  • Passe argumentos extras do yt-dlp após -- para fallback de transcript, 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas