Przejdź do treści
yt-dlp

Instalacja yt-dlp na macOS

Zainstaluj yt-dlp i ffmpeg na macOS przez Homebrew albo pipx i utrzymuj je w aktualnej wersji.

Ten artykuł nie jest jeszcze przetłumaczony, więc wyświetla się po angielsku. Sam interfejs jest w twoim języku.

1. Install yt-dlp

Homebrew is the path of least resistance and installs both tools in one line.

brew install yt-dlp ffmpeg

Without Homebrew, pipx keeps yt-dlp in its own environment so it cannot collide with anything else you have installed through Python.

pipx install yt-dlp

Avoid a bare pip install into the system Python: recent macOS releases push back on it, and when it does work it tends to break later for unrelated reasons.

2. Install ffmpeg

Included above if you used Homebrew. Otherwise install it separately — merging, MP3 extraction and embedding all depend on it.

brew install ffmpeg

3. Check it worked

yt-dlp --version
ffmpeg -version

If the shell cannot find yt-dlp after a pipx install, run pipx ensurepath and open a new terminal.

Cookies from Safari

--cookies-from-browser safari needs Full Disk Access for your terminal, granted in System Settings → Privacy & Security. Without it the read fails with a permissions error that does not mention the setting. Chrome and Firefox work without it.

Updating

brew upgrade yt-dlp     # Homebrew
pipx upgrade yt-dlp     # pipx

Częste pytania

Po instalacji przez pipx macOS nie znajduje yt-dlp.
Uruchom pipx ensurepath, a potem otwórz nowy terminal, żeby zaktualizowany PATH został wczytany.
Czy do cookies na macOS trzeba czegoś jeszcze?
Tylko przy Safari: --cookies-from-browser safari wymaga pełnego dostępu do dysku dla twojego terminala, w Ustawieniach systemowych → Prywatność i bezpieczeństwo. Chrome i Firefox działają bez tego.
Jak zaktualizować yt-dlp?
Samodzielny plik binarny aktualizuje się przez yt-dlp -U. Jeśli instalowałeś z menedżera pakietów, aktualizuj przez niego: samodzielna aktualizacja odmówi ruszania pliku, który do niej nie należy. Aktualizacja rozwiązuje więcej problemów niż jakikolwiek flag.