Video Transcript Downloader(動画トランスクリプトダウンローダー)
./scripts/vtd.js は以下の機能を提供します:
- トランスクリプトをクリーンな段落として出力(タイムスタンプ表示オプションあり)
- 動画/音声/字幕のダウンロード
トランスクリプトの動作:
- YouTube: 可能な限り
youtube-transcript-plus経由で取得 - その他:
yt-dlpで字幕を取得し、段落に整形
セットアップ
cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci
トランスクリプト(デフォルト:クリーンな段落)
./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