Video Transcript Downloader
./scripts/vtd.js 可以:
- 將逐字稿輸出為乾淨的段落(可選時間戳記)。
- 下載影片/音訊/字幕。
逐字稿行為:
- YouTube:盡可能使用
youtube-transcript-plus取得。 - 否則:透過
yt-dlp拉取字幕,再清理成段落。
設定
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
CLI 語法:
./scripts/vtd.js --help
./scripts/vtd.js transcript --help
子指令支援獨立說明,不須搭配 --url。
逐字稿(預設:乾淨段落)
./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
下載影片/音訊/字幕
./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
格式(列舉 + 選擇)
列出可用格式(格式 ID、解析度、容器、純音訊等):
./scripts/vtd.js formats --url 'https://…'
下載指定的格式 ID(範例):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140
優先使用 MP4 容器,不需重新轉碼(盡可能重新封裝):
./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4
備註
- 預設逐字稿輸出為單一段落。僅在要求時才使用
--timestamps。 - 中括號內的提示(例如
[Music])預設會移除;可透過--keep-brackets保留。 - 可在
transcript備用方案、download、audio、subs、formats指令的--之後傳遞額外的yt-dlp參數。
./scripts/vtd.js formats --url 'https://…' -- -v
疑難排解(僅在有需要時)
- 缺少
yt-dlp或ffmpeg:
brew install yt-dlp ffmpeg
- 驗證:
yt-dlp --version
ffmpeg -version | head -n 1