Czego chcesz
Tylko dźwięk wyciąga ścieżkę audio i porzuca obraz.
Spis opcji yt-dlp
Opisano dla yt-dlp 2026.07.21. Między wersjami opcje są dodawane i zmieniają nazwy, więc sprawdź swoją przez yt-dlp --version.
Podstawy
Wideo i jakość
-f FORMAT
--format
Maksymalna jakość
Ogranicza wysokość. yt-dlp i tak wybierze najlepszą ścieżkę na tym poziomie lub niżej.
-f FORMAT
--format
Własny format selector
Zastępuje listę jakości. Dla tych, którzy znają już składnię formatów.
Przykłady
-f "bv*[vcodec^=av01]+ba"-f "b[filesize<50M]"
--merge-output-format FORMAT
wymaga ffmpeg
Container
Typ pliku, w którym scalane są osobne ścieżki obrazu i dźwięku.
--remux-video FORMAT
wymaga ffmpeg
Remux na
Przepakowuje ścieżki bez przekodowania. Szybko i bez straty.
--recode-video FORMAT
wymaga ffmpeg
Przekoduj na
Przekodowuje obraz. Wolno i ze stratą — tylko gdy remux nie wystarcza.
Dźwięk
--audio-format FORMAT
wymaga ffmpeg
Format dźwięku
Plik, na który konwertowany jest dźwięk.
--audio-quality QUALITY
wymaga ffmpeg
Jakość dźwięku
VBR daje najlepszy stosunek rozmiaru do jakości; stały bitrate jest bardziej przewidywalny.
Napisy
Napisy
Wtopienie umieszcza je w pliku wideo; zapis tworzy obok osobny plik .srt.
Języki napisów
Rozdzielone przecinkami. Wpisz all, żeby wziąć wszystkie dostępne języki.
Przykłady
--sub-langs "en,vi"--sub-langs "en.*,ja"--sub-langs all
Napisy generowane automatycznie
Bierze napisy maszynowe, gdy nie ma napisów zrobionych przez człowieka.
Playlisty i kanały
Obsługa playlisty
Co zrobić, gdy adres należy zarazem do filmu i do playlisty.
-I ITEM_SPEC
--playlist-items
Które pozycje
Działają zakresy i listy, na przykład 1-10,15 albo -5::2, żeby brać co drugą pozycję od końca.
Przykłady
-I 1:5-I "1,3,7-10"-I "-5::2"
Plik rejestru
Zapisuje, co już pobrano, więc kolejne uruchomienie to pomija. Tak utrzymuje się kanał w zgodzie ze źródłem.
Fragmenty i rozdziały
--download-sections REGEX
wymaga ffmpeg
Pobierz tylko fragment
Zakres czasu w postaci *00:01:30-00:03:00 albo nazwa rozdziału. Gwiazdka na początku oznacza, że to znacznik czasu.
Przykłady
--download-sections "*00:01:30-00:03:00"--download-sections "intro"
--split-chapters
wymaga ffmpeg
Podziel na rozdziały
Tworzy po jednym pliku na rozdział, zamiast jednego długiego.
Metadane i okładka
--embed-thumbnail
wymaga ffmpeg
Wtop miniaturę
Używa miniatury filmu jako okładki.
--embed-metadata
wymaga ffmpeg
Wtop metadane
Zapisuje tytuł, autora i datę w samym pliku.
--embed-chapters
wymaga ffmpeg
Wtop rozdziały
Dodaje znaczniki rozdziałów, po których odtwarzacz umie skakać.
Zapisz plik miniatury
Zapisuje obrazek okładki obok filmu.
Zapisz opis
Zapisuje opis do pliku .description.
Zapisz metadane w JSON
Zapisuje wszystko, co yt-dlp wie o filmie, do pliku .info.json.
SponsorBlock
--sponsorblock-remove CATS
wymaga ffmpeg
Usuń fragmenty
Wycina z pliku fragmenty oznaczone przez społeczność, na podstawie danych SponsorBlock.
Oznacz fragmenty jako rozdziały
Zostawia fragmenty, ale je oznacza, żebyś sam je przeskakiwał.
Pliki i foldery
-o [TYPES:]TEMPLATE
--output
Wzór nazwy pliku
Nazwy pól wpisuje się w %(...)s. Ukośniki tworzą foldery.
Przykłady
-o "%(title)s.%(ext)s"-o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH
--paths
Folder docelowy
Gdzie zapisywać pliki. W połączeniu ze wzorem powyżej daje podfoldery.
Bezpieczne nazwy plików (tylko ASCII)
Usuwa znaki diakrytyczne, spacje i wszystko, co wybredny system plików mógłby odrzucić.
Nazwy zgodne z Windows
Usuwa znaki, których Windows nie przyjmuje, nawet jeśli pracujesz na innym systemie.
Skróć nazwy do
Maksymalna długość nazwy pliku w znakach.
Nadpisuj istniejące pliki
Zamienia pliki, które już tam są.
-w
--no-overwrites
Nigdy nie nadpisuj
Pomija wszystko, co już pobrane.
-c
--continue
Wznawiaj przerwane pobierania
Kontynuuje od miejsca, w którym pobieranie się zatrzymało.
Filtry
Dodane po
RRRRMMDD albo data względna, na przykład now-1month.
Przykłady
--dateafter 20240101--dateafter now-1month
Dodane przed
RRRRMMDD albo data względna.
Minimalny rozmiar
Pomija wszystko mniejsze. Przyjmuje 5M, 500K i podobne.
Maksymalny rozmiar
Pomija wszystko większe.
Zatrzymaj się po
Ile plików pobrać, zanim proces się zakończy.
Sieć
-r RATE
--limit-rate
Ograniczenie prędkości
Na przykład 2M albo 500K. Przydatne, gdy resztę pasma potrzebujesz na coś innego.
-N N
--concurrent-fragments
Równoległe fragmenty
Przyspiesza strumienie dzielone na fragmenty. Cztery to sensowny początek.
-R RETRIES
--retries
Ponowne próby
Ile razy powtarzać nieudany fragment. Można wpisać infinite.
Proxy
Adres proxy HTTP, HTTPS albo SOCKS.
Omiń blokadę regionalną
Udaje inne pochodzenie żądania. Na części stron działa, nie na wszystkich.
Udawaj przeglądarkę
Sprawia, że żądania wyglądają jak z prawdziwej przeglądarki. To zwykłe lekarstwo na nagłe 403.
Logowanie i cookies
Cookies z przeglądarki
Czyta wprost twoją zalogowaną sesję. Potrzebne przy treściach prywatnych, z ograniczeniem wieku albo tylko dla członków.
Plik cookies
Plik cookies.txt w formacie Netscape wyeksportowany z przeglądarki.
Transmisje na żywo
Nagrywaj od początku
Zaczyna nagrywanie transmisji od jej początku, a nie od bieżącej chwili.
Czekaj na transmisję
Odpytuje, dopóki zaplanowana transmisja się nie zacznie. MIN-MAX to sekundy między sprawdzeniami.
Obejścia
--user-agent UA
przestarzałe — --add-headers
User agent
Przestarzałe na rzecz --add-headers. Zostało, bo wiele starszych poradników nadal tego używa.
--referer URL
przestarzałe — --add-headers
Referer
Przestarzałe na rzecz --add-headers.
Argumenty extractora
Opcje właściwe danej stronie, na przykład youtube:player_client=web.
Przykłady
--extractor-args "youtube:player_client=web,android"