Команда yt-dlp https://youtube.com/watch?v=... возвращает ошибку «Unable to extract video data» — самый частый симптом, с которым сталкиваются пользователи YouTube-загрузчиков с GitHub. Причина почти всегда одна: YouTube изменил внутренние механизмы выдачи видеопотоков, а установленная версия программы устарела. Решение — обновление до актуального релиза, и именно поэтому GitHub остаётся основным источником таких инструментов: новые версии появляются там раньше, чем где бы то ни было.
В этой статье разберём, какие проекты для скачивания видео с YouTube существуют на GitHub, как правильно установить yt-dlp — наиболее активно поддерживаемый форк классического youtube-dl, какие команды понадобятся для типовых задач и как диагностировать ошибки. Отдельно остановимся на том, как отличить надёжный репозиторий от заброшенного или потенциально опасного.
Какие YouTube-загрузчики есть на GitHub
Экосистема open-source загрузчиков довольно широкая, но реально поддерживаемых проектов немного. Основной инструмент — yt-dlp, форк youtube-dl с более частыми обновлениями и расширенной поддержкой сайтов. Сам оригинальный youtube-dl обновляется заметно реже, из-за чего у его пользователей чаще возникают ошибки извлечения данных.
Помимо консольных утилит, на GitHub публикуются графические оболочки, которые используют yt-dlp как движок. Они подходят тем, кто не хочет работать с командной строкой, но добавляют зависимость от второго проекта: если оболочка заброшена, обновление движка придётся делать вручную.
- 🎬 yt-dlp — консольный загрузчик, самый активно поддерживаемый проект в своей нише
- 📦 youtube-dl — классический предшественник, обновления выходят редко
- 🖥️ GUI-оболочки — графические интерфейсы поверх yt-dlp для Windows, Linux и macOS
- 🔌 Библиотеки для разработчиков — модули для встраивания скачивания в собственные скрипты
Как отличить надёжный репозиторий от заброшенного
Прежде чем скачивать что-либо с GitHub, проверьте несколько признаков живого проекта. Откройте страницу репозитория и посмотрите на дату последнего коммита и последнего релиза: если обновлений не было больше года, утилита, скорее всего, уже не справляется с текущей версией YouTube. Также обратите внимание на раздел Issues — живой проект отличается активными ответами разработчиков на сообщения об ошибках.
Осторожность нужна и с малоизвестными форками. Загрузчик — это исполняемый файл, который вы запускаете на своём компьютере, поэтому скачивать сборки стоит только из раздела Releases официального репозитория проекта, а не со сторонних сайтов и не из комментариев. Никогда не запускайте «сборки yt-dlp с дополнительными функциями» из непроверенных источников — это распространённый способ распространения вредоносного ПО.
⚠️ Внимание: скачивание видео с YouTube может нарушать условия использования сервиса. Используйте загрузчики только для контента, на который у вас есть права, либо для материалов, распространяемых под свободными лицензиями.
Установка yt-dlp на Windows
Есть несколько способов установки, и все они описаны в официальном репозитории проекта. Самый простой вариант для Windows — скачать готовый исполняемый файл yt-dlp.exe из раздела Releases и поместить его в отдельную папку, например C:\Tools\yt-dlp. Чтобы вызывать утилиту из любого каталога, добавьте эту папку в системную переменную PATH через настройки окружения Windows.
Альтернативный путь — установка через пакетный менеджер. Если у вас есть Python, подойдёт команда:
pip install -U yt-dlpПользователям Windows 10 и 11 также доступен менеджер winget: winget install yt-dlp. После установки проверьте результат командой yt-dlp --version — она должна вывести номер версии без ошибок.
☑️ Проверка готовности к работе
Отдельно стоит установить ffmpeg — без него yt-dlp не сможет объединять видео- и аудиопотоки высокого качества в один файл и конвертировать форматы. Библиотека распространяется бесплатно, а yt-dlp находит её автоматически, если исполняемые файлы лежат в одной папке с ним или прописаны в PATH.
Основные команды для скачивания
Базовый синтаксис предельно прост: укажите URL ролика после имени команды. По умолчанию yt-dlp выбирает наилучшее доступное качество и сохраняет файл в текущую папку.
yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"Для типовых задач предусмотрены готовые опции. Вот те, которые понадобятся чаще всего:
- 🎵
-x --audio-format mp3— извлечь только звук и сохранить как аудиофайл - 📋
-F— показать список всех доступных форматов и качеств без скачивания - 🎯
-f "номер_формата"— скачать конкретный формат из списка - 📜
--write-subs --sub-langs ru— загрузить субтитры на указанном языке, если они есть у видео - 📁
-o "Папка/%(title)s.%(ext)s"— задать шаблон имени и место сохранения
Для скачивания целого плейлиста достаточно передать ссылку на него — утилита обработает все ролики последовательно. Ограничить объём можно параметрами вроде --playlist-items 1-10, если нужны только первые десять видео.
Почему ссылку лучше брать в кавычки
URL YouTube часто содержит символ & — командная строка Windows воспринимает его как разделитель команд. Без кавычек часть ссылки после & потеряется, и yt-dlp получит неполный или неверный адрес.
Сравнение популярных решений
Чтобы выбрать подходящий инструмент, полезно видеть различия в одном месте. Таблица ниже отражает общее положение проектов; конкретные детали могут меняться по мере выхода обновлений, поэтому сверяйтесь со страницами репозиториев.
| Проект | Интерфейс | Активность обновлений | Кому подходит |
|---|---|---|---|
| yt-dlp | Командная строка | Высокая, частые релизы | Опытным пользователям и для автоматизации |
| youtube-dl | Командная строка | Низкая, редкие обновления | Тем, кто привык к классическому инструменту |
| GUI-оболочки на базе yt-dlp | Графический | Зависит от конкретного проекта | Новичкам, не желающим работать с консолью |
| Библиотеки (Python-модули) | Код | Разная | Разработчикам собственных скриптов |
Типичные ошибки и их диагностика
Наиболее частая проблема — «Unable to extract» и её вариации. Порядок действий здесь такой: сначала обновите программу командой yt-dlp -U (или переустановите через пакетный менеджер), затем повторите попытку. Если ошибка сохраняется, загляните в раздел Issues репозитория — вероятно, о проблеме уже сообщили другие пользователи, и там есть временное решение.
Вторая группа ошибок связана с ffmpeg: программа скачивает потоки, но не может их объединить. Проверьте, доступен ли ffmpeg, командой ffmpeg -version. Если система отвечает, что команда не найдена, — установите библиотеку или положите её файлы рядом с yt-dlp.
Третья ситуация — ошибки доступа к роликам с ограничением по возрасту или региону. Часть таких видео требует авторизации; yt-dlp поддерживает передачу cookies из браузера через опцию --cookies-from-browser, однако используйте эту возможность осознанно и только со своим аккаунтом.
⚠️ Внимание: не пытайтесь обходить региональные ограничения и защиту контента с помощью сторонних «патчей» и модифицированных сборок — это рискованно с точки зрения безопасности и может нарушать законодательство вашей страны.
Как поддерживать загрузчик в рабочем состоянии
YouTube регулярно меняет внутренние механизмы, поэтому любой загрузчик периодически «ломается». Это нормальный цикл жизни таких инструментов, а не признак плохой программы. Ваша задача — встроить обновление в привычку: выполняйте yt-dlp -U перед массовым скачиванием или хотя бы раз в несколько недель.
Полезно также подписаться на уведомления о релизах в репозитории — на GitHub для этого есть кнопка Watch с выбором опции отслеживания только релизов. Тогда вы будете узнавать о новых версиях сразу, не проверяя страницу вручную.
⚠️ Внимание: если проект, которым вы пользуетесь, перестал обновляться, не продолжайте использовать старую версию «пока работает» — переходите на активно поддерживаемую альтернативу. Устаревшие загрузчики не только перестают справляться с задачей, но и могут содержать неисправленные уязвимости.
Часто задаваемые вопросы
Легально ли использовать YouTube downloader с GitHub?
Сам по себе инструмент легален — это открытое программное обеспечение. Однако скачивание видео может нарушать условия использования YouTube, а загрузка защищённого авторским правом контента без разрешения правообладателя — законодательство вашей страны. Безопасный сценарий: скачивание собственных роликов, материалов под свободными лицензиями и контента, для которого автор явно разрешил загрузку.
Чем yt-dlp отличается от youtube-dl?
yt-dlp — это форк youtube-dl, который обновляется значительно чаще, поддерживает больше сайтов и содержит дополнительные функции, например расширенные опции обработки метаданных. На практике это означает, что yt-dlp реже «ломается» при изменениях на стороне YouTube и быстрее получает исправления.
Почему скачанное видео без звука или звук отдельно от видео?
YouTube хранит видео высокого качества и аудио раздельными потоками. Если в системе нет ffmpeg, yt-dlp не может объединить их в один файл. Установите ffmpeg и повторите скачивание — программа автоматически склеит потоки.
Можно ли скачивать видео в разрешении 1080p и выше?
Да, если такое качество доступно у ролика. Сначала выполните yt-dlp -F "ссылка", чтобы увидеть список форматов, затем укажите нужный через -f. Для объединения видеопотока высокого разрешения со звуком снова потребуется ffmpeg.
Безопасно ли запускать exe-файл, скачанный с GitHub?
Файл из раздела Releases официального репозитория yt-dlp — это стандартный способ распространения проекта. Риск появляется, когда установщик скачан со сторонних сайтов, из комментариев или из неизвестных форков. Правило простое: только официальный репозиторий, только раздел Releases.