# Jak używać yt-dlp

Przewodnik po codziennym pobieraniu w Linuksie obejmujący wersję nightly, formaty, napisy, zbiory danych i wznawianie kolekcji.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/how-to-use-yt-dlp
Przegląd: 2026-11-13 przez FlashData

- [Ustaw narzędzia](https://flashdata.dev/pl/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg i JavaScript
- [Wybierz produkt](https://flashdata.dev/pl/docs/guides/how-to-use-yt-dlp/reference.md#formats) — Wideo, audio i captions
- [Powtarzamy kolekcję](https://flashdata.dev/pl/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — Manifest, konfig i archiwum
- [Naprawiamy nieudane bieganie](https://flashdata.dev/pl/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — Znajdź odpowiednią diagnozę

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

## Instalacja bazy codziennego użytkowania


**Start z nocnym + Deno + FFmpeg.** Użyj wirtualnego środowiska projektu i umożliw przeglądarkę do personalizacji z `--impersonate=""`. ustawienie Linux poniżej instaluje narzędzia; opcje macOS i Windows znajdują się w zakładkach.

**Linux**

Przykład Ubuntu / Debian z Python 3.11+. zainstaluj narzędzia systemowe, stworz projekt wirtualnego środowiska, a następnie zainstaluj bieżący nocny i jego ekstrady.


**Linux Pracownik**

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

Z Homebrew zainstalowany, użyj go dla Python, Deno, FFmpeg i aria2. Trzymaj yt-dlp w środowisku projektu tak, że nakaz nocnej aktualizacji jest taki sam jak na Linuxie.


**MacOS ustawienia**

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

Instaluj Python 3.11+, Deno i wykonawcze FFmpeg, a następnie otwórz nowy terminal. Użyj tłumacza środowiska bezpośrednio, jeśli PowerShell blokuje aktywację. aria2 jest opcjonalne; zainstaluj go oddzielnie, jeśli używasz recepty zewnętrznej przeglądarki.


**Windows środowisko**

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


| Narzędzie | Co to robi | Sprawdź |
| --- | --- | --- |
| Python 3.11+ | W tej serii działa pakiet Python i przykłady. | python --version |
| Ostatni yt-dlp nocny + domyślny,curl-cffi ekstras | Aktualny ekstraktor YouTube, odpowiadający EJS solver i obsługa impersonalizacji przeglądarki. | python -m yt_dlp --version |
| FFmpeg i ffprobe | Złączyć strumienia, konwertować audio, wyciąć klipy i sprawdzić zapisane media. | ffmpeg -version / ffprobe -version |
| Deno 2.3+ (wymagane w tym przepływie pracy) | Instaluj go na każdym pracowniku, a nie tylko maszynę rozwojową. | deno --version |

**Install executables too.** `[default]` dostarcza EJS scripts; Deno jest oddzielny. FFmpeg i ffprobe musi być również na PATH pracownika.

**Sprawdź pełną bazę**

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

Ostateczna polecenie powinno zawierać dostępne cele przeglądarki.Jeśli cele nie są dostępne, sprawdź, czy curl-cffi jest zainstalowany w tym dokładnym środowisku wirtualnym.

**Testowe ekstrakcje z Deno i impersonalizacją przeglądarki**

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

Sprawdź czas biegu JS i linie żądania-handler. Simulacja testuje ekstrakcję; śledź go z prawdziwym transferem.

Podstawową linią operacyjną programu FlashData jest --impersonate=": pozwala curl-cffi wybrać dostępny odcisk palca przeglądarki. To zmienia odcisk palca zapytania; nie dostarcza plików cookie logowania, rozwiąże wyzwania JavaScript lub zmienia IP wyjścia. Jeśli ta opcja spowalnia trasę roboczą lub wprowadza błędy, powtórz ten sam test wideo bez niej i utrzymuj konfigurację roboczą.

> **Usługa potrzebuje własnej drogi**
> Instalator Deno zazwyczaj umieszcza binary w ~/.deno/bin. Interaktywna schoda, która go odkrywa, nie udowadnia, że systemd serwis, kontener lub praca chron może. Ustaw pracownik PATH lub przejść --js-runtimes deno:/absolute/path/to/deno. Użyj ścieżki Python wirtualnego środowiska w polu obsługi.

- [Oficjalna instalacja](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg Pobierz](https://ffmpeg.org/download.html)
- [Instalacja Deno](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube Runtime wstęp](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

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

### Sprawdź wypływ przed umieszczeniem go na pracownika


Uzyskaj wykonawcze z oficjalnej strony wydania projektu lub zainstaluj pakiet Python z jego opublikowanego źródła pakietu. Jeśli pobierasz pojedynczą binarną, porównaj jej SHA-256 z odpowiednią nazwą filenową w tym wydaniu SHA2-256SUMS. Zapisz wydanie i kontrolę z obrazem pracownika, abyś mógł dokładnie zidentyfikować to, co działało.

**Linux**


**Hash pobrane pliki**

```bash
sha256sum yt-dlp
```


**macOS**


**Hash pobrane pliki**

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


**Windows**


**Hash pobrane pliki**

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


Porównanie kwoty kontrolnej jest przydatne tylko wtedy, gdy oczekiwana wartość pochodzi z zaufanego wydania, a nie tego samego nieznanego lustra jak wykonawcza. Jeśli oprogramowanie bezpieczeństwa jest w pliku, sprawdź jego źródło i raport przed dokonaniem wyjątku. Dostępność open-source sama nie jest dowodem na to, że każdy pobrany binary lub plugin ze strony osób trzecich jest bezpieczny.

Traktuj udostępnione pliki konfiguracji jako kod do przeglądania: opcje takie jak --exec mogą uruchomić polecenia, a wtyczki dodają kod do procesu pobierania. Utrzymuj pliki cookie przeglądarki, zaufania proxy i podpisane adresy URL z przykładu konfiguracji i raportów diagnostycznych.

- [Oficjalne publikacje i czeki](https://github.com/yt-dlp/yt-dlp/releases)

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

## Pobierz jeden film


**Użyj krótkiego wideo najpierw.** Cytuj adres URL, dodaj `--no-playlist` i nazw plik ID wideo.

**Jeden film, jeden folder wyjściowy**

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

Drukowany ścieżka to plik po połączenia i post-przetwarzaniu. otwórz tę ścieżkę; nie przyjmuj, że plik zakończy się .mp4.

Bez przepływu formatu yt-dlp wybiera swoje preferowane dostępne strumienia. Wysokiej jakości źródła często mają oddzielne strumienia wideo i audio, więc dwa transfery, które są następujące przez połączenie FFmpeg są normalne. Pliky pośrednie i plik .part mogą pojawić się podczas pracy.

> **Nie ugryź rozszerzenia**
> Utrzymuj %(ext)s w szablonie wyjścia. nazwanie WebM strumienia file.mp4 tylko zmienia jego nazwę. Wybór formatów, remuxing i konwersja decyduje, co jest wewnątrz pliku.

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

## Wybierz jakość i kodek


**Sprawdź format tego wideo**

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

**Wybierz politykę, a nie identyfikator formatu kopiowanego.** Sprawdź rozdzielczość, kodek i oddzielne ścieżki audio/video.

| Wybór lub opcja | Znaczenie | Kiedy używać go |
| --- | --- | --- |
| BV + B | Wybierz tylko strumień wideo i strumień audio; FFmpeg łączy je. | Potrzebujesz obu ścieżek i możesz połączyć się lokalnie. |
| A/B | Spróbuj selektora A, a następnie B, jeśli A nie jest dostępny. | Definicja wyraźnego spadku zamiast przypuszczać, że każdy źródło ma te same formaty. |
| [height<=1080] | Wyłączyć strumienia powyżej 1080 pikseli wysokie. | Twarde wzrostowe łącze to wymóg. |
| -S res:1080 | Preferuje rozdzielczość do 1080; można wybrać większą, gdy nie ma żadnej poniżej. | 1080p jest preferencją zamiast twardej dachu. |
| --merge-output-format mp4 | Wybierz pojemnik podczas łączenia oddzielnych przepływów. | Wybrano już kompatybilne strumienia. nie transkoduje kodeków. |

**Utrzymuj kodek źródłowy, z twardego dachu 1080p**

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

To może wytwarzać WebM, MP4 lub inny obsługiwany pojemnik. to nie działa, jeśli żaden format nie spotyka się z dachem; nie pobiera cicho 4K.

W przypadku edytora lub odtwarzania, które wymagają w szczególności H.264 wideo i AAC dźwięku, filtrować te kodeky i połączyć się z MP4. MP4 to pojemnik: strumień w pojemniku MP4 może nadal zawierać kodek, którego aplikacja nie może odkryć.

**Wniosek H.264 + AAC, aż do 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"
```

Jeśli wymagane kodeki nie są dostępne, ten rygorystyczny selektor nie działa. decyduj się, czy zaakceptować różne kodeki źródłowe lub transcode; nie usuwać wymogu przypadkowo.

Remuxing odpakowuje strumienia bez ich ponownego kodowania. Transkodowanie zmienia kodek i zużywa CPU, a jednocześnie potencjalnie zmienia jakość. Użyj --remux-video, gdy strumienia już pasują do kontenera docelowego; użyj umyślnej konwersji FFmpeg, gdy decoder downstream wymaga różnych kodeków.

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

## Zapisz audio lub MP3


Jeśli twój przewod transkrypcji akceptuje kodek audio źródłowy, pobierz ten strumień bezpośrednio. To uniknie niepotrzebnej konwersji stratowej. MP3 jest przydatny, gdy konsument konkretnie tego wymaga; wysoka MP3 bitrate nie może odzyskać już utraconego szczegółu w źródle.

**Utrzymuj najlepszy dostępny strumień audio**

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

Oczekuj źródłowego kontenera i kodek, zwykle M4A/AAC lub WebM/Opus.

**Konwersja audio do 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"
```

Wymaga FFmpeg. --audio-quality 0 wybiera najlepsze ustawienie jakości zmiennej; użyj stopy bitowej, takiej jak 192K, gdy Twoja specyfikacja dolnej linii wymaga jednego.

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

## Zapisz kapcje i metadane


Przydatna kolekcja potrzebuje więcej niż filenamów. Utrzymuj identyfikatorów wideo, adresy URL źródłowe, tytuły, okresy i dostępne wpisy, aby można było wyszukiwać kolekcję i śledzić aktyw z powrotem do źródła. Zacznij od wykazania śladów z tytułu; żądanie nie oznacza, że każdy film ma ślad angielski.

**Sprawdź pozycje, a następnie zaoszczędź ślady angielskie bez mediów**

```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 wybiera dostarczone podtytuły; --write-auto-subs pozwala również na automatyczne odbiory. to odzywa istniejące ślady i nie przekłada wideo, które nie ma.

**Media z metadany i miniaturą**

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

Plik .info.json to szczegółowe metadane operacyjne, a nie czysta publiczna odpowiedź API. Może zawierać wygaśnięte adresy URL mediów i polece związane z zapytaniem. Utrzymuj pełną płytę boczną z kolekcją i eksportować tylko pola, których potrzebuje system downstream. Jeśli potrzebujesz SRT zamiast VTT, dodaj --convert-subs srt i upewnij się, że FFmpeg jest dostępny.

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

## Tworzenie elementu AI z datasetem


W przypadku zbioru szkolenia, decyduj o mediach i tekstowych wyjściach razem. Najlepszym dostępnym wideo i audio jest wymóg, który jest połączony z MP4, z czasami przechowywanymi odbiórami i metadanymi ekstrakcji przechowywanymi pod tym samym ID wideo. Użyteczny dach rozdzielczości dla przeglądów jest zazwyczaj niewłaściwym standardem dla zestawu danych o jakości źródłowej.

**Pobierz jeden kompletny element z zestawu danych**

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

Przykład Bash. FFmpeg łączy oddzielne strumienia; --remux-video obejmuje również spadek łącznego przepływu. użyj dokładnej etykiety językowej z --list-subs; zastępuj ją językiem, którego potrzebuje zestaw danych.

Zacznij od jednego dokładnego języka. W naszym czeku na żywo, en.* wybrano en, en-en i en-de; trzecia ścieżka powróciła 429 przed rozpoczęciem pobierania mediów. Błąd napisu może zatrzymać element na tym etapie. Po chłodzeniu, odciąć tylko wymagane ścieżki, lub rozdzielić media i napisać prace, jeśli kolekcja musi utrzymać media wchłanianie się.

/best fallback umożliwia połączenie video/audio, gdy oddzielne ścieżki nie są dostępne. Usuń ten spadek, jeśli umowa o kolekcję wymaga oddzielnych źródeł bestvideo i bestaudio. MP4 nie oznacza H.264: ta receptura zachowuje wybrane kodeki źródłowe. Użyj wyżej wymienionego sztywnego selektora H.264/AAC, jeśli dekoder szkolenia wymaga tych kodeków lub transcode jako oddzielny, zapisany krok.

**Zapisy oczekiwane, gdy istnieje ścieżka angielskiego**

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

Nie tworzy się pliku o nazwie, gdy żądany ścieżka nie jest dostępna; nie oznaczaj pełnego pokrycia tekstu tylko dlatego, że MP4 jest zakończony.

| Wymóg | Decyzja kolekcji |
| --- | --- |
| Najwyższa dostępna jakość źródła | Użyj bestvideo+bestaudio, zachowaj kodek źródłowy i sprawdź połączenia z ffprobe. |
| Czasowe teksty | Utrzymuj VTT/SRT segmenty i język obok identyfikatorów wideo. płaski tekst odrzuca czas potrzebny do dopasowania klipów. |
| Brakujące napisy | Zapisz brakujący tekst wyraźnie. Przeprowadź zapisany dźwięk do fazy transkrypcji, jeśli tekst jest obowiązkowy. |
| Kaptuły dla wielu języków | Każda kolejka dodatkowo dodaje żądania i może spotkać 429 niezależnie od mediów. |
| Media + tekst dostawy | Użyj oddzielnego archiwum zestawu danych i zapisu z media, metadany i statystyki napisu. wpis archiwum nie udowadnia, że wszystkie wymagane strony istnieją. |

Nie ponownie używaj archiwum stworzonego przez wcześniejsze media, które są prowadzone wyłącznie dla tej nowej polityki: archiwizowane filmy mogą zostać przeniesione przed zbieraniem ich brakujących wpisów. Wystarczy uruchomić politykę zestawu danych z własnym archiwum lub zaplanować oddzielny pas naprawy dla identyfikatorów brakujących tekstów. Zapisz oryginalne kapsułki; jeśli model potrzebuje czystego tekstu transkrypcyjnego, odtwarzaj go w wersji etapie przetwarzania.

- [Podobne przepisy w Pythonie](https://flashdata.dev/pl/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [Opis i metadata 429s](https://flashdata.dev/pl/docs/guides/yt-dlp-429-too-many-requests/reference.md)

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

## Poprawa przepływu transferowego bez przesadzenia IP


aria2c może pomóc, gdy jedno połączenie jest poddane niezawodnemu lub wysokiej częstotliwości połączenia. Nie może on naprawić odrzuconej prośby odtwarzacza lub zarejestrowanej IP wyjścia. Najpierw wykonaj native downloader działa na jednym źródle, a następnie porównaj czas transferu i błędy z niewielką liczbą połączeń aria2.

**Zacznij od dwóch połączeń na 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"
```

Zainstaluj aria2 najpierw. Trzymaj DASH/HLS z native downloader tutaj tak, że konkurencja segmentu pozostaje wyraźna.

| Kontrola | Co to ogranicza |
| --- | --- |
| aria2c -x 2 | Połączenie do jednego serwera do pobrania. |
| aria2c -s 2 | Wymagane podziały dla jednego pliku; podziały również zależą od wielkości pliku i obsługi serwera. |
| aria2c -j 1 | Konwerentne elementy w tym aria2 powołaniu, a nie inne yt-dlp pracowników. |
| --concurrent-fragments 1 | Fragmenty pobierają się w pobliżu native DASH/HLS downloadera. |
| Twoja praca w Queue | Wideo aktywne jest w tym samym miejscu, a następnie w tym samym miejscu, a następnie w tym samym miejscu, a następnie w tym samym miejscu, a następnie w tym samym miejscu. |

curl-cffi impersonacja należy do własnych żądań yt-dlp; nie konfiguruje aria2 odcisków palców TLS. Jeśli native pobieranie działa, ale aria2 dostaje 403, powróć do native przed zmianą nie powiązanych ustawień ekstraktora. Utrzymuj ekstrakcję i transfer zewnętrzny w tej samej sesji proxy.

W operacji FlashData, podnoszenie konkurencji zbyt agresywnie może sprawić, że trasa robocza zaczyna od razu powracać 403. Jeśli tak się dzieje, zatrzymaj inne prace, wróć do jednego pracownika i połączenia, a następnie spróbuj. Nie kompenzuj dodając więcej aria2 podziałów lub odrzucając ten sam odrębny strumień równolegle. Jeśli IP pozostaje odrzucone przy niskim obciążeniu, użyj przepływu pracy 403 IP-replacement.

**Transfery konservatywne dla porównania**

```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 jest diagnostyczną szufladą szerokości pasów, a nie uniwersalnym granicą YouTube.

- [aria2 połączenie i opcje podzielone](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 Porządek odzyskiwania](https://flashdata.dev/pl/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [Kontrola prędkości dla metadanych i kapcji](https://flashdata.dev/pl/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

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

## Przygotuj kolekcję


W przypadku małego znanej grupy, utworz UTF-8 urls.txt z jednym adresem URL na linie. W przypadku wyświetlania YouTube najpierw wymienić jego identyfikatory w manifestu. Flat extraction sprawdza listę odtwarzania bez wykonania pełnej ekstrakcji dla każdego wideo; jest przydatny do przeglądu zakresu, ale jego wpisy mogą brakować długości, formatów i szczegółów dostępności.

**Tworzenie manifestu playlist YouTube**

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

Zastąpić YOUR_PLAYLIST_ID. sprawdź urls.txt przed rozpoczęciem przesyłania mediów. przekierowanie zastąpi ten manifest, jeśli go ponownie uruchamiasz.

Aby przetestować kolekcję, wybierz kilka wpisów z listą odtwarzania z --playlist-items 1: 5. Tab /video kanału jest bardziej jasnym punktem wyjścia dla przesyłanych filmów niż niejasna strona główna kanału. Nie traktuj porządku listy odtwarzania jako tożsamości: elementy można wprowadzić, ponownie zamówić lub usunąć.

| Filtr | Stosowanie | konsekwencje |
| --- | --- | --- |
| --playlist-items 1:5 | Pierwsze pięć wpisów w aktualnym wykazie. | Przydatne dla małego testu, a nie trwałego punktu sprawdzającego. |
| --dateafter 20260101 | Wpisy zapisane w dniu lub po styczniu 1, 2026. | Filtrowanie daty może nadal wymagać ekstrakcji wideo. |
| --match-filters "!is_live & duration <= 1800" | Wymagaj nie-live element z znanymi długością maksymalnie 30 minut. | Wpisy o nieznanej długości nie pasują do tego sztywnego filtra. |
| --download-archive archive.txt | Skryj identyfikatory źródłowe już zapisane przez poprzednie pobrania. | Prace w różnych miejscach i w różnych pozycjach. |

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

## Bezpiecznie odtworzyć kolekcję


Zapisz następujące jako yt-dlp-work.conf w folderze kolekcji, oprócz urls.txt. Określa politykę wyjścia raz, daje kolekcji swój własny archiwum i ogranicza wydatki. Utrzymuj pliki wyjściowe i ten archiwum razem: archiwum rejestruje sukces przez ekstraktor i identyfikator, a nie przez numer kontrolny lub lokalizację bieżącego pliku.

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

Konfiguracja płaski tekstu, jedna opcja na linii. Środki w tym przykładzie są relatywne do dyrektora roboczego. Użyj absolutnych środków, gdy programer może rozpocząć się gdzie indziej.

**Przeprowadź kolekcję**

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

--ignore-config usuwa implikowaną konfigurację user/system; wyjaśniony --config-locations plik jest nadal ładowany.

Zrób to samo polecenie po przerwie. Wypełnione identyfikatory są przeniesione, a ponowne częściowe transfery kontynuują się tam, gdzie są wspierane. Niepowodzenia w ekstrakcji można ponownie odnaleźć w kolejnym etapie. Podstawowe pliki .part są przydatne; nie usuwaj ich jako rutynowego kroku wycofania.

> **- oddzielne archiwum dla oddzielnych wyjściów**
> Jedno identyfikator w archive.txt nie odróżnia MP3, 1080p i 4K. Użyj różnych plików archiwum dla różnych polityk wyjścia. Jeśli usunąć plik medialny, ale utrzymać jego wpis archiwum, yt-dlp nadal go pominąć. Jeśli później przesyłać pliki do magazynu w chmurze, nagrywać sukces przesyłania oddzielnie od lokalnego sukcesu pobierania.

--no-abort-on-error nadal przeszło nie do dyspozycji wpisów, ale bieganie może nadal wyjść nonzero i błędy post-przetwarzania wymagają uwagi. Unikaj dodania --ignore-errors po prostu, aby uzyskać zieloną pracę: może traktować porażki po przetwarzaniu jako udane pobieranie. Przegląd logów i zakończone wyniki przed ogłoszeniem zakończenia kolekcji.

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

## Sprawdź gotowe pliki


Plik completed-paths.txt jest przydatnym zapasem początkowym. Testuje rzeczywistej końcowej produkcji zamiast tymczasowego tylko strumienia wideo. ffprobe czyta kontener i strumienia metadane; oddzielny przejście dekodowania złapa problemy, które tylko czytelny nagłówek będzie brakuje.

**Sprawdź jeden gotowy plik**

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

Zastąpić ścieżkę jednym z completed-paths.txt. Sprawdź oczekiwaną długość, wymagane audio/video strumienia i kodeków kompatybilnych z dekoderem.

**Opcjonalny pełny decoding**

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

Czyta i odczytuje cały plik bez tworzenia nowego wyjścia medialnego. sprawdź status wyjścia, a także wiadomości; to trwa dłużej niż ffprobe.

| Szukaj | Co zrobić |
| --- | --- |
| Pozostaje tylko jeden .part lub oddzielny plik strumieniowy | Sprawdź błąd transfer/merge i przywróć pierwotną pracę; nie oznaczaj pełnego pliku pośredniego. |
| Wideo bez dźwięku | Sprawdź wybrany format i ffprobe strumienia. format wideo tylko wymaga wyboru dźwięku i połączenia. |
| MP4 nie otwiera się w redaktorze | Sprawdź kodek, a nie tylko rozszerzenie; wybierz kompatybilne strumy lub transkody wyraźnie. |
| Archiwizowany ID, ale bez lokalnego pliku | Sprawdź, czy plik był moved/deleted. Zgromadź zapas przed zmianą wpisów archiwum. |

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

## 9: Przekształcenie sprawdzonej polecenia w zaplanowaną pracę


Wykonaj pełną polecenie z powodzeniem ręcznie przed planowaniem. Programowanie zazwyczaj zaczyna się od innego PATH i dyrektora roboczego. Daj mu pełną ścieżkę Python w środowisku wirtualnym, pełną ścieżkę konfiguracji i wyraźny katalog pracy; również FFmpeg i czas pracy JavaScript dostępne dla tego procesu.

- Użyj jednego pracownika do collection/archive. Nie pozwól, aby wczorajsza bieżka przewyższała dzisiejsza bieżka przeciwko tym samym wyjściom.
- W systemie Linux użyj timer/service lub wstępu chron z dyrekcją roboczą i zamkiem, takim jak grom. Utrzymuj dzienniki poza folderem medialnym i odwróć je.
- Na macOS, użyj start-up z absolutnie wykonawczych i pracujących ścieżek.
- W programie Windows Task Scheduler ustaw program do środowiska python.exe, argumenty do -m yt_dlp plus opcje konfiguracji i zestawu oraz Start do folderu kolekcji.
- Czas rejestracji start/end, wersja wykonawcza, manifest źródłowy, status wyjścia i completed/failed liczą. wyjście z serii zero nie oznacza, że każdy element się nie powiodł.
- Utrzymuj pliki cookie i uwierzytelnienia docelowe z wspólnego magazynu konfiguracji.

Opcje snu w konfiguracji działają w jednym procesie. Dziesięciu pracowników, którzy korzystają z tych samych ustawień, nadal produkuje dziesięć przepływów żądań. Zwiększanie --concurrent-fragments zmienia konkurencję fragmentów wewnątrz pobrania, a nie liczbę filmów w swojej linii roboczej.

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

## Wybierz właściwy przewodnik błędu


**Aktualizacja tego środowiska Python**

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

Kiedy wcześniej pracujący źródło się rozpada, aktualizuj na najnowsze nocne pierwsze, w tym dopasowane dodatkowe. Dla pojedynczego użytkowania binarnego yt-dlp --update-to w nocy; -U tylko pozostaje na bieżącym kanałie. Po każdej aktualizacji uruchom mały kanaryj, a następnie odbuduj pracowników i zapisuj przegląd tak, aby floty nie milcząco mieszały się z wydaniami.

| objawy | Zacznij tutaj |
| --- | --- |
| `Requested format is not available` | Wyznacz formaty i sprawdź swoje rygorystyczne filtry przed zmianą odcinek. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | Sprawdź PATH z faktycznego konta pracownika lub harmonogramu. |
| Wyzwanie JavaScript / brak czasu pracy ostrzeżenie | Sprawdź czas pracy i odpowiadający pakiet EJS. |
| HTTP 403 w czasie transferu | Identyfikacja odrzuconego gospodarza i fazy; oddzielna ekstrakcja z transferu mediów. |
| HTTP 429 | Zatrzymaj dotknięty IP, umożliwiając chłodzenie i niższe częstotliwość żądania extraction/caption. |
| `Sign in to confirm you’re not a bot` | Zatrzymaj zestaw i zdiagnozuj jeden źródło, sesję i sieć. |

- [403 Diagnostyka przepływu pracy](https://flashdata.dev/pl/docs/guides/yt-dlp-403-forbidden/reference.md)
- [Bot-check diagnostyczny przepływ pracy](https://flashdata.dev/pl/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 Odzyskiwanie limitu stopy](https://flashdata.dev/pl/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Codzienne odniesienia do poleceń](https://flashdata.dev/pl/docs/guides/yt-dlp-commands/reference.md)
- [Tworzenie pracownika Python](https://flashdata.dev/pl/docs/guides/yt-dlp-python-api/reference.md)

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

## Gdy produkcja należy do przewodu chmury


Jeśli chcesz posiadać pobieracza, powyższe przepływy pracy dają Ci kontrolę nad plikami, formatami i przetwarzaniem. Jeśli aplikacja potrzebuje kompletnych mediów dostarczonych do przechowywania, FlashData zapewnia śledzone YouTube stawki, roboty do obsługi botów, proxy routing i retries. Twoja aplikacja przedstawia ustawienia źródła i wyjścia, a następnie utrzymuje identyfikator pracy i rekord dostawy.

- [Porównaj dwa modele operacyjne](https://flashdata.dev/pl/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [Masowe pobieranie filmów z YouTube](https://flashdata.dev/pl/products/youtube-download#bulk-downloads)
- [Spróbuj demo download](https://flashdata.dev/pl/products/youtube-download#playground)
- [Pobierz referencję API](https://flashdata.dev/pl/docs/sources/youtube_download/reference.md)

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

## Materiał referencyjny


Referencja opcji upstream jest źródłem prawdy dla zainstalowanej wersji. Użyj tych sekcji podczas zmiany polityki kolekcji lub aktualizacji obrazu pracownika.

- [Wybór i sortowanie](https://github.com/yt-dlp/yt-dlp#format-selection)
- [Konfiguracja ładowania](https://github.com/yt-dlp/yt-dlp#configuration)
- [Wstępne szablony](https://github.com/yt-dlp/yt-dlp#output-template)
- [Najczęstsze pytania o yt-dlp](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
