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

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

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/yt-dlp-commands
レビュー: FlashData による 2026-11-13

- [動画と音声](https://flashdata.dev/ja/docs/guides/yt-dlp-commands/reference.md#video) — 品質、コデックと MP3
- [キャプションとメタデータ](https://flashdata.dev/ja/docs/guides/yt-dlp-commands/reference.md#subtitles) — シドカルと構造化された生産
- [収集と回復](https://flashdata.dev/ja/docs/guides/yt-dlp-commands/reference.md#archives) — リスト、アーカイブ、Config
- [失敗の診断](https://flashdata.dev/ja/docs/guides/yt-dlp-commands/reference.md#diagnostics) — ログと出力確認

<a id="conventions"></a>

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


**夜間と完全な依存から始まる**

```bash
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)を使用する。 |

- [ツールをインストール](https://flashdata.dev/ja/docs/guides/how-to-use-yt-dlp/reference.md#install)
- [再利用可能なコレクション構成](https://flashdata.dev/ja/docs/guides/how-to-use-yt-dlp/reference.md#repeatable)

<a id="video"></a>

## 動画の品質と MP4


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

**デフォルト選択で1つのビデオをダウンロード**

```bash
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 ではありません。

**利用可能なフォーマットのリスト**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

コデックと audio-only/video-only ラインをチェックします. 数値形式 ID は、ポータブル出力ポリシーではありません。

**1080p を好む**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

優先順位:ターゲットの下または上にフォーマットが利用できない場合は、ランキングはその上に1つを選択することができます。

**最大 1080p を有効にする**

```bash
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**

```bash
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 を必要とし、別々の流合を必要とします。

> **コンテナはコデックではない。**
> --merge-output-format 混合コンテナを選択します. --remux-video 互換性のあるストリームを再包装します。AV1 を H.264 に変換するものではありません。デコデッカーが特定のコデックを必要とする場合、そのコデックを選択するか、別々のトランスコードを計画します。

- [選択者と fallbacks を理解する](https://flashdata.dev/ja/docs/guides/how-to-use-yt-dlp/reference.md#formats)

<a id="dataset"></a>

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


**最高のビデオ + オーディオ、MP4、キャプションとメタデータ**

```bash
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 は、ソースコデックを保存し、デコダードの互換性とタイトルカバーを別々にチェックします。

- [データセット出力ポリシーと欠けているキャプション](https://flashdata.dev/ja/docs/guides/how-to-use-yt-dlp/reference.md#dataset)
- [同等のPythonデータセットのオプション](https://flashdata.dev/ja/docs/guides/yt-dlp-python-api/reference.md#dataset)

<a id="aria2"></a>

## 外部ダウンロード: aria2c


**2つの接続、先住民DASH/HLS**

```bash
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 を使用して同じソースとプロキシルートを比較します。

- [接続コントロールと通過診断](https://flashdata.dev/ja/docs/guides/how-to-use-yt-dlp/reference.md#aria2)

<a id="audio"></a>

## オーディオとMP3


**オリジナルオーディオストリームを保存**

```bash
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 に変換する**

```bash
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は、トランスコードなしで**

```bash
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 内蔵メタデータとカバー**

```bash
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 ステップは追加のプロセッサ後です 最終ファイルをチェックし、転送ホークだけではありません。

<a id="subtitles"></a>

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


**利用可能なトラックのリスト**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

このソースが提供する言語タグを読んで、選択する前に --sub-langs を選択します。

**ダウンロード 提供された英語のサブタイトルのみ**

```bash
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"
```

自動キャプションに戻ってこないし、メディアをダウンロードしない。

**自動英語キャプチャも許可**

```bash
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 に変換する**

```bash
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 に挿入する**

```bash
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と言語を保存して、トランスクリプトが描かれているメディアから分離されないようにします。

<a id="metadata"></a>

## メタデータと出力パス


**動画のメタデータを JSON として印刷します。**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
```

ダウンロードをデフォルトでシミュレーションしますが、抽出を実行します. リダイレクトは video.json を置き換えます。

**メディアなしで完全なメタデータサイドカラーを書く**

```bash
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 サイドカバーを作成します. これは、プロジェクトフィールドを公開する前に、オペレーティングエクストラクターデータです。

**ダウンロード トンネルだけ**

```bash
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 が必要なときに変換ステップを追加します。

**処理後最終メディアパスを印刷**

```bash
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は実際のダウンロードとその最終動きを待っています。

**完成した道をマニフェストに追加する**

```bash
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"
```

追加するので、リトリウムは繰り返し入力を生成することができます. 完成記録として扱い、デドプリカートされた記録ではなく。

- [Python メタデータプロジェクション](https://flashdata.dev/ja/docs/guides/yt-dlp-python-api/reference.md#metadata)

<a id="clips"></a>

## タイムランキングと章


**ダウンロード秒 5 から 10**

```bash
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. クリップの限界は利用可能なキーフレームと調和することができます; 正確なタイミングが重要なときに出力を確認します。

**リクエストされたカットの周りを再編**

```bash
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 調和をチェックします。

**動画をファイルに分割する**

```bash
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 タイミングを暗号化しませんので、共有されたアーカイブは、作成する予定の後のクリップを削除することができます。

<a id="playlists"></a>

## プレイリストとURLリスト


**知られているURLリストをダウンロード**

```bash
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 プレーリストを完全なビデオ抽出なしでチェックする**

```bash
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
```

1 つの JSON オブジェクト 入力ごとに フラット 入力は、期間および形式の詳細を無視することができます。

**最初の5つのプレイリストの入力をダウンロード**

```bash
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を保持します。

**適切なビデオの日付と期間を制限する**

```bash
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
```

未生の項目を必要とし、知られている期間は 30 分まで、日付または1月以降 1、 2026 にあります。

**10 ダウンロード後停止**

```bash
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
```

制限は、新しくダウンロードされたファイルを制御するが、何件の listing/extraction リクエストが発生するかはわからない。

<a id="archives"></a>

## アーカイブと回復


**同じポリシーでコレクションを再編する**

```bash
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は無効です。部分ダウンロードはサポートされている場所に再起動します. オリジナルの仕事と同じアーカイブと出力パスを使用します。

**ワーカーを平和にし、退職を結びつける。**

```bash
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
```

複数のプロセスがルートまたはセッションを共有する場合、クイーレベルのワーカー制限を追加します。

**バンドバンド 転送**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

メディア転送率を制御する. 抽出要請の数を制御しない。

**原産地分割競争の減少**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

調査の際は、一つの段落で始める 403s. 他のワーカープロセスは、まだそれらの独自の同期の要請を追加します。

> **ファイルには具体的な仕事があります。**
> 成功したダウンロード後に extractor/video ID を記録します。これは、出力設定のカタログやファイルがまだ存在していることをチェックするものではありません。オーディオ、ビデオ、クリップのポリシーのための別々のアーカイブを保持し、失敗した作業を --force-write-archive で完了しないでください。

- [再利用可能なコントロール・回復手順](https://flashdata.dev/ja/docs/guides/how-to-use-yt-dlp/reference.md#repeatable)

<a id="configuration"></a>

## 設定とフィルネーム


**単にあなたの明確なコレクションのコフィグをアップロードする**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
```

明示的に名付けられたコフィグは --ignore-config でさえ充電されます。

**安定したアイデンティティを持つ読みやすい名前**

```bash
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 は複製または変更するタイトルを区別します。

**別々の暫定ディレクトリを使用する**

```bash
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は、メタデータに保存されている説明フィールドで、デダプリケーションのためのより良いキーです。

<a id="session"></a>

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


**アクセスできるブラウザプロファイルを使用する**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

プロフィール1を実際のブラウザプロフィールに置き換え、セッションクッキーは必要に応じてのみ使用し、プライベートに保管します。

**既存のプライベートクッキーファイルを読む**

```bash
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を使用する**

```bash
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

あなたのワーカーにインストールされたDenoバイナリでコースを置き換える。

- [Cookie ロード、終了、ボットチェック](https://flashdata.dev/ja/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)

<a id="diagnostics"></a>

## 診断と検証


**清潔な抽出物の検査**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

インプラントの設定を削除し、メディアを保存しない。それはまだ抽出要請を行い、転送が成功することを証明しません。

**プライベート診断記録を取得**

```bash
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 を変更します。

**保存された流れと期間をチェック**

```bash
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
```

最後の道を使用して、処理後です。 ffprobe ヘッドウェアを読み、それぞれのフレームを解読することはありません。

**保存されたファイルを解読し、出力を作成しない**

```bash
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
```

ファイル全体を読み取るより深いチェック 出力状態とメッセージをチェックします。

**Python パッケージを更新してバージョンをチェック**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
```

- [403 ステージによる診断](https://flashdata.dev/ja/docs/guides/yt-dlp-403-forbidden/reference.md)
- [429:メタデータとタイトルリクエストの制限](https://flashdata.dev/ja/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [ボットチェックの回答を確認する](https://flashdata.dev/ja/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [オプションの完全なアップストリーム参照](https://github.com/yt-dlp/yt-dlp#usage-and-options)
