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