ビデオ字幕ダウンロードツール

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

再エンコードなし (可能な場合は remux) で 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