# So verwendest du yt-dlp

Ein Linux-orientierter Ablauf für tägliche Downloads mit Nightly-Installation, Formaten, Untertiteln, Datensätzen und fortsetzbaren Sammlungen.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/how-to-use-yt-dlp
Test: 2026-11-13 von FlashData

- [Setzen Sie die Tools](https://flashdata.dev/de/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg und JavaScript
- [Wählen Sie die Produktion](https://flashdata.dev/de/docs/guides/how-to-use-yt-dlp/reference.md#formats) — Video, Audio und Captions
- [Wiederholen Sie eine Sammlung](https://flashdata.dev/de/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — Manifest, Konfig und Archiv
- [Fixieren Sie einen erfolglosen Rennen](https://flashdata.dev/de/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — Die richtige Diagnose finden

<a id="install"></a>

## Installation der täglichen Baseline


**Start mit Nacht + Deno + FFmpeg.** Verwenden Sie eine Projektvirtuelle Umgebung und ermöglichen Sie die Browser-Impersonen mit `--impersonate=""`. Die Linux-Setup unten installiert die Tools; macOS und Windows-Alternativen sind in den Tabs.

**Linux**

Ubuntu / Debian Beispiel mit Python 3.11+. Installieren Sie die Systemtools, erstellen Sie eine virtuelle Umgebung des Projekts, installieren Sie dann die aktuelle Nacht und seine Extras.


**Linux-Arbeiter auf**

```bash
sudo apt-get update
sudo apt-get install -y python3 python3-venv ffmpeg aria2 curl unzip
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
curl -fsSL https://deno.land/install.sh -o /tmp/install-deno.sh
sh /tmp/install-deno.sh
export PATH="$HOME/.deno/bin:$PATH"
deno --version
python -m yt_dlp --version
```


**macOS**

Mit Homebrew installiert, verwenden Sie es für Python, Deno, FFmpeg und aria2. Halten Sie yt-dlp selbst in der Projektumgebung, so dass die Nacht-Update-Kommandos identisch ist wie auf Linux.


**MacOS Setup**

```bash
brew install python deno ffmpeg aria2
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
python -m yt_dlp --version
```


**Windows · PowerShell**

Installieren Sie Python 3.11+, Deno und die FFmpeg-Exekutables, öffnen Sie dann ein neues Terminal. Verwenden Sie den Umweltinterpreter direkt, wenn PowerShell die Aktivierung blockiert. aria2 ist optionale; installieren Sie es separat, wenn Sie das External-Downloader-Rezept verwenden.


**Windows Umwelt**

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
.\.venv\Scripts\python.exe -m yt_dlp --version
```


| Werkzeug | Was es tut | Überprüfung |
| --- | --- | --- |
| Python 3.11+ | Die Python-Pakete und Beispiele in dieser Serie. | python --version |
| Letzte yt-dlp Nacht + Standard,curl-cffi Extra | Aktueller YouTube-Extraktor, EJS-Löser und Browser-Impersonen-Support. | python -m yt_dlp --version |
| FFmpeg und ffprobe | Machen Sie Streams zusammen, konvertieren Sie Audio, schneiden Sie Clips und überprüfen Sie gespeicherte Medien. | ffmpeg -version / ffprobe -version |
| Deno 2.3+ (in diesem Workflow erforderlich) | YouTube-Triffe: Installieren Sie es auf jedem Arbeitnehmer, nicht nur auf Ihrem Entwicklungsmaschine. | deno --version |

**Installieren Sie auch die Ausführer.** `[default]` liefert die EJS-Scripts; Deno ist getrennt. FFmpeg und ffprobe müssen auch auf dem Arbeiters PATH sein.

**Überprüfen Sie die vollständige Baseline**

```bash
deno --version
ffmpeg -version
ffprobe -version
python -m pip show yt-dlp yt-dlp-ejs curl-cffi
python -m yt_dlp --list-impersonate-targets
```

Die endgültige Befehl sollte verfügbare Browserziele aufzeichnen.Wenn Ziele nicht verfügbar sind, überprüfen Sie, dass curl-cffi in diesem genauen virtuellen Umfeld installiert ist.

**Test-Extraktion mit Deno und Browser-Impersonen**

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

Inspektieren Sie die JS-Runtime und die Anfrage-Handler-Linien. Eine Simulation testen die Extraction; folgen Sie es mit einer echten Übertragung.

Die Betriebssteile von FlashData enthält --impersonate=": es ermöglicht curl-cffi, ein verfügbares Browser-Fingerprint auszuwählen. Dies ändert das Antragsfingerabdruck; es bietet keine Login-Cookies, löst JavaScript-Probleme oder ändert die IP-Ausgang. Wenn diese Option eine Arbeitsroute verlangsamt oder Fehler eingeben, wiederholen Sie das gleiche ein-Video-Test ohne sie und halten Sie die Arbeitskonfiguration.

> **Ein Dienst braucht seinen eigenen Weg**
> Der Deno-Installator setzt normalerweise die binäre in ~/.deno/bin. Eine interaktive Schelle, die sie findet, beweist nicht, dass ein Systemd Service, Container oder Cron Job kann. Setzt den Arbeiter PATH oder Pass --js-runtimes deno:/absolute/path/to/deno. Verwenden Sie den Python-Path der virtuellen Umgebung im Service-Command.

- [Offizielle Installation](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg Download zu finden](https://ffmpeg.org/download.html)
- [Installation von Deno](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube Runtime-System](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

<a id="verify-install"></a>

### Überprüfen Sie die Freisetzung, bevor Sie sie auf einen Arbeitnehmer legen


Erhalten Sie Exekutables von der offiziellen Projekt-Ausgabeseite oder installieren Sie das Python-Paket von seiner veröffentlichten Paketquelle. Wenn Sie eine einzelne binäre Download, vergleichen Sie ihre SHA-256 mit dem matching filename in der SHA2-256SUMS dieser Release. Erregt die Release und die Check-in mit deinem Arbeiter-Bild, damit du genau identifizieren kannst, was ging.

**Linux**


**Hash die heruntergeladenen Datei**

```bash
sha256sum yt-dlp
```


**macOS**


**Hash die heruntergeladenen Datei**

```bash
shasum -a 256 yt-dlp_macos
```


**Windows**


**Hash die heruntergeladenen Datei**

```powershell
Get-FileHash -Algorithm SHA256 .\yt-dlp.exe
```


Eine Checksum-Vergleich ist nur nützlich, wenn der erwartete Wert aus dem vertrauenswürdigen Release kommt, nicht das gleiche unbekannte Spiegel wie das Ausführbare. Wenn die Sicherheitssoftware eine Datei steckt, prüfen Sie die Quelle und melden Sie vor der Erstellung einer Ausnahme. Die Offen-Source-Zugang allein ist nicht ein Beweis dafür, dass jedes heruntergeladenes binäre oder Drittanbieter-Plugin sicher ist.

Verarbeiten Sie die gemeinsamen Konfigurationsdateien als Code zu überprüfen: Optionen wie --exec können Befehl starten, und Plugins geben Code zum Download-Prozess hinzu. Bewahren Sie Browser-Cookies, Proxy-Kreditationen und unterzeichneten URLs von Konfigurationsvorlagen und diagnostischen Berichten.

- [Offizielle Veröffentlichungen und Checksums](https://github.com/yt-dlp/yt-dlp/releases)

<a id="first-download"></a>

## 1 Video herunterladen


**Nutzen Sie ein kurzes Video zuerst.** Zitieren Sie die URL, fügen Sie `--no-playlist` hinzu und nennen Sie die Datei durch Video-ID. Die Befehl Druck der endgültigen Weg nach der Mischung und Post-Verarbeitung.

**Ein Video, ein Ausgangsfolder**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" --print after_move:filepath \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Der gedruckte Weg ist die Datei nach der Fusion und nach der Verarbeitung. öffnen Sie diese Path; nicht davon aus, dass die Datei in .mp4 endet.

Ohne eine Format-Überride wählt yt-dlp seine bevorzugten verfügbaren Streams. Hochwertige Quellen haben oft separate Video- und Audioströme, so dass zwei Übertragungen, die durch eine FFmpeg Fusion folgen, normal sind. Zwischenfälle und eine .part-Datei können während der Arbeit ausgeführt werden.

> **Lassen Sie die Erweiterung nicht hardcodes**
> Halten Sie %(ext)s in der Ausgangsvorlage.Namen eines WebM Stream file.mp4 ändern Sie nur seinen Namen.Format-Serie, Remuxing und Konvertierung entscheiden, was im Inneren des Dateien ist.

<a id="formats"></a>

## Qualität und Codecs wählen


**Überprüfen Sie die Formate dieses Videos**

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

**Wähle eine Politik, nicht ein kopiertes Format-ID.** Überprüfen Sie die Auflösung, Codecs und separate audio/video-Track.

| Selektor oder Option | Bedeutung | Wann sie zu verwenden |
| --- | --- | --- |
| Bv + Ba | Wählen Sie einen Video-nur-Stream und einen Audio-nur-Stream; FFmpeg kombiniert sie. | Du brauchst beide Spuren und kannst sie lokal zusammenführen. |
| A/B | Versuchen Sie den Selektor A, dann B, wenn A nicht verfügbar ist. | Definieren Sie einen expliciten Fallback anstatt zu vermuten, dass jede Quelle die gleichen Formate hat. |
| [height<=1080] | Ausnahmen von Stromen über 1080 Pixel hoch. | Ein hartes Oberbind ist eine Anforderung. |
| -S res:1080 | Vorzugsweise bis 1080; Sie können eine größere wählen, wenn keine unten verfügbar ist. | 1080p ist eine Vorliebe anstatt ein hartes Dach. |
| --merge-output-format mp4 | Wählen Sie den Container beim Mischung von separaten Strömen aus. | Sie haben bereits kompatible Streams ausgewählt. es macht keine Transcode-Codecs. |

**Halten Sie die Quellcode mit einem harten 1080p Dach**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Dies kann WebM, MP4 oder andere unterstützte Container produzieren. Es failliert, wenn kein Format den Dach erfüllt; es lüft nicht still herunter 4K.

Für einen Editor oder Playback Stack, der speziell H.264 Video und AAC Audio erfordert, filtern Sie diese Codecs und fusionieren Sie sich in MP4. MP4 ist ein Container: Ein Stream in einem MP4 Container kann noch einen Codec enthalten, der Ihre Anwendung nicht dekodieren kann.

**Bitte H.264 + AAC, bis 1080p**

```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 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Wenn die erforderlichen Codecs nicht verfügbar sind, wird dieser strenge Selektor versagt. entscheiden Sie, ob Sie verschiedene Quellcode oder Transcode akzeptieren; entfernen Sie nicht die Anforderung durch Unfall.

Remuxing repackages Streams ohne sie neu zu verschlüsseln. Transcoding ändert Codecs und verbraucht CPU, während die Qualität potentiell verändert. Verwenden Sie --remux-video, wenn die Ströme bereits den Zielcontainer passen; verwenden Sie eine absichtliche FFmpeg-Konvertierung, wenn ein Downstream-Decoder verschiedene Codecs erfordert.

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

## Speichern Sie Audio oder MP3


Wenn Ihr Transcription-Pipeline den Quell-Audio-Codec akzeptiert, laden Sie diesen Stream direkt herunter. Dies verhindert eine unnötige Verlustkonversion. MP3 ist nützlich, wenn ein Verbraucher es speziell verlangt; eine hohe MP3-Bitrate kann nicht die bereits verlorenen Details in der Quelle wiederherstellen.

**Halten Sie den besten verfügbaren Audio-Stream**

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

Erwartet den Quellcontainer und Codec, in der Regel M4A/AAC oder WebM/Opus.

**Konvertieren Sie Audio in MP3**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 0 -P audio -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

FFmpeg --audio-quality 0 wählt die beste Variable-Qualitätsinstellung aus; verwenden Sie eine Bitrate wie 192K, wenn Ihre Downstream-Spezifikation eine benötigt.

<a id="sidecars"></a>

## Speichern Sie Captions und Metadaten


Eine nützliche Sammlung braucht mehr als Filenamen. Halten Sie Video-IDs, Quell-URLs, Titel, Dauer und verfügbare Kaptionen, damit Sie die Sammlung suchen und ein Vermögenswert zurück zu seiner Quelle verfolgen können. Beginnen Sie mit der Liste der Nachschriftstraßen; Bewerben Sie nicht bedeutet, dass jedes Video eine englische Spur hat.

**Inspektieren Sie die Kaptionen, speichern Sie dann Englische Spuren ohne Medien**

```bash
python -m yt_dlp --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
python -m yt_dlp --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"
```

--write-subs wählt die zugelassenen Untertitel aus; --write-auto-subs erlaubt auch automatische Abschnitte. Dies erholt bestehende Spuren und übersetzt kein Video, das keine hat.

**Medien mit Metadaten und einem Miniatüre**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --write-info-json \
  --write-thumbnail -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Die .info.json Datei ist detaillierte Betriebsmetadata, nicht eine saubere öffentliche API-Reaktion. Es kann endende Medien-URLs und Anfrage-bezogene Felder umfassen. Halten Sie den vollständigen Seitenbereich mit der Sammlung und exportieren Sie nur die Felder, die Ihr Downstream-System benötigt. Wenn Sie SRT anstelle VTT brauchen, fügen Sie --convert-subs srt hinzu und stellen Sie sicher, FFmpeg ist verfügbar.

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

## Erstellen eines AI-Datenabschnittes


Für eine Trainingsammlung entscheiden Sie über die Medien und Text-Ausgänge zusammen. Eine gemeinsame Anforderung ist die beste verfügbare Video und Audio, in MP4 zusammengefasst, mit zeitgemäßen Kaptionen und Extraction-Metadaten unter dem gleichen Video-ID gehalten. Ein für Vorabschüsse nützliches Auflösungsgeld ist in der Regel die falsche Vorwahl für ein Quellqualität-Datenset.

**Download eines vollständigen Datensatz-Einhalts**

```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" \
  --print after_move:filepath "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Bash Beispiel. FFmpeg vereint separate Streams; --remux-video umfasst auch eine kombinierte Streamfall. Verwenden Sie eine genaue Sprachtag von --list-subs; ersetzen Sie en mit der Sprache, die Ihre Datenbank Bedürfnisse.

Beginnen Sie mit einer genauen Sprachschrift. In unserem Live-Check haben die En* ausgewählt, die En* und die En*; der dritte Track kehrte zurück 429 bevor die Medienunterladen begann. Ein Nachschriftfehler kann das Element in diesem Stadium stoppen. Nach einem Kälteuntergang, zurückziehen Sie nur die erforderliche Spur, oder teilen Sie Medien und Titel Jobs, wenn Ihre Sammlung muss die Medien-Einsatz bewegt halten.

Der /best fallback ermöglicht einen kombinierten video/audio-Stream, wenn separate Spuren nicht verfügbar sind. Entfernen Sie diesen Fallback, wenn Ihr Sammelvertrag separate Bestvideo und bestaudio Quellen erfordert. MP4 bedeutet nicht H.264: Dieses Rezept bewahrt die ausgewählten Quellcode. Verwenden Sie den strengsten H.264/AAC-Selector oben, wenn Ihr Training-Decoder diese Codecs oder Transcode als separate, aufgezeichneten Schritt benötigt.

**Erwartete Dateien, wenn eine Englische Nachschriftstraße existiert**

```text
dataset/VIDEO_ID/
  VIDEO_ID.mp4
  VIDEO_ID.info.json
  VIDEO_ID.en.vtt
```

Die Nachschrift suffix verwendet die tatsächliche Sprachtag. Kein Nachschriftdatei wird erstellt, wenn die gefragte Track nicht verfügbar ist; markieren Sie keine Textoberfläche vollständig nur weil die MP4 abgeschlossen ist.

| Anforderungen | Sammelbeschluss |
| --- | --- |
| Die höchste verfügbare Qualitätsqualität | Verwenden Sie bestvideo+bestaudio, halten Sie Quellcodes und überprüfen Sie die gemischten Streams mit ffprobe. |
| Timestampte Text | Halten Sie VTT/SRT Segmente und Sprache neben dem Video-ID. Flattening Text verzichtet auf die Zeitung, die für die Klip-Alignation erforderlich ist. |
| Fehlende Bildunterschriften | Speichern Sie ausdrücklich vermisst Text. Routen Sie das gespeicherte Audio in Ihre Transcription-Spiege, wenn Text obligatorisch ist. |
| Kaptionen für viele Sprachen | Alle zusätzlichen Spuren fügen Anfragen hinzu und können 429 unabhängig von Medien treffen. |
| Resumable Media + Textlieferung | Verwenden Sie ein separates Datensatz-Archiv und ein Inventor mit Medien, Metadaten und Titel-Status. Ein Archivzug beweist nicht, dass alle erforderlichen Seiten vorhanden sind. |

Verwenden Sie nicht neu ein Archiv, das von einem früheren Medien erstellt wurde, nur für diese neue Politik: Archivierte Videos können vor der Sammlung ihrer fehlenden Fassungen verschoben werden. Entweder führen Sie die Datensatz-Politik mit Ihrem eigenen Archiv aus oder planen Sie einen separaten Nachschrift-Reparaturpass für IDs, die den Text fehlen. Speichern Sie die ursprünglichen Kaptionen; wenn Ihr Modell reine Transcript-Text benötigt, ziehen Sie es in einem verarbeitenden Verarbeitungsschritt ab.

- [Das gleiche Datensatzrezept in Python](https://flashdata.dev/de/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [Handle caption und Metadaten 429s](https://flashdata.dev/de/docs/guides/yt-dlp-429-too-many-requests/reference.md)

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

## Verbessern Sie den Transferverlauf ohne eine IP zu überwältigen


aria2c kann helfen, wenn eine einzige Verbindung eine unzuverlässige oder hohe Lateenz-Verbindung unterstellt. Es kann keine abgelehntes Player-Anfrage oder eine flaggierte IP-Ausgang reparieren. Zuerst machen Sie den nativen Download-Datei auf einer Quelle arbeiten; dann vergleichen Sie die Transferzeit und Fehler mit einer kleinen Anzahl von aria2 Verbindungen.

**Beginnen Sie mit zwei Verbindungen pro HTTP Transfer**

```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 -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Installieren Sie aria2 zuerst. halten Sie DASH/HLS mit dem indigenen Downloader hier, damit die Segmentkonkurrenz ausdrücklich bleibt.

| Kontrolle | Was beschränkt |
| --- | --- |
| aria2c -x 2 | Verbindungen zu einem Server für eine Download. |
| aria2c -s 2 | Anforderte Teilen für eine Datei; Teilen hängt auch von der Dateigröße und Server-Support ab. |
| aria2c -j 1 | Konkurrenten Elemente innerhalb dieser aria2 Anrufe, nicht andere yt-dlp Arbeiter. |
| --concurrent-fragments 1 | Fragment herunterladen innerhalb des native DASH/HLS-Downloaders. |
| Ihre Arbeit Quoi | Die Gesamtaktiv-Video teilt die gleiche Host oder Proxy-Exit IP. |

curl-cffi Impersonenierung gehört zu yt-dlp eigenen Anfragen; es konfiguriert nicht aria2 TLS Fingerprint. Wenn native Downloads funktionieren, aber aria2 bekommt 403, kehren Sie zurück zu native, bevor Sie die unerwandten Extractor-Einstellungen ändern. Halten Sie die Extraktion und die externe Übertragung auf der gleichen Proxy-Sitzung.

In der Funktion von FlashData kann die Erhöhung der Konkurrenz zu aggressiv dazu führen, dass eine Arbeitsstraße sofort zurückkehrt 403. Wenn dies passiert, stoppen Sie die anderen Jobs, gehen Sie zurück zu einem Arbeitnehmer und einer Verbindung, dann re-test. Kompensieren Sie nicht, indem Sie mehr aria2 Teile hinzufügen oder den gleichen verweigten Strom parallel zurückziehen. Wenn diese IP bei geringer Ladung abgelehnt bleibt, verwenden Sie den 403 IP-Restore Workflow.

**Konservative Native Transfer für Vergleich**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M \
  --sleep-requests 2 --sleep-interval 5 --max-sleep-interval 10 \
  -P diagnostics "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

2M ist eine diagnostische Bandbreite-Cape, nicht ein universelles YouTube-Bereich. Erhöhen Sie den Durchgang schrittweise nur nach dem Betrieb der Route.

- [aria2 Verbindung und Split-Optionen](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 Erholungsbefehl](https://flashdata.dev/de/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [Rate-Controls für Metadaten und Captions](https://flashdata.dev/de/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

<a id="collections"></a>

## Bereiten Sie eine Sammlung vor


Für ein kleines bekanntes Set erstellen Sie eine UTF-8 urls.txt mit einem Uhr URL pro Zeile. Für eine YouTube-Playliste, erstellen Sie Ihre IDs in ein Manifest. Flat-Extraktion überprüft die Playlist-Liste ohne eine vollständige Extraktion für jedes Video zu machen; es ist nützlich für die Umfangsüberprüfung, aber seine Eingänge können Dauer, Formate und Verfügbarkeit Details fehlen.

**Erstellen eines YouTube-Playlist Manifest**

```bash
python -m yt_dlp --flat-playlist --print "https://www.youtube.com/watch?v=%(id)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > urls.txt
```

Wenden Sie YOUR_PLAYLIST_ID. Überprüfen Sie urls.txt vor dem Start der Medienübertragung. Die Umleitung ersetzt dieses Manifest, wenn Sie es wieder ausführen.

Um eine Sammlung zu testen, wählen Sie einige Playlist-Eintrags mit --playlist-items 1:5 aus. Die /videos-Tab für einen Kanal ist ein klarer Ausgangspunkt für hochgeladenen Videos als eine ambiguierte Kanal-Homepage. Verhalten Sie die Playlist-Beträge nicht als Identität: Die Artikel können eingegeben, neu bestellt oder entfernt werden.

| Filter | Verwendung | Folgen |
| --- | --- | --- |
| --playlist-items 1:5 | Die ersten fünf Beiträge in der aktuellen Liste. | Nutzen Sie für einen kleinen Test, nicht ein nachhaltiges Checkpoint. |
| --dateafter 20260101 | Die Einträge halten Sie im Januar oder nach dem 1, 2026. | Datefilterung kann noch per-video-extraction benötigen. |
| --match-filters "!is_live & duration <= 1800" | Erfordert ein nicht lebendes Element mit einer bekannten Dauer bei höchstens 30 Minuten. | Einträge mit unbekannten Dauer entsprechen nicht diesem strengen Filter. |
| --download-archive archive.txt | Skip-Quell-IDs, die bereits durch frühere Downloads aufgenommen wurden. | Arbeiten über veränderte Titel und Playlist-Positionen. |

<a id="repeatable"></a>

## Eine Sammlung sicher wiederholen


So sparen Sie die folgenden als yt-dlp-work.conf in Ihrem Sammelmappen neben urls.txt. Es definiert die Ausgangsbestimmung einmal, gibt der Sammlung sein eigenes Archiv und begrenzt die Rückzahlungen. Halten Sie die Ausgangsdateien und dieses Archiv zusammen: ein Archiv erfährt den Erfolg durch den Extractor und ID, nicht durch die aktuelle Datei-Checksum oder -Lokation.

**yt-dlp-work.conf**

```text
# YouTube worker baseline
--js-runtimes deno
--impersonate=""
--concurrent-fragments 1

# Output policy
--no-playlist
-f "bv*[height<=1080]+ba/b[height<=1080]"
-P downloads
-o "%(channel_id)s/%(id)s.%(ext)s"
--write-info-json

# Resume and remember completed media
--continue
--download-archive archive.txt
--no-abort-on-error

# Bound each attempt and spread out work
--retries 5
--fragment-retries 5
--socket-timeout 30
--sleep-requests 1
--sleep-interval 5
--max-sleep-interval 10

# Append paths only after the final move
--print-to-file after_move:filepath completed-paths.txt
```

Glatte Textkonfiguration, eine Option pro Zeile. Die Wege in diesem Beispiel sind relativ zu der Arbeitsdirektion. Verwenden Sie absolute Wege, wenn ein Schalender anderswo starten kann.

**Laden Sie die Sammlung**

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

--ignore-config entfernt die implizite user/system Konfiguration; eine ausdrücklich bereitgestellte --config-locations Datei ist noch geladen.

Die gleiche Befehlsetzung nach einer Unterbrechung. Vollendete IDs werden verschoben und wiederholbare teilweise Übertragungen werden dort fortgesetzt, wo unterstützt wird. Die Extraction-Fehler können im nächsten Rennen wiederholt werden. Die Standard .part-Dateien sind nützlich; löschen Sie sie nicht als eine rutine Rückzugsteg.

> **separate Archiv für separate Ausgänge**
> Ein einziger ID in archive.txt unterscheidet MP3, 1080p und 4K nicht. Verwenden Sie verschiedene Archivdateien für verschiedene Ausgangsbestimmungen. Wenn Sie eine Mediendatei löschen, aber die Archiv-Eintrag behalten, yt-dlp wird es immer noch verpassen. Wenn Sie später Dateien auf Cloud-Speicher hochladen, erfasst Sie den Erfolg von lokalen Download-Speicher abgesehen.

--no-abort-on-error bleibt in der Vergangenheit unzugängliche Einträge, aber ein Rennen kann immer noch nicht zerstörerisch und Post-Verarbeitung Fehler benötigen Aufmerksamkeit. Vermeiden Sie das hinzufügen --ignore-errors nur um einen grünen Job zu bekommen: es kann Post-Verarbeitung Fehler als erfolgreiche Downloads behandeln. Überprüfen Sie den Log und die abgeschlossenen Ausgaben, bevor Sie die Sammlung vollständig erklären.

<a id="verify"></a>

## Überprüfen Sie die fertigen Dateien


Die completed-paths.txt Datei ist eine nützliche Start-Inventory. Testt die tatsächliche Endergebnisse anstatt ein temporäres Video-Only Stream. ffprobe liest Container und Stream-Metadaten; ein separates Dekodierungspass fängt Probleme auf, die nur ein Lesbar-Header fehlt.

**Überprüfen Sie eine fertige Datei**

```bash
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "downloads/CHANNEL_ID/VIDEO_ID.mp4"
```

Stellen Sie den Weg mit einem von completed-paths.txt. Überprüfen Sie die erwartete Dauer, erforderliche audio/video Streams und Decoder-kompatible Codecs.

**Vollständige Decodecke**

```bash
ffmpeg -v error -i "downloads/CHANNEL_ID/VIDEO_ID.mp4" -f null -
```

Lesen und dekodieren Sie die gesamte Datei ohne eine neue Medienproduktion zu erstellen. Überprüfen Sie den Ausgangsstatus sowie Nachrichten; dies dauert länger als ffprobe.

| Finden | Lösung |
| --- | --- |
| Nur eine .part oder separate Stream-Datei bleibt | Überprüfen Sie das transfer/merge-Fehler und wiederholen Sie die ursprüngliche Arbeit; markieren Sie nicht die vollständige Zwischendatei. |
| Video ohne Sound | Inspektieren Sie das ausgewählte Format und ffprobe Streams. Ein Video-Only-Format benötigt eine Audio-Serie und Fusion. |
| MP4 wird nicht in Ihrem Editor geöffnet | Überprüfen Sie die Codecs, nicht nur die Erweiterung; wählen Sie kompatible Streams oder Transcode ausdrücklich aus. |
| Archivierte ID, aber keine lokalen Datei | Überprüfen Sie, ob die Datei moved/deleted. ist, indem Sie das Inventor zusammenstellen, bevor Sie die Archiv-Einträge ändern. |

<a id="schedule"></a>

## 9: Beweisen Sie eine Befehl in eine geplante Arbeit zu bewegen


Führen Sie die vollständige Befehl erfolgreich handgegen, bevor Sie es planen. Ein Schalender beginnt in der Regel mit einem anderen PATH und einem Arbeitsdirektor. Geben Sie ihm den vollständigen Python-Path der virtuellen Umgebung, den vollständigen Konfigurierungs-Path und einen expliciten Arbeitsdirektiv; machen Sie auch FFmpeg und die JavaScript-Worktime für diesen Prozess verfügbar.

- Verwenden Sie einen einzelnen Arbeiter für eine collection/archive. Lassen Sie nicht, dass gesternes Rennen gegen die gleichen Ausgänge überlösen.
- Bei Linux verwenden Sie eine timer/service oder chron-Eintrag mit einem Arbeitsdirektor und einem Lock wie Flock. Halten Sie die Logs außerhalb der Medienmappe und drehen Sie sie.
- Bei macOS verwenden Sie Lunch mit absoluten Ausführbaren und Work-Directory-Paths.
- Im Windows Task Scheduler setzen Sie Programme für die Umgebung python.exe, Argumente für -m yt_dlp sowie die Konfigurations- und Batch-Optionen und starten Sie in die Sammelmappe.
- Rekordzeit start/end, ausgeführbarer Version, Quellmässe, Ausgangsstatus und completed/failed zählen. Ein nonzero-Batch-Ausgang bedeutet nicht, dass jedes Element versagt ist.
- Halten Sie Cookies und Zielkreditationen aus dem gemeinsamen Konfigurationsrepository. Geben Sie eine Arbeit nur die Kreditwerte, die Sie benötigen.

Die Schlafoptionen im Konfig funktionieren innerhalb eines Prozesses. Zehn Arbeiter, die die gleichen Einstellungen verwenden, produzieren immer noch zehn überlappende Anfragenströme. Die Erhöhung --concurrent-fragments ändert die Fragmentkonkurrenz innerhalb eines Downloads, nicht die Anzahl der Videos in Ihrem Job-Rücklauf.

<a id="maintain"></a>

## Wählen Sie die richtige Fehlerleitung


**Aktualisieren Sie diese Python-Umgebung**

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

Wenn eine vorherige Arbeitskilde abbrechen, aktualisieren Sie sie zum neuesten Nachtzeit-Erster, einschließlich der matching-extra. Für den einzelnen binären Gebrauch yt-dlp --update-to Nacht; -U allein bleibt auf dem aktuellen Kanal. Laden Sie nach jeder Aktualisierung einen kleinen Kanarisch aus, bauen Sie dann die Arbeiter wieder auf und registrieren Sie die Revision, damit die Flotte nicht still die Releases vermischt.

| Symptome | Beginnen Sie hier |
| --- | --- |
| `Requested format is not available` | Liste Sie die Formate und überprüfen Sie Ihre strengen Filter, bevor Sie die Retries ändern. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | Überprüfen Sie PATH vom tatsächlichen Arbeitnehmer- oder Zeitplankonto. |
| JavaScript-Ausforderung / Fehlzeitwarnung | Überprüfen Sie die Betriebszeit-Detektion und das EJS-Paket. |
| HTTP 403 während des Transfer | Identifizieren Sie den abgelehntem Host und die Bühne; separate Extraction aus der Medienübertragung. |
| HTTP 429 | Pause die betroffene IP, erlaubt eine Kälte und niedrige extraction/caption Anfragefrequenz. |
| `Sign in to confirm you’re not a bot` | Pause die Band und diagnostizieren Sie eine Quelle, eine Sitzung und ein Netzwerk. |

- [403 Diagnose Arbeitsfluss](https://flashdata.dev/de/docs/guides/yt-dlp-403-forbidden/reference.md)
- [Bot-check Diagnose Workflow](https://flashdata.dev/de/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 Rate-Limit-Erholung](https://flashdata.dev/de/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Tagebereichsreferenz](https://flashdata.dev/de/docs/guides/yt-dlp-commands/reference.md)
- [Ein Python-Arbeiter bauen](https://flashdata.dev/de/docs/guides/yt-dlp-python-api/reference.md)

<a id="managed-downloads"></a>

## Wenn die Produktion in einem Cloud-Pipeline gehört


Wenn Sie den Download-System besitzen möchten, geben Ihnen die oben genannten Workflows Kontrolle über Dateien, Formate und Verarbeitung. Wenn Ihre Anwendung vollständig aufgeführte Medien zur Speicherung benötigt, bietet FlashData traceed YouTube-Download-Arbeits, Bot-Management, Proxy-Routing und Retries. Ihre Anwendung stellt die Quell- und Ausgangsinstellungen ein, dann hält sie die Arbeits-ID und Lieferungspapier.

- [Vergleichen Sie die beiden Betriebsmodelle](https://flashdata.dev/de/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [YouTube-Videos in großen Mengen herunterladen](https://flashdata.dev/de/products/youtube-download#bulk-downloads)
- [Versuchen Sie die Download-Demo](https://flashdata.dev/de/products/youtube-download#playground)
- [Download API Referenz](https://flashdata.dev/de/docs/sources/youtube_download/reference.md)

<a id="references"></a>

## Referenzmaterial


Die upstream Optionsreferenz ist die Quelle der Wahrheit für Ihre installierte Version. Verwenden Sie diese Abschnitte, wenn Sie eine Sammelrichtlinie ändern oder ein Arbeiterbild aktualisieren.

- [Formatierung und Sortierung](https://github.com/yt-dlp/yt-dlp#format-selection)
- [Konfiguration Loading](https://github.com/yt-dlp/yt-dlp#configuration)
- [Ausgangs-Template](https://github.com/yt-dlp/yt-dlp#output-template)
- [Häufige Fragen zu yt-dlp](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
