Przejdź do treści
yt-dlp

Instalacja yt-dlp na Windows

Zainstaluj yt-dlp i ffmpeg na Windows przez winget, Scoop albo zwykłe pobranie i rozwiąż błędy PATH, które pojawiają się potem.

1. Zainstaluj yt-dlp

winget jest dołączony do Windows 10 i 11 i sam zajmuje się PATH, czyli dokładnie tym, co ludzie robią źle przy instalacji ręcznej.

winget install yt-dlp.yt-dlp

Jeśli już używasz Scoopa albo Chocolatey, oba nadają się tak samo dobrze:

scoop install yt-dlp
choco install yt-dlp

Droga ręczna to pojedynczy yt-dlp.exe z oficjalnej strony wydań. Umieść go w katalogu, który jest w PATH — położenie go na pulpicie działa tylko dopóki terminal akurat znajduje się w tym katalogu, a to zwykła przyczyna komunikatu „yt-dlp is not recognized”.

2. Zainstaluj ffmpeg

yt-dlp pobiera i bez ffmpeg, ale wszystko ciekawe go wymaga: scalanie osobnego obrazu i dźwięku, wyodrębnianie MP3, osadzanie napisów albo miniatur, wycinanie fragmentów. Zainstaluj go teraz, a nie po pierwszej niezrozumiałej porażce.

winget install Gyan.FFmpeg

3. Sprawdź, czy się udało

Otwórz nowy terminal — już otwarty wciąż ma stary PATH — i uruchom:

yt-dlp --version
ffmpeg -version

Dwa numery wersji znaczą, że skończone.

Cytowanie w Windows

PowerShell i cmd nie cytują tak jak bash, a polecenie skopiowane z poradnika pisanego pod Linuksa psuje się często właśnie z tego powodu. W PowerShellu apostrofy są dosłowne — to najbezpieczniejszy wybór dla selektora formatu albo szablonu wyjścia. W cmd używaj cudzysłowów. W pliku .bat każdy % trzeba podwoić.

yt-dlp -o '%(title)s.%(ext)s' URL     # PowerShell
yt-dlp -o "%(title)s.%(ext)s" URL     # cmd
yt-dlp -o "%%(title)s.%%(ext)s" URL   # inside a .bat file

Przełącznik powłoki w generatorze tworzy właściwą postać dla każdego z tych przypadków, więc możesz kopiować bez przepisywania.

Aktualizacja

Samodzielny yt-dlp.exe aktualizuje się sam poleceniem yt-dlp -U. Zainstalowany przez winget, Scoopa albo Chocolatey — aktualizuj tym samym narzędziem; samoaktualizacja odmówi, bo plik należy do menedżera pakietów.

Częste pytania

Windows mówi, że yt-dlp nie jest rozpoznawane. Dlaczego?
Plik wykonywalny nie jest w PATH albo terminal był otwarty jeszcze przed instalacją. Otwórz najpierw nowy terminal; jeśli to nie pomoże, instaluj przez winget albo Scoop, które zajmują się PATH za ciebie.
Na Windows yt-dlp nie znajduje ffmpeg.
Zainstaluj go przez winget install Gyan.FFmpeg, otwórz nowy terminal i sprawdź przez ffmpeg -version. Położenie ffmpeg.exe w tym samym folderze co yt-dlp.exe też działa.