Video Transcript Downloader

TotalClaw 作者 steipete v1.0.0

从 YouTube 和任何其他 yt-dlp 支持的网站下载视频、音频、字幕和干净的段落式文字记录。当被要求“下载此视频”、“保存此剪辑”、“翻录音频”、“获取字幕”、“获取文字记录”或对 yt-dlp/ffmpeg 和格式/播放列表进行故障排除时使用。

源码 ↗

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:steipete~video-transcript-downloader

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Asteipete~video-transcript-downloader/file -o video-transcript-downloader.md

Git 仓库获取源码

git clone https://github.com/clawdbot/skills/commit/15991046ff6340409547994c5df4ab1fe1a6f4f5

## 概述（中文）

从 YouTube 和任何其他 yt-dlp 支持的网站下载视频、音频、字幕和干净的段落式文字记录。当被要求“下载此视频”、“保存此剪辑”、“翻录音频”、“获取字幕”、“获取文字记录”或对 yt-dlp/ffmpeg 和格式/播放列表进行故障排除时使用。

## 原文

# 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
```

## 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
```