video-transcript-downloader

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

./scripts/vtd.js

可以实现以下功能：

将文稿输出为整洁的段落（支持可选时间戳）
下载视频、音频、字幕

文稿处理逻辑：

YouTube：尽可能通过
```
youtube-transcript-plus
```
获取
其他情况：通过
```
yt-dlp
```
拉取字幕，然后整理为段落格式

Setup

安装

bash

cd "${CODEX_HOME:-~/.codex}/skills/video-transcript-downloader" && npm ci

bash

cd "${CODEX_HOME:-~/.codex}/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

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

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

列出可用格式（格式ID、分辨率、容器、仅音频等属性）：

bash

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

下载指定格式ID（示例）：

bash

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

优先使用MP4容器无需重新编码（尽可能转封装）：

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

默认文稿输出为单个段落，仅在用户要求时使用
```
--timestamps
```
参数
默认会移除
```
[Music]
```
这类带括号的提示标记，可通过
```
--keep-brackets
```
参数保留
可在
```
--
```
后传入额外的
```
yt-dlp
```
参数，适用于文稿降级获取、下载、音频提取、字幕下载、格式查询等场景

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

缺失
```
yt-dlp
```
/
```
ffmpeg
```
时：

bash

brew install yt-dlp ffmpeg

验证安装：

bash

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

Attribution

署名

This skill was copied from steipete/agent-scripts. Upstream: https://github.com/steipete/agent-scripts License: MIT (see LICENSE)

本技能复制自 steipete/agent-scripts 上游仓库：https://github.com/steipete/agent-scripts 许可证：MIT（详见 LICENSE 文件）