Что вам нужно
Только звук извлекает звуковую дорожку и отбрасывает видео.
Справочник опций yt-dlp
Написано по yt-dlp 2026.07.21. Между версиями опции добавляются и переименовываются, поэтому проверьте свою через yt-dlp --version.
Основное
Видео и качество
-f FORMAT
--format
Максимальное качество
Ограничивает высоту. yt-dlp всё равно выберет лучшую дорожку в пределах этого ограничения.
-f FORMAT
--format
Свой format selector
Заменяет выбор качества. Для тех, кто уже знает синтаксис форматов.
Примеры
-f "bv*[vcodec^=av01]+ba"-f "b[filesize<50M]"
--merge-output-format FORMAT
нужен ffmpeg
Container
Тип файла, в который объединяются раздельные видео- и аудиодорожки.
--remux-video FORMAT
нужен ffmpeg
Remux в
Перепаковывает дорожки без перекодирования. Быстро и без потерь.
--recode-video FORMAT
нужен ffmpeg
Перекодировать в
Перекодирует видео. Медленно и с потерями — только если remux не подходит.
Аудио
--audio-format FORMAT
нужен ffmpeg
Формат аудио
Файл, в который конвертируется звук.
--audio-quality QUALITY
нужен ffmpeg
Качество звука
VBR даёт лучшее соотношение размера и качества; фиксированный bitrate предсказуемее по размеру.
Субтитры
Субтитры
Встраивание помещает субтитры внутрь видео; сохранение пишет рядом отдельный файл .srt.
Языки субтитров
Через запятую. Если нужны все доступные языки, напишите all.
Примеры
--sub-langs "en,vi"--sub-langs "en.*,ja"--sub-langs all
Автоматические субтитры
Включать машинные субтитры, когда человеческих нет.
Плейлисты и каналы
Обработка плейлиста
Что делать, когда URL относится и к видео, и к плейлисту.
-I ITEM_SPEC
--playlist-items
Какие элементы
Работают и диапазоны, и списки — например 1-10,15 или -5::2, чтобы брать каждый второй с конца.
Примеры
-I 1:5-I "1,3,7-10"-I "-5::2"
Файл учёта
Записывает уже скачанное, поэтому повторный запуск это пропустит. Именно так канал держат синхронизированным.
Фрагменты и главы
--download-sections REGEX
нужен ffmpeg
Скачать только часть
Диапазон времени вида *00:01:30-00:03:00 или название главы. Звёздочка в начале означает, что это метка времени.
Примеры
--download-sections "*00:01:30-00:03:00"--download-sections "intro"
--split-chapters
нужен ffmpeg
Разбить по главам
Пишет по файлу на главу вместо одного длинного.
Метаданные и обложка
--embed-thumbnail
нужен ffmpeg
Встроить обложку
Использует превью видео как обложку.
--embed-metadata
нужен ffmpeg
Встроить метаданные
Записывает название, автора и дату внутрь самого файла.
--embed-chapters
нужен ffmpeg
Встроить главы
Добавляет метки глав, по которым плеер умеет перескакивать.
Сохранить файл обложки
Пишет картинку обложки рядом с видео.
Сохранить описание
Пишет описание в файл .description.
Сохранить метаданные в JSON
Пишет всё, что yt-dlp знает о видео, в файл .info.json.
SponsorBlock
--sponsorblock-remove CATS
нужен ffmpeg
Удалить фрагменты
Вырезает из файла фрагменты, отмеченные сообществом, по данным SponsorBlock.
Отметить фрагменты главами
Оставляет фрагменты, но помечает их, чтобы вы пропускали их сами.
Файлы и папки
-o [TYPES:]TEMPLATE
--output
Шаблон имени файла
Названия полей пишутся внутри %(...)s. Слэши создают папки.
Примеры
-o "%(title)s.%(ext)s"-o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH
--paths
Папка для загрузки
Куда писать файлы. В сочетании с шаблоном выше можно получить подпапки.
Безопасные имена (только ASCII)
Убирает диакритику, пробелы и любые символы, которые может отвергнуть придирчивая файловая система.
Имена, безопасные для Windows
Убирает символы, которые Windows не принимает, даже если вы работаете в другой системе.
Обрезать имена до
Максимальная длина имени файла в символах.
Перезаписывать существующие файлы
Заменяет файлы, которые уже есть.
-w
--no-overwrites
Никогда не перезаписывать
Пропускает всё, что уже скачано.
-c
--continue
Продолжать незавершённые загрузки
Продолжает с того места, где загрузка прервалась.
Фильтры
Загружено после
ГГГГММДД или относительная дата вида now-1month.
Примеры
--dateafter 20240101--dateafter now-1month
Загружено до
ГГГГММДД или относительная дата.
Минимальный размер
Пропускает всё, что меньше. Принимает 5M, 500K и подобное.
Максимальный размер
Пропускает всё, что больше.
Остановиться после
Сколько файлов скачать, прежде чем остановиться.
Сеть
-r RATE
--limit-rate
Ограничение скорости
Например 2M или 500K. Полезно, когда остальная полоса нужна для другого.
-N N
--concurrent-fragments
Параллельных fragment
Ускоряет фрагментированные потоки. Четыре — разумное начало.
-R RETRIES
--retries
Повторные попытки
Сколько раз повторять неудавшуюся часть. Можно указать infinite.
Proxy
Адрес HTTP, HTTPS или SOCKS proxy.
Обход региональной блокировки
Подменяет источник запроса. На части сайтов работает, но не на всех.
Притворяться браузером
Делает запросы похожими на настоящий браузер. Обычное решение, когда внезапно начинается 403.
Вход и cookies
Cookies из браузера
Читает вашу авторизованную сессию напрямую. Нужно для приватного, возрастного и доступного только участникам содержимого.
Файл cookies
Файл cookies.txt в формате Netscape, выгруженный из вашего браузера.
Прямые трансляции
Записывать с начала
Начинает запись трансляции с начала, а не с текущего момента.
Ждать начала трансляции
Опрашивает, пока запланированная трансляция не начнётся. MIN-MAX — интервал между проверками в секундах.
Обходные пути
--user-agent UA
устарело — --add-headers
User agent
Устарело в пользу --add-headers. Оставлено потому, что множество старых руководств всё ещё это используют.
--referer URL
устарело — --add-headers
Referer
Устарело в пользу --add-headers.
Аргументы extractor
Опции для конкретного сайта, например youtube:player_client=web.
Примеры
--extractor-args "youtube:player_client=web,android"