コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

ガイド

日常作業で使う yt-dlp コマンド

動画、音声、字幕、データセット、収集の再開に使えるコマンドをコピーできます。

このページの内容

設定・コマンドコンベンション

夜間と完全な依存から始まる
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

ダウンロードレシピは、ベースラインとしてDenoと --impersonate="" を使用します。次に curl-cffi を必要とし、利用可能なブラウザーフィンガープリントを選択することができます。Linux/macOS 命令は Bash シンタックスを使用し、予定されているワーカーには、そのサービス環境でこれらの依存性も提供します。

これらのターミナル例は、Pythonのインストールを使用します yt-dlp。仮想環境Pythonを使用するか、Python -m yt_dlp を単一のコマンド yt-dlp で置き換える。まずは、設定ガイドに macOS と Windows の代替品を含む Linux を使用します。合併のための FFmpeg/ffprobe をインストールし、YouTube の課題解決のための Deno をインストールします。例 URL をソースに置き換える。

条約なぜ重要なのか
URLとテンプレートを引用するシェルは、&、スペースやパレンテージなどのキャラクターを解釈します。
%(ext)s をフィルネームに保存する選択されたメディアとプロセッサ後のプロセスは、延長を決定します。
時計 URL に使用する --no-playlistプレイリストからリンクされたビデオは、あなたの仕事を意外に拡大しないでください。
保存された設定をチェック例はグローバルなコフィグを相続することがあります. 隔離テストのために --ignore-config を使用します。
Windows .bat: ダブルテンプレートパーセント サインバッチファイルに%(ID)を使用するが、インタラクティブ PowerShell と通常の設定ファイルに %(ID)を使用する。

動画の品質と MP4

ベースライン: 最新の夜間、DenoとFFmpeg、 --impersonate="". レシピは Bash を使用し、サンプル URL をソースに置き換えます。

デフォルト選択で1つのビデオをダウンロード
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
利用可能なストリームを選択する yt-dlp のデフォルトを使用します. コンテナは必ずしも MP4 ではありません。
利用可能なフォーマットのリスト
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
コデックと audio-only/video-only ラインをチェックします. 数値形式 ID は、ポータブル出力ポリシーではありません。
1080p を好む
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
優先順位:ターゲットの下または上にフォーマットが利用できない場合は、ランキングはその上に1つを選択することができます。
最大 1080p を有効にする
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
フィルター: フォーマットが合わない場合に失敗します. ソースコデックの選択を保持します。
H.264 ビデオと AAC オーディオの MP4
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
  --merge-output-format mp4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
厳格なコデック選択: 合成形式と FFmpeg を必要とし、別々の流合を必要とします。

データセット: MP4 + キャプション + メタデータ

最高のビデオ + オーディオ、MP4、キャプションとメタデータ
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bestvideo+bestaudio/best" --merge-output-format mp4 --remux-video mp4 \
  --write-info-json --write-subs --write-auto-subs --sub-langs "en" --sub-format "vtt/best" \
  --sleep-subtitles 5 --concurrent-fragments 1 -P dataset -o "%(id)s/%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg は、ソースストリームを合併します. MP4 は、ソースコデックを保存し、デコダードの互換性とタイトルカバーを別々にチェックします。

外部ダウンロード: aria2c

2つの接続、先住民DASH/HLS
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --downloader aria2c \
  --downloader "dash,m3u8:native" --downloader-args "aria2c:-x 2 -s 2 -j 1" \
  --concurrent-fragments 1 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
aria2c の実行ファイルが必要です。動画 1 本のダウンロードを確認してから接続数を増やし、403 が出たらすぐに減らしてください。

aria2は独自のネットワーク実装を持っています. yt-dlpの curl-cffiのインパルソングは aria2の指紋を設定しません。外部ダウンロードのみが失敗した場合、 --downloader native を使用して同じソースとプロキシルートを比較します。

オーディオとMP3

オリジナルオーディオストリームを保存
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
MP3 変換はありません. あなたのトランスクリプションまたは再生パイプラインがオリジナルのコデックを受け入れるときに役立ちます。
ターゲットビットレートで MP3 に変換する
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 192K -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg を使用する 192K は出力コードを制御し、ソースの品質を回復しない。
M4Aは、トランスコードなしで
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
M4A 単なるオーディオ形式が利用できない場合は失敗します. アプリケーションが他のソースコンテナを受け入れる場合にのみ /ba を追加します。
MP3 内蔵メタデータとカバー
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --embed-metadata --embed-thumbnail -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
metadata/thumbnail ステップは追加のプロセッサ後です 最終ファイルをチェックし、転送ホークだけではありません。

キャプテンとサブタイトル

利用可能なトラックのリスト
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
このソースが提供する言語タグを読んで、選択する前に --sub-langs を選択します。
ダウンロード 提供された英語のサブタイトルのみ
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --sub-langs "en.*" --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
自動キャプションに戻ってこないし、メディアをダウンロードしない。
自動英語キャプチャも許可
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" -P captions \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
en.* 複数の英語のバージョンと一致する可能性があります. これは利用可能なトラックを取得します. 言語認識を実行しません。
選択したトラックを SRT に変換する
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en" --convert-subs srt -P captions \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg が必要です. 必要に応じて --list-subs から別の言語コードを選択します。
入力したサブタイトルを MKV に挿入する
python -m yt_dlp --js-runtimes deno --impersonate="" --write-subs --sub-langs "en" \
  --embed-subs --remux-video mkv -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
メディアをダウンロードし、英語のサブタイトルを提供するリクエストをダウンロードし、利用可能なトラックを入力します。

すべてのタイトル言語を要求することは、要求やファイルの数を大幅に増やすことができます。ルーチン作業のための言語を明確に保つ。データセットの記録にソースIDと言語を保存して、トランスクリプトが描かれているメディアから分離されないようにします。

メタデータと出力パス

動画のメタデータを JSON として印刷します。
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
ダウンロードをデフォルトでシミュレーションしますが、抽出を実行します. リダイレクトは video.json を置き換えます。
メディアなしで完全なメタデータサイドカラーを書く
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-info-json \
  -P metadata -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
.info.json サイドカバーを作成します. これは、プロジェクトフィールドを公開する前に、オペレーティングエクストラクターデータです。
ダウンロード トンネルだけ
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-thumbnail \
  -P thumbnails -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
利用可能な小型をソース形式で保存します. --convert-thumbnails jpg は JPEG が必要なときに変換ステップを追加します。
処理後最終メディアパスを印刷
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print after_move:filepath -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
デフォルトステージ--printとは異なり、プリントafter_moveは実際のダウンロードとその最終動きを待っています。
完成した道をマニフェストに追加する
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print-to-file after_move:filepath completed-paths.txt -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
追加するので、リトリウムは繰り返し入力を生成することができます. 完成記録として扱い、デドプリカートされた記録ではなく。

タイムランキングと章

ダウンロード秒 5 から 10
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" -o "clips/%(id)s-%(section_start)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
必要性 FFmpeg. クリップの限界は利用可能なキーフレームと調和することができます; 正確なタイミングが重要なときに出力を確認します。
リクエストされたカットの周りを再編
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" --force-keyframes-at-cuts \
  -o "clips/%(id)s-%(section_start)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
再編集作業を追加して、要求された範囲で切断を改善します。 結果の期間と audio/video 調和をチェックします。
動画をファイルに分割する
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
  "https://www.youtube.com/watch?v=YOUR_VIDEO_ID"
章のメタデータを含むビデオを使用します 章の出力は、オリジナルの完全ダウンロードから分離されます; 両方のための予算ディスクスペース。

クリップや完全なビデオのための別の出力ポリシーまたはアーカイブを使用します. ソースレベルのアーカイブの入力は、選択した start/end タイミングを暗号化しませんので、共有されたアーカイブは、作成する予定の後のクリップを削除することができます。

プレイリストとURLリスト

知られているURLリストをダウンロード
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
ラインごとに1 つのウォッチ URL を含む UTF-8 ファイルを作成します. --no-playlist は、プレイリストの文脈を含む URL を表示するために適用されます。
YouTube プレーリストを完全なビデオ抽出なしでチェックする
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
1 つの JSON オブジェクト 入力ごとに フラット 入力は、期間および形式の詳細を無視することができます。
最初の5つのプレイリストの入力をダウンロード
python -m yt_dlp --playlist-items 1:5 -P collection -o "%(playlist_index)03d-%(id)s.%(ext)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID"
プレイリストの指標は、オーダーではなくアイデンティティを表示します. ファイル名にビデオIDを保持します。
適切なビデオの日付と期間を制限する
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
未生の項目を必要とし、知られている期間は 30 分まで、日付または1月以降 1、 2026 にあります。
10 ダウンロード後停止
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
制限は、新しくダウンロードされたファイルを制御するが、何件の listing/extraction リクエストが発生するかはわからない。

アーカイブと回復

同じポリシーでコレクションを再編する
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
  -o "%(id)s.%(ext)s" --batch-file urls.txt
完成したIDは無効です。部分ダウンロードはサポートされている場所に再起動します. オリジナルの仕事と同じアーカイブと出力パスを使用します。
ワーカーを平和にし、退職を結びつける。
python -m yt_dlp --sleep-requests 1 --sleep-interval 5 --max-sleep-interval 10 --retries 3 \
  --fragment-retries 3 --socket-timeout 30 --batch-file urls.txt
複数のプロセスがルートまたはセッションを共有する場合、クイーレベルのワーカー制限を追加します。
バンドバンド 転送
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
メディア転送率を制御する. 抽出要請の数を制御しない。
原産地分割競争の減少
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
調査の際は、一つの段落で始める 403s. 他のワーカープロセスは、まだそれらの独自の同期の要請を追加します。

設定とフィルネーム

単にあなたの明確なコレクションのコフィグをアップロードする
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
明示的に名付けられたコフィグは --ignore-config でさえ充電されます。
安定したアイデンティティを持つ読みやすい名前
python -m yt_dlp --js-runtimes deno --impersonate="" -P downloads \
  -o "%(channel_id)s/%(upload_date)s-%(title).150B [%(id)s].%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
タイトルはこのテンプレートで 150 バイットに変換されます. IDs は複製または変更するタイトルを区別します。
別々の暫定ディレクトリを使用する
python -m yt_dlp --js-runtimes deno --impersonate="" -P "home:downloads" -P "temp:work" \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
最終的な動きは処理後に起こります. 両方のディレクトリに十分なスペースがあることを確認します. 異なるファイルシステムにはコピーが必要になる可能性があります。

長寿のコレクションでは、フィルネームが人間に読み取れるか安定したアプリケーションキーであるかどうかを決定します。チャンネルの名前やタイトルが変わる。Channel/videoIDは、メタデータに保存されている説明フィールドで、デダプリケーションのためのより良いキーです。

クッキーとランタイムパス

アクセスできるブラウザプロファイルを使用する
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
プロフィール1を実際のブラウザプロフィールに置き換え、セッションクッキーは必要に応じてのみ使用し、プライベートに保管します。
既存のプライベートクッキーファイルを読む
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Netscape クッキーファイル形式を必要とします. JSON エクスポートは同等ではありません。
ワーカーパトの外で実行可能なDenoを使用する
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
あなたのワーカーにインストールされたDenoバイナリでコースを置き換える。

診断と検証

清潔な抽出物の検査
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
インプラントの設定を削除し、メディアを保存しない。それはまだ抽出要請を行い、転送が成功することを証明しません。
プライベート診断記録を取得
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw" > diagnostic.log 2>&1
リダイレクトは、ログを置き換える 編集 cookie/header 値、プロキシ認証、および共有前に署名された URL を変更します。
保存された流れと期間をチェック
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
最後の道を使用して、処理後です。 ffprobe ヘッドウェアを読み、それぞれのフレームを解読することはありません。
保存されたファイルを解読し、出力を作成しない
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
ファイル全体を読み取るより深いチェック 出力状態とメッセージをチェックします。
Python パッケージを更新してバージョンをチェック
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version