yt-dlp

Сообщество yt-dlp · лицензия Unlicense

Скачивает видео и звук по ссылке с YouTube, VK Видео, Rutube, Дзена и сотен других площадок. Агенту нужен, чтобы забрать запись и дальше с ней работать.

macOS · Windows · LinuxНа компьютере, на сервере и в контейнереБесплатно, Unlicense

Сверили официальные источники 25.09.2026. Не устанавливали и не запускали. Что именно проверяли

Установить агентом ↓

Какую задачу решает

Скачивает видео и звук по ссылке. Понимает YouTube, VK Видео, Rutube, Дзен и сотни других площадок, список - в репозитории. Агенту нужен, чтобы забрать запись эфира или ролик и дальше с ней работать: вытащить звук, расшифровать, нарезать.

  • Скачивает ролик по ссылке в нужном качестве или только звук.
  • Забирает готовые субтитры ролика, если площадка их отдаёт.
  • Скачивает плейлист или ролики канала списком.
  • Показывает, какие форматы есть у ролика, ничего не скачивая.

Пример результата

Говоришь агенту

Скачай звук из моего ролика по ссылке [ссылка] в mp3 и положи в папку audio.

Что получится

В папке audio появляется mp3 с названием ролика. Звук в mp3 переводит FFmpeg, поэтому она должна стоять там же.

Паспорт

Кто делает
Сообщество yt-dlp
Исходный код
github.com/yt-dlp/yt-dlp
Лицензия
Unlicense
Версия
2026.08.19 на 25.09.2026
Системы
macOS · Windows · Linux
Где работает
На компьютере, на сервере и в контейнере
Цена
Бесплатно
Проверка
Сверили источники 25.09

Установить агентом

Для Claude Code, Codex, Hermes и любого агента с терминалом
Установи программу «yt-dlp». Работай по шагам и после каждого коротко говори, что сделал.

Что это за программа (каталог smyslokod.ru, официальные источники сверены 25.09.2026):
- исходный код: https://github.com/yt-dlp/yt-dlp
- инструкция по установке: https://github.com/yt-dlp/yt-dlp/wiki/Installation
- актуальная версия на 25.09.2026: 2026.08.19
- лицензия: Unlicense
- для работы нужно (очень желательно): FFmpeg - склеивает видео и звук, переводит звук в mp3; без неё часть задач не работает
- для работы нужно (очень желательно): Deno или Node.js 22+ - движок JavaScript, без него с YouTube часть форматов недоступна; Deno включён по умолчанию, Node.js - флагом --js-runtimes node
- для работы нужно (в отдельных случаях): Python 3.10 или новее - только для пакета из PyPI и файла yt-dlp для Linux; готовым файлам yt-dlp.exe, yt-dlp_macos и yt-dlp_linux Python не нужен

Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.
6. Для проверки ничего не скачивай без ссылки от меня: только мой ролик или ролик с открытой лицензией.

Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
   - на компьютере: самый частый вариант, ролик скачивается и обрабатывается у тебя.
   - на сервере: работает. Если площадка отвечает ошибкой 429, она ограничивает частые запросы с адреса: сделай паузу и скачивай реже.
   - в контейнере: у Hermes Agent в Docker системные пакеты от обычного пользователя не ставятся, поэтому программы из PyPI его документация советует запускать через uvx: uvx yt-dlp.
1. Проверь, не стоит ли программа уже: yt-dlp --version. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Проверь, что есть всё нужное для работы: FFmpeg, Deno или Node.js 22+. Чего нет, внеси в план отдельным пунктом. Проверь свободное место на диске: нужно от 3 МБ (файл для Linux, которому нужен Python) до 18-40 МБ (готовые файлы для Windows, macOS и Linux), плюс место под скачанные ролики.
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
   Способы из официальных источников:
   - macOS, Homebrew: brew install yt-dlp
   - Windows, winget: winget install yt-dlp
   - Linux, готовый файл: curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp && chmod a+rx ~/.local/bin/yt-dlp (этому файлу нужен Python 3.10 или новее; обновление - yt-dlp -U)
   - Любая система, uv: uv tool install "yt-dlp[default]" (пакет из PyPI в отдельном окружении, проекты не задевает; нужен uv)
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
   - yt-dlp --version: программа запускается без ошибки;
   - Попроси у меня ссылку на мой ролик или ролик с открытой лицензией и выведи список его форматов, ничего не скачивая. Делай это во временной папке и не трогай мои файлы.
     yt-dlp -F "[ссылка]"
   - если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS, Homebrew: brew uninstall yt-dlp; Windows, winget: winget uninstall yt-dlp; Linux, готовый файл: rm ~/.local/bin/yt-dlp; uv: uv tool uninstall yt-dlp).

Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/yt-dlp#problemy

Промпт собран из официальных инструкций, сверенных 25.09.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит. Сами мы этот промпт на живой установке ещё не прогоняли.

Как ставят вручную

Способы из официальных источников, у каждого ссылка на первоисточник.

  • macOS · Homebrew · источник

    brew install yt-dlp

  • Windows · winget · источник

    winget install yt-dlp

  • Linux · готовый файл · источник

    curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp && chmod a+rx ~/.local/bin/yt-dlp

    этому файлу нужен Python 3.10 или новее; обновление - yt-dlp -U

  • Любая система · uv · источник

    uv tool install "yt-dlp[default]"

    пакет из PyPI в отдельном окружении, проекты не задевает; нужен uv

Как удалить

  • macOS, Homebrew: brew uninstall yt-dlp
  • Windows, winget: winget uninstall yt-dlp
  • Linux, готовый файл: rm ~/.local/bin/yt-dlp
  • Любая система, uv: uv tool uninstall yt-dlp

Что нужно для работы

  • FFmpeg (очень желательно) - склеивает видео и звук, переводит звук в mp3; без неё часть задач не работает
  • Deno или Node.js 22+ (очень желательно) - движок JavaScript, без него с YouTube часть форматов недоступна; Deno включён по умолчанию, Node.js - флагом --js-runtimes node
  • Python 3.10 или новее (в отдельных случаях) - только для пакета из PyPI и файла yt-dlp для Linux; готовым файлам yt-dlp.exe, yt-dlp_macos и yt-dlp_linux Python не нужен

Системы

  • macOS - macOS 10.15 и новее: готовый файл yt-dlp_macos, Homebrew или пакет PyPI.
  • Windows - windows 8 и новее: готовый файл yt-dlp.exe, winget или пакет PyPI.
  • Linux - готовые файлы для x86_64 и aarch64 (glibc 2.17 и новее), файл yt-dlp для Python 3.10+, пакет PyPI.

Где запускать

Ставить нужно туда, где работает агент: на твой компьютер, сервер или в контейнер.

  • На компьютере - самый частый вариант, ролик скачивается и обрабатывается у тебя.
  • На сервере - работает. Если площадка отвечает ошибкой 429, она ограничивает частые запросы с адреса: сделай паузу и скачивай реже.
  • В контейнере - у Hermes Agent в Docker системные пакеты от обычного пользователя не ставятся, поэтому программы из PyPI его документация советует запускать через uvx: uvx yt-dlp.

Сколько ресурсов нужно

Место на диске
От 3 МБ (файл для Linux, которому нужен Python) до 18-40 МБ (готовые файлы для Windows, macOS и Linux), плюс место под скачанные ролики
Сеть
Качает столько, сколько весит ролик: час видео в хорошем качестве - это сотни мегабайт и больше.

Лицензия и платные замены

Лицензия Unlicense. Код в репозитории и пакет в PyPI идут под Unlicense, почти без условий. Готовые файлы программы для Windows, macOS и Linux собраны вместе с кодом под GPLv3+, и такая сборка целиком идёт под GPLv3+. Текст лицензии

Цена: Бесплатно

Платные замены

Платной замены, которую стоит брать вместо, нет: программа бесплатная, а свои ролики с YouTube можно скачать и без неё, из кабинета площадки.

Бесплатные замены

  • Скачивание в YouTube Studio - Свои ролики YouTube можно скачать из кабинета в MP4, 720p или 360p, до пяти раз в сутки на ролик. Без программы и без агента.

О чём помнить

  • Скачивай только то, на что у тебя есть права: свои ролики, записи своих эфиров, материалы с открытой лицензией. Правила площадок и авторское право действуют и тогда, когда качает агент.
  • Для скачивания из аккаунта программа просит куки браузера. Это ключ к твоему аккаунту: агенту его не отдавай.

Частые проблемы

ffmpeg not found. Please install or provide the path using --ffmpeg-location

FFmpeg не стоит или стоит не там, где запускается yt-dlp. Поставь FFmpeg туда же (карточка FFmpeg) или скачивай без склейки и без перевода в mp3.

No supported JavaScript runtime could be found

Для YouTube нужен движок JavaScript, а его нет: без него часть форматов не видна. Поставь Deno по официальной инструкции deno.com или, если стоит Node.js 22 и новее, добавь флаг --js-runtimes node.

Вчера скачивалось, сегодня ошибка на той же площадке

Площадка поменяла сайт, а версия yt-dlp старая. Обнови программу той же командой, которой ставил: uv tool upgrade yt-dlp, brew upgrade yt-dlp, winget upgrade yt-dlp или yt-dlp -U у готового файла.

HTTP Error 429: Too Many Requests

Площадка временно ограничила твой адрес за слишком частые запросы (так пишут разработчики yt-dlp). Сделай паузу и скачивай реже. Если ролик твой, возьми файл в YouTube Studio.

Проверка

Сверили официальные источники 25.09.2026. Не устанавливали и не запускали.

Когда
25.09.2026
Среда
Официальные сайты, репозитории и реестры пакетов, без установки
Объём
Сверили официальные источники, программу не устанавливали
Что именно сделали
  1. github.com/yt-dlp/yt-dlp: последний выпуск 2026.08.19 от 19.08.2026, лицензия Unlicense; раздел Licensing - готовые файлы программы идут под GPLv3+.
  2. PyPI yt-dlp: версия 2026.8.19, Python 3.10 и новее; дополнение default включает yt-dlp-ejs.
  3. README, раздел DEPENDENCIES, и wiki EJS: ffmpeg и ffprobe очень желательны, для YouTube нужен движок JavaScript (Deno по умолчанию, Node.js 22+ флагом).
  4. Wiki Installation: команды для Homebrew, winget и готового файла в ~/.local/bin.
  5. Размеры готовых файлов 2026.08.19: yt-dlp 3 МБ, yt-dlp.exe 18 МБ, yt-dlp_macos 37 МБ, yt-dlp_linux 40 МБ.
  6. Список площадок supportedsites.md: есть YouTube, VK, Rutube, Дзен.
ДатаВерсияОбъёмГдеИтог
25.09.20262026.08.19источникибез установкиполучилось

«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.

Входит в подборки

Программу делают её авторы. Мы сверяем официальные источники и описываем, что ей нужно, но код остаётся чужим. Перед установкой посмотри план агента: что он поставит и что поменяет в системе.