Пошаговое руководство по настройке для Windows, macOS и Linux.
yt-dlp — это мощный медиа-загрузчик командной строки (активно поддерживаемый форк youtube-dl), который позволяет скачивать видео и аудио с тысяч сайтов. Поскольку он работает в терминале, у него нет графического интерфейса.
Для загрузки видео высокого качества (1080p, 4K и т.д.) или извлечения MP3 аудио необходимо установить FFmpeg. Также настоятельно рекомендуется установить среду выполнения JavaScript, например Deno, для обхода ограничения скорости и блокировок YouTube. Ниже полное руководство по настройке этих инструментов.
Не хотите устанавливать ПО? Вы можете запустить любую команду прямо в нашей онлайн-консоль без какой-либо настройки.
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 на JavaScript. Установка Deno помогает обходить ограничение скорости загрузки YouTube и блокировки «n-challenge».
Установите 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), так как методы обхода ограничений часто обновляются.
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 прямо на нашем сервере. Используйте наш веб-интерфейс для загрузки плейлистов, записи трансляций и мгновенного извлечения аудио.