Команда youtube-dl не распознаётся системой — типичная ситуация после первой попытки запуска утилиты, и почти всегда причина в том, что исполняемый файл не добавлен в переменную PATH либо установка вообще не выполнялась. Установка youtube-dl (и его активно поддерживаемого форка yt-dlp) занимает несколько минут, если выбрать правильный способ под вашу операционную систему.
В этом руководстве разберём все рабочие методы: установку через pip, пакетные менеджеры Windows, Linux и macOS, а также вариант с готовым исполняемым файлом без зависимостей. Отдельно рассмотрим проверку корректности установки и типичные ошибки, с которыми сталкиваются новички.
Что нужно перед установкой
Утилита написана на языке Python, но для большинства способов установки интерпретатор не обязателен — есть готовые сборки. Тем не менее стоит заранее определиться, какой вариант вам подходит: классический youtube-dl давно обновляется медленно, а форк yt-dlp получает регулярные исправления и лучше справляется с изменениями на стороне видеохостинга.
Для скачивания отдельных форматов и склейки видео со звуком обеим утилитам нужен FFmpeg. Без него базовое скачивание работает, но объединение дорожек и конвертация будут недоступны.
- 🐍 Python 3 — требуется только при установке через pip;
- 📦 FFmpeg — нужен для склейки видео и аудио в высоком качестве;
- 💻 Доступ к командной строке:
cmd, PowerShell или терминал; - 🌐 Стабильное интернет-соединение для загрузки пакетов.
⚠️ Внимание: скачивайте утилиту только с официальных репозиториев на GitHub или из штатных пакетных менеджеров. Сторонние сайты нередко распространяют модифицированные сборки с вредоносным кодом.
Установка на Windows
Самый простой способ для Windows — готовый исполняемый файл. Скачайте yt-dlp.exe (или youtube-dl.exe) из раздела Releases официального репозитория и поместите его в отдельную папку, например C:\Tools\yt-dlp. Затем добавьте эту папку в PATH: откройте «Система» → «Дополнительные параметры системы» → «Переменные среды», найдите переменную Path и добавьте путь к папке.
Альтернатива — пакетный менеджер winget, встроенный в современные версии Windows 10 и 11. Команда установки выглядит так:
winget install yt-dlpЕсли у вас уже установлен Python, подойдёт и pip:
pip install -U yt-dlp☑️ Проверка установки на Windows
Установка на Linux
В большинстве дистрибутивов youtube-dl присутствует в штатных репозиториях, однако версия там может быть устаревшей. Для Debian и Ubuntu установка выполняется командой:
sudo apt install youtube-dlБолее свежий вариант — установка yt-dlp через pip или прямое скачивание бинарного файла. Во втором случае файл помещается в /usr/local/bin и делается исполняемым:
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
Такой способ хорош тем, что обновление сводится к одной команде sudo yt-dlp -U, без ожидания обновлений в репозитории дистрибутива.
Установка на macOS
На macOS удобнее всего использовать пакетный менеджер Homebrew. Если он уже установлен, достаточно одной команды:
brew install yt-dlpHomebrew автоматически подтянет зависимости, включая Python, и корректно пропишет пути. Для классического youtube-dl команда аналогична: brew install youtube-dl. Если Homebrew отсутствует, можно воспользоваться pip либо скачать бинарный файл так же, как в Linux-инструкции выше.
Сравнение способов установки
Чтобы выбрать подходящий метод, ориентируйтесь на таблицу ниже. Она поможет понять, какой вариант проще в обслуживании именно для вашего сценария.
| Способ | Сложность | Обновление | Кому подходит |
|---|---|---|---|
| Готовый exe/бинарник | Низкая | Вручную или -U | Новичкам на Windows |
| pip | Средняя | pip install -U | Тем, у кого есть Python |
| winget / apt / brew | Низкая | Через менеджер пакетов | Регулярное использование |
| Скрипт curl (Linux/macOS) | Средняя | sudo yt-dlp -U | Продвинутым пользователям |
⚠️ Внимание: версия youtube-dl из стандартных репозиториев Linux часто устаревает и перестаёт корректно скачивать видео. Если команда выдаёт ошибки вроде «Unable to extract», обновите утилиту до последней версии или перейдите на yt-dlp — это решает проблему в подавляющем большинстве случаев.
Проверка установки и первый запуск
После установки откройте новое окно терминала — это важно, потому что изменения PATH применяются только в новых сессиях. Введите команду:
yt-dlp --versionЕсли в ответ выводится номер версии — всё настроено правильно. Теперь можно скачать первое видео, просто передав ссылку аргументом:
yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"Полезные команды для начала работы:
- 📋
yt-dlp -F "ссылка"— показать все доступные форматы видео; - 🎵
yt-dlp -x --audio-format mp3 "ссылка"— извлечь только аудиодорожку; - 📁
yt-dlp -o "%(title)s.%(ext)s" "ссылка"— задать шаблон имени файла.
Почему команда не находится после установки
Наиболее частая причина — папка с утилитой не добавлена в PATH или терминал не был перезапущен после изменения переменных среды. Проверьте путь командой where yt-dlp (Windows) или which yt-dlp (Linux/macOS). Если путь не найден, добавьте папку в PATH и откройте новое окно терминала.
Типичные ошибки и их решение
Ошибка "не является внутренней или внешней командой" в Windows означает, что система не видит исполняемый файл — проверьте PATH или переходите в папку с утилитой перед запуском через cd. В Linux аналогичная проблема решается проверкой прав на исполнение командой chmod +x.
Ошибки вида HTTP Error 403 или Unable to extract обычно связаны не с установкой, а с устаревшей версией самой утилиты: видеохостинги регулярно меняют внутренние механизмы, и разработчики выпускают исправления. Держите программу обновлённой — это главное правило стабильной работы.
⚠️ Внимание: скачивайте только тот контент, права на использование которого у вас есть, либо материалы, распространяемые под свободными лицензиями. Условия использования видеохостингов могут ограничивать загрузку роликов.
Часто задаваемые вопросы
Что лучше: youtube-dl или yt-dlp?
Для повседневного использования предпочтительнее yt-dlp: проект активно развивается, быстрее получает исправления при изменениях на стороне видеохостингов и поддерживает больше опций. Команды у обеих утилит практически идентичны.
Нужен ли Python для работы youtube-dl?
Нет, если вы используете готовый исполняемый файл или установку через winget, brew либо apt — все зависимости уже включены. Python требуется только при установке через pip.
Почему видео скачивается без звука?
Скорее всего, не установлен FFmpeg. Высококачественные форматы на видеохостингах хранят видео и аудио отдельно, и для их объединения нужен этот инструмент. Установите его и повторите попытку.
Как обновить youtube-dl до последней версии?
Если установка выполнялась через pip — выполните pip install -U yt-dlp. Для бинарного файла подойдёт yt-dlp -U, а при установке через пакетный менеджер используйте его штатную команду обновления.
Можно ли пользоваться утилитой без командной строки?
Да, существуют графические оболочки поверх yt-dlp, однако сама утилита остаётся консольной. Освоение базовых команд занимает немного времени и даёт полный контроль над форматами и качеством загрузки.