yt-dlp — бесплатная программа с открытым кодом для скачивания видео с YouTube и сотен других сайтов. У неё нет окна с кнопками: ссылку вставляют в командную строку, а настройки задают ключами. Это самый гибкий загрузчик из существующих, но к нему нужно привыкнуть. Ниже — установка на Windows, macOS и Android, основные команды для видео, звука и плейлистов, разбор частых ошибок. В конце расскажем, как скачать ролик без командной строки, если программа нужна ради пары видео.
Как установить yt-dlp
Скачивайте yt-dlp только со страницы проекта на GitHub или через официальные менеджеры пакетов. Сборки с посторонних сайтов могут быть изменены.
Windows. На странице релизов проекта скачайте файл yt-dlp.exe и положите его в отдельную папку, например C:\yt-dlp. Откройте эту папку, в адресной строке проводника наберите cmd и нажмите Enter: откроется командная строка, уже настроенная на эту папку. Другой способ — менеджер пакетов winget:
winget install yt-dlp
macOS. Проще всего через Homebrew:
brew install yt-dlp
Через Python на любой системе. Если Python уже стоит, хватит одной команды:
python -m pip install -U "yt-dlp[default]"
Часть [default] подтягивает дополнительные компоненты, без которых YouTube работает хуже.
Android. Готовой программы от разработчиков нет. Её ставят в эмулятор терминала Termux через Python или используют оболочки с открытым кодом. Они работают на yt-dlp, но с обычными кнопками. Ставьте такие приложения только со страниц их проектов.
Что нужно поставить рядом
Сам yt-dlp скачивает файлы, но для двух вещей ему нужны помощники.
ffmpeg. На YouTube видео от 1080p хранится отдельно от звука. yt-dlp скачивает обе дорожки, а склеивает их ffmpeg. Он же переводит звук в MP3. Без него вы получите два отдельных файла или видео в низком качестве. На Windows положите ffmpeg.exe в ту же папку, что и yt-dlp.exe.
Среда JavaScript. Для YouTube yt-dlp теперь нужна среда выполнения JavaScript. Проще всего установить Deno: yt-dlp найдёт его сам. Без неё часть форматов YouTube будет недоступна.
Основные команды
Ссылку лучше брать в кавычки, особенно если в ней есть знаки & или ?.
Скачать видео в лучшем доступном качестве:
yt-dlp "https://www.youtube.com/watch?v=..."
Посмотреть список всех форматов ролика, с разрешением и размером:
yt-dlp -F "ссылка"
Скачать не выше 1080p, видео и звук одним файлом:
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" "ссылка"
Получить именно MP4, а не WebM или MKV:
yt-dlp --merge-output-format mp4 "ссылка"
Скачать только звук в MP3 в наилучшем качестве:
yt-dlp -x --audio-format mp3 --audio-quality 0 "ссылка"
Задать имя файла по названию ролика:
yt-dlp -o "%(title)s.%(ext)s" "ссылка"
Если записываете команду в .bat-файл, знак % нужно удваивать: %%(title)s.
Плейлисты, списки ссылок и субтитры
Плейлист скачивается по ссылке на сам плейлист. Чтобы файлы шли по порядку, добавьте номер в имя:
yt-dlp -o "%(playlist_index)s - %(title)s.%(ext)s" "ссылка на плейлист"
Много отдельных ссылок удобно сложить в текстовый файл, по одной в строке, и передать его целиком:
yt-dlp -a links.txt
Субтитры без самого видео, на русском, в формате SRT:
yt-dlp --write-subs --write-auto-subs --sub-langs ru --convert-subs srt --skip-download "ссылка"
yt-dlp понимает не только YouTube: Rutube, VK и сотни других сайтов работают так же, по ссылке на ролик.
Частые ошибки и что с ними делать
Перестало качать с YouTube, ошибка 403. Чаще всего программа устарела: YouTube регулярно меняет защиту, и yt-dlp обновляется вслед за ним. Обновите его командой yt-dlp -U. Если ставили через pip, повторите команду установки с -U.
«Sign in to confirm you're not a bot». YouTube заподозрил автоматические запросы. Так бывает с адресов VPN и серверов. Помогает запуск с домашнего интернета или передача кук браузера, в котором вы вошли в YouTube:
yt-dlp --cookies-from-browser firefox "ссылка"
На Windows yt-dlp часто не может прочитать куки Chrome из-за шифрования, а с Firefox работает надёжнее.
«Requested format is not available». У ролика нет формата, который вы указали в -f. Посмотрите список командой -F и выберите существующий.
Видео без звука или два файла вместо одного. Не найден ffmpeg. Проверьте, что он лежит рядом с yt-dlp.exe или установлен в системе. Подробнее о проблеме — в статье видео скачалось без звука.
Как скачать видео без командной строки
Если вы открыли yt-dlp ради одного ролика, установка ffmpeg, Deno и разбор ключей займут больше времени, чем само скачивание. Онлайн-сервис делает ту же работу на своём сервере. В Skachok порядок такой:
- Скопируйте ссылку на видео.
- Вставьте её на странице YouTube или на главной Skachok.
- Выберите качество в карточке ролика и нажмите «Скачать».
Дорожки видео и звука склеиваются на сервере, на выходе получается один MP4. Работает и на телефоне, без Termux. Звук в MP3 и M4A — в блоке «Аудио», субтитры SRT, VTT и TXT — там же, в карточке ролика. Обе функции доступны с тарифа Lite. Кроме YouTube поддерживаются VK Видео, Rutube, Дзен, Одноклассники, TikTok и другие площадки.
Бесплатно доступно видео до 720p: 3 скачивания в день без аккаунта и 5 с аккаунтом. Тариф Lite за 99 ₽ в месяц даёт 1080p, звук и субтитры, Pro даёт 2K, Max — 4K и до 50 ссылок за раз. Новый аккаунт получает 2 дня Pro бесплатно. Цены — на странице тарифов.
Что выбрать
yt-dlp лучше, если вы регулярно выгружаете каналы и плейлисты на сотни роликов, пишете скрипты или хотите полный контроль над форматами. Онлайн-сервис удобнее, когда нужен один ролик, вы с телефона или не хотите ничего ставить. Обзор других вариантов, от настольных приложений до ботов, есть в статье какую программу для скачивания видео выбрать.
Скачивайте видео для личного просмотра. Чтобы выложить чужой ролик у себя, нужно разрешение автора.
Частые вопросы
Как пользоваться yt-dlp?
Откройте командную строку в папке с программой и введите yt-dlp и ссылку на видео в кавычках. Файл сохранится в ту же папку. Качество, формат и имя файла задаются ключами -f, --merge-output-format и -o.
Где скачать yt-dlp.exe?
Только на странице релизов проекта на GitHub. Там же лежат сборки для macOS и Linux. Копии с других сайтов могут быть изменены.
Зачем yt-dlp нужен ffmpeg?
Чтобы склеивать отдельные дорожки видео и звука в один файл и переводить звук в MP3. Без ffmpeg видео в 1080p и выше скачается без звука или двумя файлами.
Есть ли yt-dlp онлайн?
Сам yt-dlp — программа для компьютера. Но онлайн-сервисы вроде Skachok делают ту же работу на сервере: вставили ссылку в браузере, получили готовый MP4.
Почему yt-dlp пишет, что я бот?
YouTube проверяет подозрительные запросы, особенно с VPN и серверов. Запустите программу с домашнего интернета или передайте куки браузера ключом --cookies-from-browser.