Команда pip install youtube-dl завершается ошибкой «pip не является внутренней или внешней командой» или устанавливает устаревшую версию пакета — это две самые частые проблемы при попытке поставить youtube-dl через пакетный менеджер Python. Причина обычно кроется не в самом youtube-dl, а в окружении: Python не добавлен в PATH, используется старая версия pip или в системе конфликтуют несколько интерпретаторов.
Ниже разберём установку youtube-dl через pip пошагово: от проверки Python до решения типовых ошибок. Также рассмотрим форк yt-dlp, который сегодня часто заменяет оригинальный youtube-dl, поскольку тот обновляется значительно реже и может переставать скачивать видео после изменений на стороне YouTube.
Проверка Python и pip перед установкой
Перед установкой убедитесь, что в системе есть Python и pip. Откройте командную строку (в Windows — cmd или PowerShell) и выполните:
python --version
pip --version
Если обе команды выводят номера версий — можно переходить к установке. Если вместо версии появляется ошибка, Python либо не установлен, либо не прописан в переменной окружения PATH. При установке Python на Windows нужно отметить галочку Add Python to PATH в установщике — без неё команда python не будет распознаваться.
На Linux и macOS интерпретатор чаще всего вызывается командой python3, а pip — командой pip3. Проверьте оба варианта, если первый не сработал.
Установка youtube-dl через pip
Базовая команда установки выглядит так:
pip install youtube-dlНа системах, где pip привязан к Python 3, используйте вариант:
pip3 install youtube-dlЕсли в системе несколько версий Python и нужно поставить пакет для конкретной, надёжнее вызывать pip через сам интерпретатор — так исключается путаница:
python -m pip install youtube-dlПосле завершения установки проверьте результат командой youtube-dl --version. Если выводится номер версии — всё готово к работе.
☑️ Проверка после установки
Обновление youtube-dl до последней версии
YouTube регулярно меняет внутренние механизмы отдачи видео, поэтому устаревшая версия youtube-dl — частая причина ошибок скачивания. Обновление выполняется командой:
pip install --upgrade youtube-dlОбратите внимание: оригинальный youtube-dl обновляется нечасто, и даже последняя версия из PyPI может не справляться с актуальными изменениями YouTube. В такой ситуации сообщество рекомендует форк yt-dlp — он активно поддерживается и совместим с большинством команд youtube-dl.
pip install yt-dlpТипичные ошибки при установке и их решение
Разберём ошибки, с которыми чаще всего сталкиваются при установке youtube-dl через pip.
- 🔧 «pip не является внутренней или внешней командой» — Python не добавлен в PATH. Переустановите Python с отметкой Add Python to PATH или используйте
py -m pipв Windows. - 🔧 Permission denied / Ошибка доступа — недостаточно прав. В Linux добавьте
--userк команде или используйте виртуальное окружение. - 🔧 SSL certificate verify failed — проблема с сертификатами, часто встречается в корпоративных сетях и на устаревших системах. Помогает обновление Python и пакета certifi.
- 🔧 Команда youtube-dl не найдена после установки — каталог скриптов Python не в PATH. Проверьте путь, который pip показывает в конце установки.
⚠️ Внимание: установка пакетов черезsudo pip installв Linux может повредить системные пакеты Python, от которых зависят утилиты дистрибутива. Безопаснее использовать виртуальное окружение (python3 -m venv) или флаг--user.
Сравнение youtube-dl и yt-dlp
Оба инструмента ставятся через pip и имеют почти идентичный синтаксис, но различаются по активности разработки.
| Параметр | youtube-dl | yt-dlp |
|---|---|---|
| Установка | pip install youtube-dl | pip install yt-dlp |
| Частота обновлений | Редкие | Частые |
| Реакция на изменения YouTube | Медленная | Быстрая |
| Совместимость команд | Базовая | Почти полная с youtube-dl |
Если youtube-dl перестал скачивать видео с ошибкой, первым делом попробуйте yt-dlp — в большинстве сценариев это самый быстрый способ решить проблему без дополнительной диагностики.
Первое скачивание и роль ffmpeg
Проверить работу можно простой командой:
youtube-dl "URL_видео"Для скачивания в максимальном качестве youtube-dl объединяет отдельные видео- и аудиопотоки, и для этого ему нужен ffmpeg. Без него программа скачает только потоки невысокого качества, где звук уже встроен в видео.
Установка ffmpeg зависит от системы: в Windows скачивается сборка с официального сайта и добавляется в PATH, в Ubuntu/Debian — sudo apt install ffmpeg, в macOS — brew install ffmpeg. После установки проверьте команду ffmpeg -version.
Куда pip устанавливает youtube-dl
Пакет ставится в каталог site-packages текущего интерпретатора Python, а исполняемый скрипт — в подкаталог Scripts (Windows) или bin (Linux/macOS). Если этот каталог не в PATH, команда youtube-dl не будет находиться, хотя пакет установлен. Точный путь pip выводит в конце установки или показывает командой pip show youtube-dl.
Виртуальное окружение как чистый способ установки
Чтобы youtube-dl не конфликтовал с другими пакетами и не требовал прав администратора, удобно использовать виртуальное окружение:
python -m venv ytdl-env
ytdl-env\Scripts\activate
pip install youtube-dl
В Linux и macOS активация выполняется командой source ytdl-env/bin/activate. Внутри окружения pip ставит пакеты изолированно, а удаление окружения полностью очищает систему от установленного.
⚠️ Внимание: скачивание видео может нарушать условия использования видеохостингов и авторские права. Используйте youtube-dl и yt-dlp только для контента, на загрузку которого у вас есть право, — например, собственных видео или материалов с разрешительной лицензией.
Часто задаваемые вопросы
Почему pip install youtube-dl выдаёт ошибку «command not found»?
Это значит, что pip не найден в PATH. Проверьте, установлен ли Python командой python --version, и при необходимости переустановите его с отметкой Add Python to PATH. В Windows также работает альтернатива py -m pip install youtube-dl.
Как обновить youtube-dl до последней версии?
Выполните pip install --upgrade youtube-dl. Если даже после обновления скачивание не работает, установите активно поддерживаемый форк: pip install yt-dlp.
Чем yt-dlp отличается от youtube-dl?
Это форк youtube-dl с более частыми обновлениями и быстрой реакцией на изменения YouTube. Синтаксис команд почти совпадает, поэтому переход не требует переучивания.
Зачем youtube-dl нужен ffmpeg?
YouTube отдаёт видео высокого качества отдельными видео- и аудиопотоками. ffmpeg объединяет их в один файл. Без него доступны только форматы с уже встроенным звуком, обычно в более низком качестве.
Можно ли установить youtube-dl без прав администратора?
Да. Используйте флаг --user (pip install --user youtube-dl) или виртуальное окружение через python -m venv — оба способа не требуют повышенных привилегий.