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

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

Установите yt-dlp и ffmpeg на Windows через winget, Scoop или обычной загрузкой и разберитесь с ошибками PATH, которые появляются потом.

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

winget поставляется с Windows 10 и 11 и сам разбирается с PATH — как раз с тем, что при установке вручную обычно делают неправильно.

winget install yt-dlp.yt-dlp

Если вы уже пользуетесь Scoop или Chocolatey, оба варианта одинаково хороши:

scoop install yt-dlp
choco install yt-dlp

Ручной путь — один файл yt-dlp.exe со страницы официальных релизов. Положите его в папку, которая есть в PATH: на рабочем столе он работает, только пока терминал случайно находится в той же папке, и это обычная причина «yt-dlp is not recognized».

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

yt-dlp скачивает и без ffmpeg, но всё интересное требует его: склейка отдельных видео и звука, извлечение MP3, встраивание субтитров или обложек, вырезание фрагментов. Установите сразу, а не после первой непонятной ошибки.

winget install Gyan.FFmpeg

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

Откройте новый терминал — в уже открытом остался старый PATH — и выполните:

yt-dlp --version
ffmpeg -version

Два номера версий означают, что всё готово.

Кавычки в Windows

PowerShell и cmd экранируют не так, как bash, и команда, скопированная из ориентированного на Linux руководства, часто ломается ровно поэтому. В PowerShell одинарные кавычки буквальны — самый безопасный вариант для селектора формата или шаблона вывода. В cmd используйте двойные кавычки. В файле .bat каждый % надо удваивать.

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

Переключатель шелла в генераторе выдаёт правильную форму для каждого из этих случаев, так что копировать можно без переделки.

Обновление

Отдельный yt-dlp.exe обновляет себя сам командой yt-dlp -U. Если ставили через winget, Scoop или Chocolatey, обновляйте тем же инструментом — самообновление откажется, потому что файлом владеет пакетный менеджер.

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

Windows пишет, что yt-dlp не распознан. Почему?
Исполняемый файл не в PATH либо терминал был открыт ещё до установки. Сначала откройте новый терминал; если не помогло — поставьте через winget или Scoop, они сами разбираются с PATH.
На Windows yt-dlp не находит ffmpeg.
Установите его командой winget install Gyan.FFmpeg, откройте новый терминал и проверьте через ffmpeg -version. Положить ffmpeg.exe в ту же папку, где yt-dlp.exe, тоже работает.