YouTube 用 yt-dlp コマンドジェネレーター

YouTube の動画・再生リスト・チャンネル向けに、正確な yt-dlp コマンドを組み立てます。初期状態は 1080p MP4、チャプターとメタデータ付き、スポンサー区間は削除済みです。

動画・再生リスト・チャンネルの URL

任意です。空のままにするとコマンドは URL で終わるので、あとから自分で埋められます。

あなたのコマンド

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --embed-subs --sub-langs en --no-playlist --embed-thumbnail --embed-metadata --embed-chapters --sponsorblock-remove default 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

基本

何が欲しいか

動画音声のみ

音声のみを選ぶと音声トラックを取り出し、映像は捨てます。

動画と画質

最大画質 -f

高さの上限を決めます。yt-dlp はその上限以下で最良のストリームを選びます。

Container --merge-output-format ffmpeg が必要

分かれている映像と音声のストリームを結合して入れるファイル形式です。

詳細オプション（3）

独自の format selector -f

画質のプルダウンを上書きします。format の書き方をすでに知っている人向けです。

remux 先 --remux-video ffmpeg が必要

再エンコードせず入れ直すだけです。速く、劣化もありません。

再エンコード先 --recode-video ffmpeg が必要

映像を再エンコードします。遅く、劣化もします —— remux で足りないときだけ使ってください。

音声

音声フォーマット --audio-format ffmpeg が必要

音声を変換する先のファイル形式です。

音声品質 --audio-quality ffmpeg が必要

VBR はサイズと品質の比がいちばん良く、固定 bitrate はサイズが読みやすいです。

字幕

埋め込みは字幕を動画の中に入れ、保存は隣に別の .srt ファイルを書き出します。

字幕の言語 --sub-langs

カンマ区切りで指定します。利用できる全言語が欲しいときは all と書きます。

自動生成の字幕 --write-auto-subs 人が付けた字幕がないとき、機械生成の字幕も対象に含めます。

再生リストとチャンネル

再生リストの扱い

URL が動画と再生リストの両方に属している場合の動作です。

どの項目か -I

範囲もリストも使えます。たとえば 1-10,15、あるいは末尾から 1 つ飛ばしで取る -5::2 など。

詳細オプション（1）

記録ファイル --download-archive

ダウンロード済みの項目を記録するので、再実行時にはそれらを飛ばします。チャンネルを同期させ続ける方法がこれです。

区間とチャプター

詳細オプション（2）

一部だけダウンロード --download-sections ffmpeg が必要

*00:01:30-00:03:00 のような時間範囲、またはチャプター名です。先頭のアスタリスクは時刻であることを示します。

チャプターごとに分割 --split-chapters ffmpeg が必要長い 1 ファイルではなく、チャプターごとに 1 ファイル書き出します。

メタデータとカバー画像

サムネイルを埋め込む --embed-thumbnail ffmpeg が必要動画のサムネイルをカバー画像として使います。

メタデータを埋め込む --embed-metadata ffmpeg が必要タイトル・投稿者・日付をファイル自体に書き込みます。

チャプターを埋め込む --embed-chapters ffmpeg が必要プレイヤーで飛べるチャプターマークを追加します。

詳細オプション（3）

サムネイルを別ファイルで保存 --write-thumbnail カバー画像を動画の隣に書き出します。

概要欄を保存 --write-description 概要欄を .description ファイルに書き出します。

メタデータ JSON を保存 --write-info-json yt-dlp がその動画について知っていることすべてを .info.json に書き出します。

SponsorBlock

区間を削除 --sponsorblock-remove ffmpeg が必要

SponsorBlock のデータをもとに、コミュニティが印を付けた区間をファイルから切り取ります。

詳細オプション（1）

区間をチャプターとして印付け --sponsorblock-mark

区間は残したまま印を付けるので、自分で飛ばせます。

ファイルとフォルダ

ファイル名テンプレート -o

フィールド名は %(...)s の中に書きます。スラッシュはフォルダを作ります。

安全な（ASCII のみの）ファイル名 --restrict-filenames アクセント記号・空白、そして気難しいファイルシステムが拒みそうな文字を落とします。

既存のファイルを上書き --force-overwrites すでにあるファイルを置き換えます。

途中のダウンロードを再開 -c 中断したところから続けます。

詳細オプション（4）

ダウンロード先フォルダ -P

ファイルを書き出す場所です。上のテンプレートと組み合わせるとサブフォルダも作れます。

Windows で安全なファイル名 --windows-filenames 別のシステムで動かしている場合でも、Windows が受け付けない文字を除きます。

ファイル名を切り詰める長さ --trim-filenames

ファイル名の最大長（文字数）です。

上書きしない -w すでにダウンロード済みのものは飛ばします。

フィルタ

詳細オプション（5）

これ以降に投稿 --dateafter

YYYYMMDD、または now-1month のような相対日付です。

これ以前に投稿 --datebefore

YYYYMMDD、または相対日付です。

最小サイズ --min-filesize

これより小さいものは飛ばします。5M、500K などが使えます。

最大サイズ --max-filesize

これより大きいものは飛ばします。

この数で停止 --max-downloads

停止するまでにダウンロードするファイル数です。

ネットワーク

速度制限 -r

たとえば 2M や 500K。残りの帯域を他のことに使いたいときに役立ちます。

詳細オプション（5）

並列 fragment 数 -N

分割されたストリームを速くします。まずは 4 くらいが妥当です。

リトライ回数 -R

失敗した部分を何回やり直すか。infinite も指定できます。

Proxy --proxy

HTTP・HTTPS・SOCKS proxy の URL です。

地域制限を回避 --geo-bypass リクエストの発信元を偽装します。一部のサイトでは有効ですが、すべてではありません。

ブラウザに偽装 --impersonate

リクエストを実際のブラウザからのものに見せます。突然 403 が出たときの定番の対処です。

ログインと cookies

ブラウザから cookies を読む --cookies-from-browser

ログイン中のセッションを直接読みます。非公開・年齢制限・メンバー限定のコンテンツには必要です。

詳細オプション（1）

cookies ファイル --cookies

ブラウザから書き出した Netscape 形式の cookies.txt です。

ライブ配信

詳細オプション（2）

配信の最初から録る --live-from-start 現在の時点ではなく、ライブ配信の最初から録画します。

配信の開始を待つ --wait-for-video

予定されている配信が始まるまで問い合わせ続けます。MIN-MAX は確認の間隔（秒）です。

回避策

詳細オプション（3）

User agent --user-agent 非推奨

非推奨で、--add-headers に置き換わりました。古い解説記事がまだ多く使っているので残してあります。

Referer --referer 非推奨

非推奨で、--add-headers に置き換わりました。

extractor の引数 --extractor-args

サイトごとの専用オプションです。たとえば youtube:player_client=web。

出力とデバッグ

フォーマット一覧だけ表示 -F 利用できるフォーマットを出力して、ダウンロードせずに終了します。

詳細オプション（2）

エラーでも続行 -i 失敗した項目を飛ばして止まりません。大きな再生リストでは欠かせません。

シミュレート -s ファイルを書き出す以外のすべてを行います。

リセット

ここで効いてくるオプション

最大画質 -f 高さの上限を決めます。yt-dlp はその上限以下で最良のストリームを選びます。
Container --merge-output-format 分かれている映像と音声のストリームを結合して入れるファイル形式です。
区間を削除 --sponsorblock-remove SponsorBlock のデータをもとに、コミュニティが印を付けた区間をファイルから切り取ります。
字幕埋め込みは字幕を動画の中に入れ、保存は隣に別の .srt ファイルを書き出します。

YouTube のどこが特殊なのか

720p を超えると、YouTube は映像と音声を別々のストリームとして配信します。そのため 1080p や 4K を求めるコマンドは両方を取って結合する必要があり、これが 720p 超では ffmpeg が必須で、それ以下では不要な理由です。このページのプリセットはすでにそう組んであります。

YouTube でもう一つ知っておく価値があるのはボット確認です。これが出たときは、ブラウザへの偽装がいちばん多くの場合に効き、あとは自分の cookies を渡せば残りも片付きます —— 年齢制限、メンバー限定、非公開の動画はいずれもログイン済みのセッションを必要とします。

よくある質問

› YouTube を 1080p や 4K でダウンロードするには？

720p を超えると YouTube は映像と音声を別ストリームで配信するので、コマンドは両方を要求して結合する必要があり、それには ffmpeg が必要です。上で解像度を選べば、ジェネレーターが selector と container を書いてくれます。

› YouTube にボットでないことの確認を求められます。

--impersonate chrome を付けるか、ログイン済みセッションを再利用する --cookies-from-browser chrome を使ってください。先にブラウザを閉じてください —— Chrome は起動中に cookies のデータベースをロックします。

› 音声だけを MP3 で取るには？

出力を「音声のみ」にして MP3 を選びます。カバー画像とメタデータを足せば、音楽ライブラリにそのまま入る状態で届きます。ffmpeg が必要です。

› 再生リスト全体をダウンロードするには？

再生リストの扱いを「再生リスト全体」にします。長い場合は記録ファイルを足して、再実行がやり直しではなく続きになるようにし、さらに「エラーでも続行」を入れて、1 本のブロックされた動画が残り全部を止めないようにします。

› YouTube の字幕はダウンロードできますか？

できます —— 動画に埋め込むか、別の .srt として。自動生成字幕も有効にしてください。そうしないと人の字幕がない動画からは何も得られません。