naoterumaker Video Downloader
yt-dlp を使った動画ダウンローダ。YouTube / Loom / Vimeo / その他 yt-dlp が対応する全プラットフォームに対応。
前提
brew install yt-dlp ffmpeg
基本ダウンロード（推奨設定）
最大1080p・mp4で保存。manabi-ingest からの呼び出しもこれを使う。
yt-dlp \
-o "downloads/%(title)s.%(ext)s" \
-f "bv*[height<=1080][ext=mp4]+ba[ext=m4a]/b[height<=1080][ext=mp4]/b" \
--merge-output-format mp4 \
"<URL>"
画質指定
# 720p
yt-dlp -f "bv*[height<=720]+ba/b[height<=720]" "<URL>"
# 4K
yt-dlp -f "bv*[height<=2160]+ba/b[height<=2160]" "<URL>"
# 利用可能なフォーマット一覧
yt-dlp -F "<URL>"
音声のみ
yt-dlp -x --audio-format mp3 -o "downloads/%(title)s.%(ext)s" "<URL>"
プレイリスト一括
yt-dlp \
-o "downloads/%(playlist_title)s/%(playlist_index)s-%(title)s.%(ext)s" \
"<PLAYLIST_URL>"
バッチダウンロード（複数URL）
yt-dlp -a urls.txt
（urls.txt に1行1URL）
メタデータ・サムネイル保存
yt-dlp \
--write-info-json \
--write-thumbnail \
--write-description \
-o "downloads/%(title)s.%(ext)s" \
"<URL>"
字幕ダウンロード
# 自動生成字幕も含めて取得
yt-dlp --write-subs --write-auto-subs --sub-langs "ja,en" --skip-download "<URL>"
困ったとき
| 症状 | 対処 |
|---|---|
ERROR: Unsupported URL |
pip install -U yt-dlp で最新化 |
| 認証必須の動画 | --cookies-from-browser chrome でブラウザCookie利用 |
| ダウンロード遅い | -N 4 で並列セグメントDL |
| 結合エラー | ffmpeg 未インストール → brew install ffmpeg |
ライセンス・利用上の注意
- 自分が権利を持つ動画、または利用規約・著作権法上ダウンロードが許される動画のみ対象
- プラットフォーム規約を確認すること
- 個人視聴・教育・公正利用の範囲で使用