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を使用してください。- 追加の
yt-dlp引数は--の後に渡してください(transcriptフォールバック、download、audio、subs、formatsで使用可能)。
./scripts/vtd.js formats --url 'https://…' -- -v
トラブルシューティング(必要な場合のみ)
yt-dlp/ffmpegがない場合:
brew install yt-dlp ffmpeg
- 確認:
yt-dlp --version
ffmpeg -version | head -n 1