詳細な説明は
GitHub - yt-dlp/yt-dlp: A feature-rich command-line audio/video downloader(公式ページ)
もしくは
yt-dlp オプション一覧及びそのメモ - †MASAYOSHI†のオンラインメモ帳(日本語の解説)
を参照のこと。
Youtube以外にも様々なサイトに対応している(対応サイトのリスト)。
基本
yt-dlp URL
動画のURLだけでなく、チャンネルやプレイリストのURLも指定できる。
(チャンネルやプレイリストを指定した場合、デフォルトではダウンロードできる全動画をダウンロードする)
オプションを指定しないで使っても支障はないので、気にしなくても問題ない。
音声ファイルに変換
-x, --extract-audio出力ファイル名
-o ファイル名文字列を指定すればそのままの名前で出力される。テンプレートで色々指定することもできる(ここを参照)
インターバル
--sleep-interval 数字ダウンロードごとに指定した秒数だけ待機する(プレイリストなど、複数の動画をダウンロードするときのみ)
Cookieの設定
ログインしないと見られないような動画に使う。ブラウザ側でログインしてから実行すること。--cookies FILE
もしくは
--cookies-from-browser BROWSER
FILEにはCookieファイル、BROWSERにはブラウザ名を指定する。
指定できるブラウザ名はbrave、chrome、chromium、edge、firefox、opera、safari、vivaldi
ユーザー名、パスワード
Cookie設定ではなく、直接ユーザー名とパスワードを指定してログインすることも可能。-u, --username USERNAME
-p, --password PASSWORD
ダウンロードする動画の指定
プレイリストなど、複数の動画をダウンロードするときに使う。 --datebefore DATE
日付以前にアップロードされた動画だけダウンロード。
--dateafter DATE
日付以後にアップロードされた動画だけダウンロード。
※DATEはYYYYMMDD形式でOK
--match-title REGEX
正規表現にマッチしたタイトルの動画だけをダウンロード。
--reject-title REGEX
正規表現にマッチしたタイトルの動画以外をダウンロード。
--min-views COUNT
--max-views COUNT
ダウンロードする動画の最小(最大)視聴回数を指定。
--match-filter FILTER
フィルターでダウンロードする動画を指定する(フィルターの書き方は公式ページを参照のこと)
--download-archive FILE
指定したファイルにダウンロードするファイルを記録する。2回目以降に同じファイルを指定すると、記録済の動画はスキップされる。(チャンネルの更新分だけダウンロードしたいときなどに使う)
複数動画のダウンロード
-a, --batch-file FILEFILEにテキストファイルを指定する。一行に一URLずつ書いておけば、テキストファイル内のURLの動画がすべてダウンロードされる。
フォーマット(画質、音質)の指定
デフォルトで最高画質・最高音質が指定されるのであまり気にしなくても良い。-F, --list-formats
動画のダウンロードは行わず、指定できるフォーマットを表示する。
フォーマットの指定方法
-f 数字上の-Fオプションで確認した数字を指定。videoのフォーマットとaudioのフォーマットを+で組み合わせる(-f 315+251みたいに)
-f bestvideo*+bestaudio/best
最高画質・最高音質でダウンロード(デフォルト)。
-f "bestvideo[height<=1440]+bestaudio/best"
1440p以下で最も良い画質と、最高音質でダウンロード。
フォーマットの指定方法は非常に複雑なので、詳しく知りたいなら公式ページの解説を参照のこと。
ライブ配信
--live-from-startライブ配信を最初からダウンロード。
--wait-for-video 数字
ライブ配信が開始するまで待機する。指定した秒数ごとにリトライして開始したかどうか確認する。
その他
-i, --ignore-errorsエラーを無視して実行を続ける。プレイリストのダウンロード中に、エラーが起きて止まるのを避けたいときに使うといいかもしれない。
-w, --no-overwrites
ファイルを上書きしない。
--embed-thumbnail
サムネイルを動画ファイルに埋め込む。
--embed-subs
字幕を動画ファイルに埋め込む。
--sub-langs LANGS
字幕の言語を指定。--sub-langs allですべての字幕をダウンロードする。
--embed-chapters
チャプターを動画に埋め込む。
--embed-metadata
メタデータを動画に埋め込む。
--user-agent UA
ユーザーエージェントを設定する。
--proxy URL
プロキシを設定する。
-U, --update
yt-dlpを最新版にアップデートする。
-h, --help
オプション一覧を表示する。