AGENT SKILL

video-transcript-downloader

yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 2
Forks
0

01 前言 Front Matter

name
video-transcript-downloader
description
yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.

02 资源文件 5

03 SKILL.md 正文

Video Transcript Downloader

./scripts/vtd.js: print transcript (clean paragraph, timestamps optional), download video/audio/subtitles.

Transcript behavior:

  • YouTube: youtube-transcript-plus when possible.
  • Fallback: subtitles via yt-dlp, cleaned into paragraph.

Setup

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

CLI help:

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

Subcommands support focused help without --url.

Transcript (default: clean paragraph)

./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

Download video / audio / subtitles

./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

Formats

List available (format ids, resolution, container, audio-only):

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

Download specific format id:

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

Prefer MP4 without re-encoding (remux):

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4

Notes

  • Default transcript: single paragraph. --timestamps only when asked.
  • Bracketed cues [Music] stripped by default; --keep-brackets to preserve.
  • Extra yt-dlp args after -- for transcript fallback, download, audio, subs, formats:
./scripts/vtd.js formats --url 'https://…' -- -v

Troubleshooting

Missing yt-dlp / ffmpeg:

brew install yt-dlp ffmpeg

Verify:

yt-dlp --version
ffmpeg -version | head -n 1

04 同仓库更多 Skills