Пошаговое руководство по настройке для Windows, macOS и Linux.
yt-dlp — это мощный медиа-загрузчик командной строки (активно поддерживаемый форк youtube-dl), который позволяет скачивать видео и аудио с тысяч сайтов. Поскольку он работает в терминале, у него нет графического интерфейса.
Для скачивания видео высокого качества (1080p, 4K) или извлечения MP3 необходимо установить FFmpeg. Настоятельно рекомендуется установить Deno.
Не хотите устанавливать ПО? Вы можете запустить любую команду прямо в нашей онлайн-консоль без какой-либо настройки.
Windows 10 (1809+) и Windows 11 включают Windows Package Manager (winget) по умолчанию. Он автоматически управляет установкой, путями и обновлениями.
winget install yt-dlpДля продвинутых пользователей, использующих менеджеры пакетов командной строки в Windows.
scoop install yt-dlpchoco install yt-dlpСкачать автономный исполняемый файл напрямую.
C:\yt-dlp\, и переместите скачанный yt-dlp.exe в неё.
C:\yt-dlp, затем нажмите OK во всех диалоговых окнах.Homebrew — это стандартный менеджер пакетов для macOS. Он автоматически разрешает все зависимости, включая Python и FFmpeg.
brew install yt-dlpИли вы можете установить yt-dlp с помощью менеджера пакетов MacPorts.
sudo port install yt-dlpСкачать скомпилированный файл прямо в локальный путь выполнения.
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-dlpИспользование менеджера pip Python гарантирует получение самых последних обновлений скриптов извлечения видео.
python3 -m pip install -U yt-dlpУстановите yt-dlp через менеджер пакетов вашего дистрибутива Linux.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlpСкачать автономный бинарный файл Linux прямо в локальный путь исполняемых файлов.
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 — это библиотека мультимедиа с открытым исходным кодом, которую yt-dlp использует для объединения отдельных видеодорожек HD (1080p, 4K) и аудиодорожек или для извлечения аудио в MP3. Без FFmpeg yt-dlp загружает только потоки 720p или ниже со встроенным звуком.
Установите FFmpeg через winget одной командой:
winget install Gyan.FFmpegИли скачайте сборки с сайта Gyan.dev, распакуйте архив и добавьте папку bin в переменную окружения PATH.
При использовании Homebrew устанавливается автоматически. Для ручной установки:
brew install ffmpegУстановите через системный менеджер пакетов:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno — современная среда выполнения JavaScript. yt-dlp использует Deno для выполнения алгоритмов сигнатур YouTube. Установка Deno помогает поддерживать максимальную скорость.
Установите Deno через winget одной командой:
winget install DenoLand.DenoИли используйте Scoop: scoop install deno
Установите Deno через Homebrew:
brew install denoУстановите Deno с помощью официального скрипта:
curl -fsSL https://deno.land/install.sh | shУбедитесь, что unzip и curl установлены перед запуском этого скрипта.
После установки откройте терминал (PowerShell, Командная строка или Terminal.app) и проверьте работоспособность, выполнив команду проверки версии.
Выполните команду проверки версии в терминале:
yt-dlp --versionПри успешной установке будет выведен номер версии с датой выпуска:
2026.06.18Если появляется ошибка «Команда не найдена», перезапустите терминал или убедитесь, что папка с yt-dlp правильно добавлена в системную переменную окружения PATH.
Возникли проблемы? Вот решения наиболее частых ошибок yt-dlp в Windows, macOS и Linux.
yt-dlp отсутствует в системном PATH. Если вы установили через winget, Homebrew или pip, просто закройте и снова откройте терминал — PATH обновляется только для новых сессий.
yt-dlp.exe вручную, необходимо добавить его папку в переменную окружения PATH. Смотрите подробные инструкции по настройке PATH выше.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp или brew upgrade yt-dlp).
yt-dlp -U), так как алгоритмы JavaScript от YouTube часто обновляются.
yt-dlp.exe собран с помощью PyInstaller, который упаковывает интерпретатор Python в один исполняемый файл. Антивирусы часто реагируют на сборки PyInstaller, так как аналогичная техника используется некоторым вредоносным ПО — но сам yt-dlp абсолютно безопасен.
winget install yt-dlp (проверенные Microsoft пакеты не блокируются).
YouTube и другие видеоплатформы часто обновляют протоколы потоковой передачи, что может вызвать прекращение работы старых версий yt-dlp. Поддерживайте локальную установку в актуальном состоянии для автоматического решения ошибок извлечения.
Если вы скачали бинарный файл напрямую или установили через pip, выполните встроенную команду обновления в терминале:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Начните с этих базовых команд в терминале:
| Цель | Команда | Действия |
|---|---|---|
| Скачать видео (лучшее качество) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| Извлечь MP3 аудио | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Да, yt-dlp безопасен. Это 100% проект с открытым исходным кодом под лицензией Unlicense, размещённый на GitHub с 100 000+ звёзд и сотнями активных участников. Каждая строка кода доступна для публичного аудита.
winget, чтобы избежать этого.Если вы предпочитаете не запускать исполняемые файлы локально, наша онлайн-консоль запускает yt-dlp на наших серверах — ничего не устанавливается на ваше устройство.
100K+ ⭐
Открытый исходный код на GitHub
Выполняйте команды yt-dlp прямо на нашем сервере. Используйте наш веб-интерфейс для загрузки плейлистов, записи трансляций и мгновенного извлечения аудио.