Przewodnik konfiguracji krok po kroku dla Windows, macOS i Linux.
yt-dlp to potężny pobieracz mediów wiersza poleceń (aktywnie utrzymywany fork youtube-dl), który pozwala pobierać wideo i dźwięk z tysięcy stron. Ponieważ działa w terminalu, nie ma natywnego interfejsu graficznego.
Aby pobierać wysokiej jakości filmy (1080p, 4K itp.) lub wyodrębniać dźwięk MP3, musisz zainstalować FFmpeg. Ponadto instalacja środowiska uruchomieniowego JavaScript jak Deno jest wysoce zalecana do omijania ograniczeń prędkości YouTube i blokad botów. Poniżej znajdziesz pełny przewodnik konfiguracji tych narzędzi.
Nie chcesz instalować oprogramowania? Możesz uruchomić dowolne polecenie bezpośrednio w naszej konsola online bez żadnej konfiguracji.
Windows 10 (1809+) i Windows 11 domyślnie zawierają Windows Package Manager (winget). Automatycznie zarządza instalacją, ścieżkami i aktualizacjami.
winget install yt-dlpDla zaawansowanych użytkowników korzystających z menedżerów pakietów wiersza poleceń na Windows.
scoop install yt-dlpchoco install yt-dlpPobierz samodzielny plik wykonywalny bezpośrednio.
C:\yt-dlp\, i przenieś pobrany yt-dlp.exe do niego.
C:\yt-dlp, następnie kliknij OK we wszystkich oknach dialogowych.Homebrew to standardowy menedżer pakietów dla macOS. Automatycznie rozwiązuje wszystkie zależności, w tym Python i FFmpeg.
brew install yt-dlpAlternatywnie możesz zainstalować yt-dlp za pomocą menedżera pakietów MacPorts.
sudo port install yt-dlpPobierz skompilowany plik binarny bezpośrednio do lokalnej ścieżki wykonania.
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpUżywanie menedżera pip Python zapewnia bezpośrednie otrzymywanie najnowszych aktualizacji skryptów ekstrakcji wideo.
python3 -m pip install -U yt-dlpZainstaluj yt-dlp przez menedżer pakietów dystrybucji Linux.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlpPobierz samodzielny plik binarny Linux bezpośrednio do lokalnej ścieżki plików wykonywalnych.
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpFFmpeg to biblioteka mediów open-source, której yt-dlp używa do łączenia oddzielnych ścieżek wideo HD (1080p, 4K) i audio lub do wyodrębniania dźwięku jako MP3. Bez FFmpeg yt-dlp pobierze tylko strumienie 720p lub niższej jakości z wbudowanym dźwiękiem.
Zainstaluj FFmpeg przez winget jednym poleceniem:
winget install Gyan.FFmpegAlternatywnie pobierz kompilacje z Gyan.dev, rozpakuj i dodaj katalog bin do zmiennej środowiskowej PATH.
Jeśli używasz Homebrew, instaluje się automatycznie. Ręczna instalacja:
brew install ffmpegZainstaluj przez systemowy menedżer pakietów:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno to nowoczesne środowisko uruchomieniowe JavaScript. yt-dlp używa Deno do wykonywania algorytmów deszyfrowania podpisów YouTube opartych na JavaScript. Instalacja Deno pomaga ominąć ograniczenia prędkości pobierania i blokady wykrywania botów "n-challenge".
Zainstaluj Deno przez winget jednym poleceniem:
winget install DenoLand.DenoAlternatywnie użyj Scoop: scoop install deno
Zainstaluj Deno przez Homebrew:
brew install denoZainstaluj Deno za pomocą oficjalnego skryptu:
curl -fsSL https://deno.land/install.sh | shUpewnij się, że unzip i curl są zainstalowane przed uruchomieniem tego skryptu.
Po instalacji otwórz terminal (PowerShell, Wiersz poleceń lub Terminal.app) i zweryfikuj działanie uruchamiając polecenie sprawdzenia wersji.
Wykonaj polecenie sprawdzenia wersji w terminalu:
yt-dlp --versionJeśli instalacja się powiodła, wydrukuje numer wersji z datą wydania:
2026.06.18Jeśli pojawi się "Polecenie nie znalezione", upewnij się, że uruchomiłeś terminal ponownie lub folder z yt-dlp jest prawidłowo dodany do systemowej zmiennej PATH.
Napotykasz problemy? Oto rozwiązania najczęstszych błędów yt-dlp na Windows, macOS i Linux.
yt-dlp nie jest w systemowym PATH. Jeśli zainstalowałeś przez winget, Homebrew lub pip, po prostu zamknij i otwórz terminal ponownie — PATH jest aktualizowany tylko dla nowych sesji.
yt-dlp.exe ręcznie, musisz dodać jego folder do zmiennej środowiskowej PATH. Zobacz szczegółowe kroki konfiguracji PATH powyżej.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp lub brew upgrade yt-dlp).
yt-dlp -U), ponieważ metody obejścia ograniczeń są często aktualizowane.
yt-dlp.exe jest zbudowany za pomocą PyInstaller, który pakuje interpreter Pythona w pojedynczy plik wykonywalny. Oprogramowanie antywirusowe często oznacza pakiety PyInstaller, ponieważ ta sama technika pakowania jest używana przez malware — ale sam yt-dlp jest całkowicie bezpieczny.
winget install yt-dlp (pakiety zweryfikowane przez Microsoft nie są oznaczane).
YouTube i inne platformy wideo często aktualizują protokoły streamingu, co może powodować awarię starszych wersji yt-dlp. Utrzymuj lokalną instalację aktualną, aby automatycznie rozwiązywać błędy ekstrakcji.
Jeśli pobrałeś plik binarny bezpośrednio lub zainstalowałeś przez pip, uruchom wbudowane polecenie aktualizacji w terminalu:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Zacznij od tych podstawowych poleceń w terminalu:
| Cel | Polecenie | Akcje |
|---|---|---|
| Pobierz wideo (najlepsza jakość) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| Wyodrębnij dźwięk MP3 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Tak, yt-dlp jest bezpieczny. To 100% projekt open-source na licencji Unlicense, hostowany na GitHub z ponad 100 000 gwiazdek i setkami aktywnych kontrybutorów. Każda linia kodu jest publicznie audytowalna.
winget, aby tego uniknąć.Jeśli wolisz nie uruchamiać plików wykonywalnych lokalnie, nasza konsola online uruchamia yt-dlp na naszych serwerach — nic nie jest instalowane na urządzeniu.
100K+ ⭐
Open Source na GitHub
Uruchamiaj polecenia yt-dlp bezpośrednio na naszym serwerze. Użyj naszego interfejsu webowego do pobierania playlist, nagrywania transmisji i natychmiastowego wyodrębniania dźwięku.