Команда youtube-dl возвращает ошибку «command not found» или не скачивает видео — с этих двух ситуаций чаще всего начинается знакомство с этой утилитой. Причины обычно простые: программа не добавлена в переменную окружения PATH, либо используется устаревшая версия, которая не справляется с изменениями на стороне видеохостинга. Обе проблемы решаются за несколько минут, если знать правильный порядок действий.
YouTube-dl — это консольная утилита с открытым исходным кодом для скачивания видео и аудио с YouTube и сотен других сайтов. У неё нет графического интерфейса: вся работа ведётся через команды в терминале или командной строке. В этой инструкции разберём установку, базовые и продвинутые команды, а также типичные ошибки и способы их устранения.
Что такое youtube-dl и когда он нужен
Утилита написана на языке Python и распространяется бесплатно. Она умеет скачивать ролики в разном качестве, извлекать только аудиодорожку, сохранять целые плейлисты и каналы, загружать субтитры и метаданные. Для многих задач это удобнее онлайн-сервисов: нет рекламы, ограничений на длину видео и необходимости вставлять ссылку в чужой сайт.
Программа работает на Windows, Linux и macOS. Единственная особенность — отсутствие окна с кнопками, поэтому новичкам поначалу непривычно. На практике достаточно запомнить пять-шесть команд, чтобы закрыть большинство сценариев использования.
Отдельно стоит знать про yt-dlp — форк проекта, который обновляется активнее и часто лучше справляется с изменениями на стороне YouTube. Синтаксис команд у них практически одинаковый, поэтому всё описанное ниже применимо к обеим утилитам.
Установка youtube-dl на Windows, Linux и macOS
Способ установки зависит от операционной системы. На Windows проще всего скачать готовый исполняемый файл youtube-dl.exe с официальной страницы проекта и поместить его в отдельную папку, например C:\youtube-dl. Чтобы команда работала из любого каталога, эту папку нужно добавить в системную переменную PATH через «Система → Дополнительные параметры системы → Переменные среды».
На Linux и macOS установка обычно выполняется через пакетный менеджер или напрямую. Пример для систем с пакетным менеджером apt:
sudo apt install youtube-dlАльтернативный вариант — установка через pip, менеджер пакетов Python. Этот способ часто даёт более свежую версию, чем репозитории дистрибутива:
pip install --upgrade youtube-dlПосле установки проверьте работоспособность командой youtube-dl --version. Если терминал выводит номер версии — всё готово к работе. Если появляется сообщение, что команда не найдена, проверьте переменную PATH или перезапустите терминал.
☑️ Подготовка к первому запуску
Базовые команды: первое скачивание
Самая простая команда состоит из имени программы и ссылки на ролик. Откройте терминал в папке, куда хотите сохранить файл, и выполните:
youtube-dl https://www.youtube.com/watch?v=VIDEO_IDПо умолчанию утилита сама подбирает оптимальный формат и сохраняет видео в текущую директорию. Прогресс загрузки отображается прямо в консоли: скорость, процент и оставшееся время.
Для скачивания только звука используется параметр -x с указанием аудиоформата:
youtube-dl -x --audio-format mp3 URLЗдесь важен нюанс: извлечение и конвертация аудио требуют установленного ffmpeg. Без него команда завершится ошибкой, поэтому этот пакет стоит установить заранее — он пригодится и для склейки видео высокого разрешения, где картинка и звук идут отдельными потоками.
Выбор качества и формата видео
Посмотреть все доступные для ролика форматы помогает ключ -F. Утилита выведет таблицу с кодами форматов, разрешением, кодеками и наличием звука:
youtube-dl -F URLДальше нужный вариант выбирается по его коду через параметр -f. Например, youtube-dl -f 22 URL скачает конкретный формат из списка. Есть и удобные псевдонимы: best — максимальное качество одним файлом, worst — минимальное, bestaudio — только лучшая аудиодорожка.
| Команда | Что делает | Когда использовать |
|---|---|---|
youtube-dl URL | Скачивает видео в формате по умолчанию | Быстрое сохранение одного ролика |
youtube-dl -F URL | Показывает список доступных форматов | Перед выбором конкретного качества |
youtube-dl -f best URL | Максимальное качество одним файлом | Когда важно качество картинки |
youtube-dl -x --audio-format mp3 URL | Извлекает аудио и конвертирует в MP3 | Музыка, подкасты, лекции |
youtube-dl --write-sub --sub-lang ru URL | Скачивает субтитры на русском | Видео на иностранном языке |
Скачивание плейлистов и пакетная загрузка
Если вставить ссылку на плейлист, утилита по умолчанию скачает все ролики из него по очереди. Чтобы видео нумеровались в порядке следования, добавьте порядковый номер в шаблон имени файла:
youtube-dl -o "%(playlist_index)s - %(title)s.%(ext)s" URL_ПЛЕЙЛИСТАДля загрузки нескольких разрозненных ссылок удобно составить текстовый файл — по одной ссылке на строку — и передать его через параметр -a:
youtube-dl -a links.txtПри больших объёмах полезны дополнительные ключи. Например, --download-archive archive.txt записывает ID уже скачанных роликов в файл и при повторном запуске пропускает их — так можно регулярно обновлять локальную копию канала, не качая старые видео заново.
- 📋
--playlist-start 5— начать загрузку с пятого ролика плейлиста - 📋
--playlist-end 20— остановиться на двадцатом видео - 📋
--limit-rate 1M— ограничить скорость загрузки, чтобы не забивать канал - 📋
--sleep-interval 10— пауза между роликами, снижает риск временных ограничений со стороны сервиса
⚠️ Внимание: массовое скачивание может нарушать условия использования видеохостинга, а загруженные ролики защищены авторским правом. Используйте утилиту для контента, который вы вправе сохранять: собственные видео, материалы с лицензией Creative Commons и т. п.
Типичные ошибки и их решение
Самая частая жалоба — ошибка Unable to extract video data или HTTP Error 403. Возможная причина — устаревшая версия утилиты: видеохостинги регулярно меняют внутренние механизмы отдачи контента, и старые сборки перестают работать. Первое действие в такой ситуации — обновление:
youtube-dl -UЕсли программа установлена через pip, обновляйте её соответственно через pip install --upgrade youtube-dl. Когда обновление не помогает, имеет смысл попробовать yt-dlp — этот форк обычно быстрее реагирует на изменения.
- 🔧 «command not found» / «не является командой» — программа не в PATH или терминал не перезапущен после установки
- 🔧 «HTTP Error 403» — возможна устаревшая версия, временное ограничение по IP или региональная блокировка ролика
- 🔧 «ffmpeg not found» — не установлен ffmpeg, необходимый для конвертации и склейки потоков
- 🔧 Видео без звука в высоком качестве — скачан только видеопоток; выбирайте формат со встроенным звуком или установите ffmpeg для автоматической склейки
⚠️ Внимание: скачивайте youtube-dl и yt-dlp только с официальных источников — страниц проектов на GitHub или через штатные пакетные менеджеры. Сторонние сайты иногда распространяют модифицированные сборки с вредоносным кодом.
Почему видео 1080p скачивается без звука
На YouTube ролики в высоком разрешении часто хранятся раздельно: видеопоток и аудиопоток — это два разных файла. YouTube-dl умеет скачать оба и склеить их через ffmpeg в один файл. Если ffmpeg не установлен, склейка невозможна, и в итоге остаётся «немое» видео. Решение — установить ffmpeg и повторить загрузку, либо выбрать формат со встроенным звуком (обычно до 720p).
Полезные дополнительные параметры
За пределами базовых сценариев утилита открывает немало возможностей. Ключ --write-thumbnail сохраняет обложку ролика, --write-info-json — полные метаданные в формате JSON, --embed-subs встраивает субтитры прямо в видеофайл (опять же через ffmpeg). Для работы через прокси предусмотрен параметр --proxy с адресом сервера.
Часто используемые настройки не обязательно вводить каждый раз: их можно записать в конфигурационный файл. На Linux это ~/.config/youtube-dl/config, на Windows — файл youtube-dl.conf в профиле пользователя. Каждая строка файла — один параметр, и утилита будет применять их автоматически при любом запуске.
Если поведение программы отличается от описанного, проверьте актуальную документацию вашей версии командой youtube-dl --help — она выводит полный список поддерживаемых ключей с краткими пояснениями.
FAQ: частые вопросы о youtube-dl
Чем youtube-dl отличается от yt-dlp?
Yt-dlp — это форк (ответвление) проекта youtube-dl, который обновляется активнее и содержит дополнительные функции. Синтаксис команд почти полностью совместим, поэтому переход между утилитами не требует переучивания. Если youtube-dl выдаёт ошибки на скачивании, попробуйте yt-dlp.
Легально ли скачивать видео через youtube-dl?
Это зависит от контента и законодательства вашей страны. Загрузка собственных роликов, материалов с открытыми лицензиями или контента, для которого правообладатель разрешил скачивание, обычно не вызывает проблем. Сохранение чужого защищённого авторским правом контента может нарушать условия сервиса и закон.
Почему команда не находится после установки на Windows?
Наиболее вероятная причина — папка с исполняемым файлом не добавлена в переменную окружения PATH, либо командная строка была открыта до изменения PATH. Добавьте путь к папке в «Переменные среды» и откройте новое окно терминала.
Как скачать видео, доступное только по возрасту или после входа?
Для таких случаев предусмотрена передача cookies из браузера — например, параметром --cookies-from-browser chrome (в yt-dlp) или файлом cookies через --cookies. Учтите, что доступ всё равно должен быть у вашего аккаунта.
Можно ли пользоваться youtube-dl без командной строки?
Да, существуют сторонние графические оболочки, которые работают поверх youtube-dl или yt-dlp и предоставляют окно с кнопками. Однако сама утилита остаётся консольной, и знание базовых команд полезно в любом случае — это упрощает диагностику ошибок.