yt-dlp
yt-dlp — консольный загрузчик вид ео и аудио. Проект появился в 2020 году как форк youtube-dlc (который, в свою очередь, ответвился от youtube-dl) и стал стандартом де-факто для скачивания с YouTube, VK Видео, Rutube, Vimeo, Twitch, SoundCloud и более 1700 других сайтов. Написан на Python, лицензия Unlicense.
Сайт: github.com/yt-dlp/yt-dlp
Когда использовать
✅ Подходит, если нужно:
- скачать видео или аудио с YouTube, VK, Rutube, Twitch, SoundCloud и других платформ;
- получить максимальное качество (отдельные дорожки видео и аудио со слиянием через ffmpeg);
- сохранить субтитры, метаданные, превью и комментарии за один проход;
- вести инкрементальный архив канала или плейлиста через
--download-archive; - записать прямую трансляцию.
❌ Не лучший выбор, если:
- нужны изображения и галереи — gallery-dl;
- нужно сохранить саму страницу с плеером и комментариями как веб-страницу — Browsertrix Crawler, а файл видео — дополнительно через yt-dlp;
- нужен WARC: yt-dlp его не пишет;
- контент защищён DRM: yt-dlp DRM не обходит и не должен.
Зачем нужен архивисту
Видео удаляют, каналы блокируют, плееры меняются. Самый надёжный способ сохранить ролик — скачать исходный медиафайл вместе с метаданными. yt-dlp:
- скачивает медиафайл в выбранном качестве;
- сохраняет метаданные (название, описание, теги, автор, дата) в
.info.json; - пишет субтитры, в том числе автоматические, в VTT/SRT;
- сохраняет превью и при желании комментарии (
--write-comments); - ведёт журнал скачанного, чтобы повторный запуск докачивал только новое.
Установка
# pip (рекомендуемый вариант с зависимостями)
python3 -m pip install -U "yt-dlp[default]"
# pipx — изолированная установка
pipx install yt-dlp
# macOS / Linux (Homebrew)
brew install yt-dlp
# Arch
sudo pacman -Syu yt-dlp
# Windows
winget install --source winget --id yt-dlp.yt-dlp
# или: scoop install yt-dlp / choco install yt-dlp
Готовый бинарник без Python:
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
Официального PPA для Ubuntu и официального Docker-образа нет. Пакеты в репозиториях дистрибутивов часто устаревают: для YouTube это критично.
Зависимости
- Python 3.10+ (для установки через pip).
- ffmpeg и ffprobe — для слияния видео и аудио и постобработки.
- JavaScript-среда для YouTube. С конца 2025 года для полноценной работы с YouTube yt-dlp решает JavaScript-задачи YouTube внешней средой выполнения через компонент yt-dlp-ejs. Рекомендуется Deno (включён по умолчанию). Можно использовать Node.js или QuickJS:
--js-runtimes node. В официальных бинарниках и при установкеyt-dlp[default]компонент EJS уже есть, остаётся поставить Deno. Подробности — в wiki: EJS. - PO Token. Некоторым клиентам YouTube нужен PO Token. Его получают через сторонние плагины-провайдеры или передают вручную (
--extractor-args "youtube:po_token=..."); см. PO Token Guide.
# Linux
sudo apt install ffmpeg
# macOS
brew install ffmpeg deno
Обновление
yt-dlp -U # для официальных бинарников
python3 -m pip install -U "yt-dlp[default]" # для pip
Для YouTube авторы рекомендуют канал nightly (yt-dlp --update-to nightly). Большинство поломок с YouTube исправляется обновлением.
Флаги сверены с
yt-dlp --helpверсии 2026.08.19 и README (октябрь 2026).
Использование
Скачать одно видео
yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"
По умолчанию скачивается лучшее видео и лучшее аудио, а затем они сливаются через ffmpeg.
Только аудио
yt-dlp -x --audio-format mp3 --audio-quality 0 "https://www.youtube.com/watch?v=VIDEO_ID"
Для архива лучше не перекодировать: -x без --audio-format сохранит исходную дорожку.
Выбрать качество
# лучшее видео не выше 1080p + лучшее аудио
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL
# посмотреть доступные форматы и выбрать конкретные
yt-dlp -F URL
yt-dlp -f 137+140 URL
Плейлист и канал
yt-dlp "https://www.youtube.com/playlist?list=PLxxxxxx"
# только элементы 1–10 (синтаксис START:STOP; старый вид 1-10 тоже работает)
yt-dlp -I 1:10 "https://www.youtube.com/playlist?list=PLxxxxxx"
# в обратном порядке
yt-dlp -I ::-1 "https://www.youtube.com/playlist?list=PLxxxxxx"
# весь канал
yt-dlp "https://www.youtube.com/@ChannelName"
Субтитры и метаданные
yt-dlp --write-subs --write-auto-subs --sub-langs "ru,en" \
--write-info-json --write-thumbnail --write-description \
URL
Файлы на выходе:
Title [VIDEO_ID].mp4(или.webm/.mkv) — видео;Title [VIDEO_ID].info.json— все метаданные;Title [VIDEO_ID].ru.vtt,.en.vtt— субтитры;Title [VIDEO_ID].webpили.jpg— превью;Title [VIDEO_ID].description— описание.
Вежливое скачивание
yt-dlp --limit-rate 5M --sleep-requests 1 --sleep-interval 5 --max-sleep-interval 15 URL
Cookies (видео с ограничением по возрасту, приватные плейли сты своего аккаунта)
yt-dlp --cookies-from-browser firefox URL
yt-dlp --cookies cookies.txt URL
Возобновление
yt-dlp -c URL
Докачка частично загруженны х файлов включена по умолчанию.
Архив скачанного
yt-dlp --download-archive archive.txt "https://www.youtube.com/playlist?list=PLxxxx"
ID каждого скачанного видео записывается в archive.txt; при повторном запуске такие видео пропускаются. С --break-on-existing обход останавливается на первом уже скачанном видео, что ускоряет регулярные обновления каналов.
SponsorBlock
yt-dlp --sponsorblock-mark all URL # отметить главы
yt-dlp --sponsorblock-remove sponsor URL # вырезать
Для архива лучше только отмечать (--sponsorblock-mark), а не вырезать фрагменты: исходный файл должен остаться полным.
Конфигурация
Файл ~/.config/yt-dlp/config (Linux/macOS) или %APPDATA%\yt-dlp\config (Windows):
# шаблон имени файла
-o %(uploader)s/%(upload_date)s - %(title)s [%(id)s].%(ext)s
# параллельная загрузка фрагментов одного видео (HLS/DASH)
--concurrent-fragments 4
# метаданные
--write-info-json
--write-thumbnail
--write-auto-subs
--sub-langs ru,en
# архив
--download-archive ~/.yt-dlp-archive.txt
# прогресс в заголовке окна
--console-title
--progress-template "download-title:%(info.id)s-%(progress.eta)s"
Шаблоны прогресса используют синтаксис форматирования Python: %(progress._percent_str)s, %(progress._total_bytes_str)s (с суффиксом s).