Краткий справочник по наиболее часто используемым командам и параметрам yt-dlp.
yt-dlp — это инструмент командной строки с открытым исходным кодом и активно поддерживаемый форк youtube-dl (с более быстрыми исправлениями и поддержкой 1700+ сайтов) для загрузки видео, аудио и плейлистов.
Эта шпаргалка содержит часто используемые команды для загрузки видео 1080p/4K, извлечения MP3, обхода обнаружения ботов и встраивания субтитров.
Впервые используете инструмент? Посетите наше подробное Руководство по скачиванию и установке yt-dlp, или просто запустите приведённые примеры в нашей онлайн-консоль без какой-либо настройки.
Предпочитаете составлять собственные команды? Попробуйте наш интерактивный Генератор команд yt-dlp — выбирайте параметры и получайте точную готовую команду.
yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -x --audio-format mp3 "https://soundcloud.com/..."
yt-dlp -F "https://vimeo.com/..."
yt-dlp -f "best[height<=1080]" "https://www..."
yt-dlp --yes-playlist "https://www.youtube/..."
yt-dlp --embed-subs "https://www..."
| Команда | Описание | Действия |
|---|---|---|
| yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Скачать видео лучшего качества (поведение по умолчанию). | |
| yt-dlp -o "%(title)s.%(ext)s" "https://vimeo.com/906834164" | Сохранить видео с пользовательским путём и шаблоном имени файла. | |
| yt-dlp --limit-rate 50K "https://www.dailymotion.com/video/x8j5y9z" | Ограничить скорость загрузки для обхода дросселирования (например, 50K, 10M). | |
| yt-dlp -o "%(upload_date)s - %(title)s (%(id)s).%(ext)s" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Избегайте конфликтов файлов, добавляя дату загрузки и уникальный ID видео в имя файла. |
| Команда | Описание | Действия |
|---|---|---|
| yt-dlp -F "https://vimeo.com/906834164" | Показать все доступные разрешения, размеры, кодеки и форматы. | |
| yt-dlp -f 137 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Выбрать и скачать конкретный код формата (сначала используйте -F для просмотра кодов). | |
| yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Скачать видео лучшего качества с разрешением до 1080p. Тот же фильтр работает для 1440p (2K) и 2160p (4K). | |
| yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" --merge-output-format mp4 "https://vimeo.com/906834164" | Принудительно скачать лучшее качество в объединённом формате MP4. | |
| yt-dlp --recode-video mp4 "https://www.dailymotion.com/video/x8j5y9z" | Скачать видео и перекодировать в стандартный MP4 (полезно, если платформа использует нестандартные контейнеры, например WebM). |
-f bestvideo+bestaudio в сочетании с --merge-output-format mp4 для лучшего качества с максимальной совместимостью устройств. На ytdlp.online слияние ffmpeg выполняется автоматически на нашем сервере.
| Команда | Описание | Действия |
|---|---|---|
| yt-dlp -x "https://soundcloud.com/monstercat/aero-chord-surface" | Извлечь только аудиодорожку (автоопределение лучшего формата). | |
| yt-dlp -x --audio-format mp3 "https://soundcloud.com/monstercat/aero-chord-surface" | Скачать аудио и конвертировать его в формат MP3. | |
| yt-dlp -x --audio-format mp3 --audio-quality 0 "https://soundcloud.com/monstercat/aero-chord-surface" | Скачать аудио и извлечь в лучшем качестве MP3 (VBR 0 / эквивалент 320 кбит/с). | |
| yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata "https://soundcloud.com/monstercat/aero-chord-surface" | Скачать MP3 и встроить описание видео, теги и обложку. |
--embed-thumbnail --embed-metadata при извлечении MP3 автоматически добавляет обложку альбома и теги — идеально для музыкальных приложений, таких как iTunes или Spotify Local Files.
| Команда | Описание | Действия |
|---|---|---|
| yt-dlp --yes-playlist "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | Принудительно скачать все видео из ссылки на плейлист. | |
| yt-dlp --no-playlist "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Скачать только одно видео по URL, игнорируя плейлист, к которому оно принадлежит. | |
| yt-dlp --playlist-items 1-5 "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | Скачать определённый диапазон элементов плейлиста (например, 1-5, 1,3,5). |
| Команда | Описание | Действия |
|---|---|---|
| yt-dlp --list-subs "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Показать все вручную загруженные и автоматически сгенерированные субтитры. | |
| yt-dlp --write-auto-subs --skip-download "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Извлечь и сохранить только автоматически сгенерированные субтитры, пропуская загрузку видео. | |
| yt-dlp --embed-subs --merge-output-format mp4 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Скачать видео и автоматически встроить субтитры как мягкие подписи в объединённый файл MP4. | |
| yt-dlp --write-subs --sub-langs en "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Скачать вручную загруженные субтитры на определённом языке (например, en, zh-Hans, ja). Сначала используйте --list-subs для просмотра доступных языков. |
--sub-langs all для загрузки субтитров на всех доступных языках или --sub-langs "en,zh-Hans" для нескольких языков одновременно. Полная справка по субтитрам — в нашем Страница справки yt-dlp.
| Команда | Описание | Действия |
|---|---|---|
| yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Загрузить cookies из браузера (например, Chrome, Firefox) для обхода проверки входа или блокировки ботов. |
|
| yt-dlp --impersonate chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Имитация TLS-характеристик браузера (требуется curl-cffi) для обхода блокировок Cloudflare и обнаружения ботов YouTube. | |
| yt-dlp --extractor-args youtube:player_client=default,-android_sdkless "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Обход ошибок «Войдите, чтобы подтвердить, что вы не бот», принудительно используя определённую комбинацию клиентов YouTube. | |
| yt-dlp --proxy "http://proxy-ip:port" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Направить трафик yt-dlp через HTTP, HTTPS или SOCKS прокси — полезно для контента с геоблокировкой. | |
| yt-dlp --geo-bypass-country US "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Подменить код страны геолокации (например, US, GB, JP) для обхода региональных ограничений контента. |
| Команда | Описание | Действия |
|---|---|---|
| yt-dlp -a urls.txt | Пакетная загрузка всех URL видео, перечисленных построчно в текстовом файле. |
|
| yt-dlp --split-chapters "https://www.youtube.com/watch?v=QQ7Xl79OqNY" | Автоматически разделить видео на отдельные треки/файлы по внутренним главам. | |
| yt-dlp --external-downloader aria2c "https://vimeo.com/906834164" | Использовать внешний многопоточный загрузчик (Aria2) для значительного ускорения загрузок. | |
| yt-dlp --sleep-interval 5 --max-sleep-interval 15 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Установить случайные задержки (от 5 до 15 сек) между загрузками для предотвращения блокировки IP. | |
| yt-dlp --download-sections "*00:01:00-00:02:30" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Скачать определённый фрагмент видео или временной диапазон (например, с 1м0с до 2м30с) вместо всего видео. | |
| yt-dlp --download-archive archive.txt "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Отслеживать историю загрузок в archive.txt и автоматически пропускать ранее скачанные видео. |
|
yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -U
.exe из-за упаковки PyInstaller. Установите через winget install yt-dlp, чтобы избежать этого. Для варианта без установки используйте нашу онлайн-консоль. Подробнее в нашем руководство по безопасности.
winget install yt-dlp. Также можно использовать Scoop, Chocolatey, pip или скачать автономный yt-dlp.exe с GitHub.
Выполняйте любые команды yt-dlp на нашем сервере. Установка не требуется.