Communitygithub.com

steipete/video-transcript-downloader

yt-dlp descargas: video, audio, subtítulos, transcripciones, clips, listas de reproducción.

¿Qué es video-transcript-downloader?

Este skill permite descargar y extraer transcripciones, videos, audio y subtítulos de plataformas como YouTube utilizando `yt-dlp` y `youtube-transcript-plus`. Está diseñado para agentes de IA (Claude Code, Cursor, Codex) que necesitan procesar contenido multimedia. Para YouTube, intenta obtener la transcripción directamente mediante `youtube-transcript-plus`, y en caso de fallo, recurre a `yt-dlp` para extraer subtítulos y limpiarlos en un párrafo legible. Soporta la descarga de videos en formatos específicos, audio solo, subtítulos en varios idiomas, y listas de reproducción. Además, permite personalizar la salida con o sin marcas de tiempo, conservar o eliminar indicaciones entre corchetes como `[Music]`, y elegir formatos de contenedor sin recodificación. Es especialmente útil para crear resúmenes, analizar contenido, o generar subtítulos localizados de manera automatizada. El script principal es `./scripts/vtd.js` y se ejecuta desde la línea de comandos con una sintaxis clara y subcomandos de ayuda integrados.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Descargador de Transcripciones de Video

./scripts/vtd.js puede:

  • Imprimir una transcripción como un párrafo limpio (marcas de tiempo opcionales).
  • Descargar video/audio/subtítulos.

Comportamiento de la transcripción:

  • YouTube: obtener mediante youtube-transcript-plus cuando sea posible.
  • De lo contrario: extraer subtítulos mediante yt-dlp, luego limpiarlos en un párrafo.

Configuración

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

Sintaxis de CLI:

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

Los subcomandos soportan ayuda específica sin requerir --url.

Transcripción (predeterminado: 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 predeterminada de la transcripción es un solo párrafo. Usa --timestamps solo cuando se solicite.
  • Las indicaciones entre corchetes como [Music] se eliminan de forma predeterminada; se conservan mediante --keep-brackets.
  • Pasa argumentos adicionales de yt-dlp después de -- para la alternativa de transcript, 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

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.

Skills relacionados