video-transcript-downloader
yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.
来源信息
- 仓库
- steipete/agent-scripts
- 最近来源活动
- 2026年10月16日 21:04
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 7,433
- Forks
- 648
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
7 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- video-transcript-downloader
- description
- yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.
# Video Transcript Downloader
`./scripts/vtd.js` can:
- Print a transcript as a clean paragraph (timestamps optional).
- Download video/audio/subtitles.
Transcript behavior:
- YouTube: fetch via `youtube-transcript-plus` when possible.
- Otherwise: pull subtitles via `yt-dlp`, then clean into a paragraph.
## Setup
```bash
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
```
CLI syntax:
```bash
./scripts/vtd.js --help
./scripts/vtd.js transcript --help
```
Subcommands support focused help without requiring `--url`.
## Transcript (default: clean paragraph)
```bash
./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
```bash
./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 + choose)
List available formats (format ids, resolution, container, audio-only, etc):
```bash
./scripts/vtd.js formats --url 'https://…'
```
Download a specific format id (example):
```bash
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140
```
Prefer MP4 container without re-encoding (remux when possible):
```bash
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4
```
## Notes
- Default transcript output is a single paragraph. Use `--timestamps` only when asked.
- Bracketed cues like `[Music]` are stripped by default; keep them via `--keep-brackets`.
- Pass extra `yt-dlp` args after `--` for `transcript` fallback, `download`, `audio`, `subs`, `formats`.
```bash
./scripts/vtd.js formats --url 'https://…' -- -v
```
## Troubleshooting (only when needed)
- Missing `yt-dlp` / `ffmpeg`:
```bash
brew install yt-dlp ffmpeg
```
- Verify:
```bash
yt-dlp --version
ffmpeg -version | head -n 1
```
在 GitHub 查看