Перейти к содержимому
yt-dlp

Установка yt-dlp на macOS

Установите yt-dlp и ffmpeg на macOS через Homebrew или pipx и держите их в актуальном состоянии.

1. Установите yt-dlp

Homebrew — путь наименьшего сопротивления: ставит оба инструмента одной строкой.

brew install yt-dlp ffmpeg

Без Homebrew pipx держит yt-dlp в отдельном окружении, так что он не столкнётся ни с чем, что вы ставили через Python.

pipx install yt-dlp

Избегайте голого pip install в системный Python: свежие версии macOS этому сопротивляются, а когда это всё-таки срабатывает, потом обычно ломается по посторонним причинам.

2. Установите ffmpeg

Уже включён выше, если вы использовали Homebrew. Иначе поставьте отдельно — склейка, извлечение MP3 и встраивание зависят от него.

brew install ffmpeg

3. Проверьте, что получилось

yt-dlp --version
ffmpeg -version

Если после установки через pipx шелл не находит yt-dlp, выполните pipx ensurepath и откройте новый терминал.

Cookie из Safari

--cookies-from-browser safari требует Full Disk Access для вашего терминала, который выдаётся в System Settings → Privacy & Security. Без него чтение падает с ошибкой прав, в которой эта настройка не упоминается. Chrome и Firefox работают и без неё.

Обновление

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

Частые вопросы

После установки через pipx macOS не находит yt-dlp.
Выполните pipx ensurepath, затем откройте новый терминал, чтобы обновлённый PATH подхватился.
Нужно ли что-то ещё для cookies на macOS?
Только для Safari: --cookies-from-browser safari требует полного доступа к диску для вашего терминала (Системные настройки → Конфиденциальность и безопасность). Chrome и Firefox работают без этого.