Скачивание субтитров YouTube — генератор команд yt-dlp

Соберите команду yt-dlp, которая сохраняет субтитры в .srt, не скачивая видео.

URL видео, плейлиста или канала

Необязательно. Если оставить пустым, команда закончится словом URL, которое вы подставите сами.

Ваша команда

yt-dlp --write-subs --convert-subs srt --sub-langs en --write-auto-subs --no-playlist -s 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

Основное

Что вам нужно

Видео Только звук

Только звук извлекает звуковую дорожку и отбрасывает видео.

Видео и качество

Максимальное качество -f

Ограничивает высоту. yt-dlp всё равно выберет лучшую дорожку в пределах этого ограничения.

Container --merge-output-format нужен ffmpeg

Тип файла, в который объединяются раздельные видео- и аудиодорожки.

Дополнительные опции (3)

Свой format selector -f

Заменяет выбор качества. Для тех, кто уже знает синтаксис форматов.

Remux в --remux-video нужен ffmpeg

Перепаковывает дорожки без перекодирования. Быстро и без потерь.

Перекодировать в --recode-video нужен ffmpeg

Перекодирует видео. Медленно и с потерями — только если remux не подходит.

Аудио

Формат аудио --audio-format нужен ffmpeg

Файл, в который конвертируется звук.

Качество звука --audio-quality нужен ffmpeg

VBR даёт лучшее соотношение размера и качества; фиксированный bitrate предсказуемее по размеру.

Субтитры

Встраивание помещает субтитры внутрь видео; сохранение пишет рядом отдельный файл .srt.

Языки субтитров --sub-langs

Через запятую. Если нужны все доступные языки, напишите all.

Автоматические субтитры --write-auto-subs Включать машинные субтитры, когда человеческих нет.

Плейлисты и каналы

Обработка плейлиста

Что делать, когда URL относится и к видео, и к плейлисту.

Какие элементы -I

Работают и диапазоны, и списки — например 1-10,15 или -5::2, чтобы брать каждый второй с конца.

Дополнительные опции (1)

Файл учёта --download-archive

Записывает уже скачанное, поэтому повторный запуск это пропустит. Именно так канал держат синхронизированным.

Фрагменты и главы

Дополнительные опции (2)

Скачать только часть --download-sections нужен ffmpeg

Диапазон времени вида *00:01:30-00:03:00 или название главы. Звёздочка в начале означает, что это метка времени.

Разбить по главам --split-chapters нужен ffmpeg Пишет по файлу на главу вместо одного длинного.

Метаданные и обложка

Встроить обложку --embed-thumbnail нужен ffmpeg Использует превью видео как обложку.

Встроить метаданные --embed-metadata нужен ffmpeg Записывает название, автора и дату внутрь самого файла.

Встроить главы --embed-chapters нужен ffmpeg Добавляет метки глав, по которым плеер умеет перескакивать.

Дополнительные опции (3)

Сохранить файл обложки --write-thumbnail Пишет картинку обложки рядом с видео.

Сохранить описание --write-description Пишет описание в файл .description.

Сохранить метаданные в JSON --write-info-json Пишет всё, что yt-dlp знает о видео, в файл .info.json.

SponsorBlock

Удалить фрагменты --sponsorblock-remove нужен ffmpeg

Вырезает из файла фрагменты, отмеченные сообществом, по данным SponsorBlock.

Дополнительные опции (1)

Отметить фрагменты главами --sponsorblock-mark

Оставляет фрагменты, но помечает их, чтобы вы пропускали их сами.

Файлы и папки

Шаблон имени файла -o

Названия полей пишутся внутри %(...)s. Слэши создают папки.

Безопасные имена (только ASCII) --restrict-filenames Убирает диакритику, пробелы и любые символы, которые может отвергнуть придирчивая файловая система.

Перезаписывать существующие файлы --force-overwrites Заменяет файлы, которые уже есть.

Продолжать незавершённые загрузки -c Продолжает с того места, где загрузка прервалась.

Дополнительные опции (4)

Папка для загрузки -P

Куда писать файлы. В сочетании с шаблоном выше можно получить подпапки.

Имена, безопасные для Windows --windows-filenames Убирает символы, которые Windows не принимает, даже если вы работаете в другой системе.

Обрезать имена до --trim-filenames

Максимальная длина имени файла в символах.

Никогда не перезаписывать -w Пропускает всё, что уже скачано.

Фильтры

Дополнительные опции (5)

Загружено после --dateafter

ГГГГММДД или относительная дата вида now-1month.

Загружено до --datebefore

ГГГГММДД или относительная дата.

Минимальный размер --min-filesize

Пропускает всё, что меньше. Принимает 5M, 500K и подобное.

Максимальный размер --max-filesize

Пропускает всё, что больше.

Остановиться после --max-downloads

Сколько файлов скачать, прежде чем остановиться.

Сеть

Ограничение скорости -r

Например 2M или 500K. Полезно, когда остальная полоса нужна для другого.

Дополнительные опции (5)

Параллельных fragment -N

Ускоряет фрагментированные потоки. Четыре — разумное начало.

Повторные попытки -R

Сколько раз повторять неудавшуюся часть. Можно указать infinite.

Proxy --proxy

Адрес HTTP, HTTPS или SOCKS proxy.

Обход региональной блокировки --geo-bypass Подменяет источник запроса. На части сайтов работает, но не на всех.

Притворяться браузером --impersonate

Делает запросы похожими на настоящий браузер. Обычное решение, когда внезапно начинается 403.

Вход и cookies

Cookies из браузера --cookies-from-browser

Читает вашу авторизованную сессию напрямую. Нужно для приватного, возрастного и доступного только участникам содержимого.

Дополнительные опции (1)

Файл cookies --cookies

Файл cookies.txt в формате Netscape, выгруженный из вашего браузера.

Прямые трансляции

Дополнительные опции (2)

Записывать с начала --live-from-start Начинает запись трансляции с начала, а не с текущего момента.

Ждать начала трансляции --wait-for-video

Опрашивает, пока запланированная трансляция не начнётся. MIN-MAX — интервал между проверками в секундах.

Обходные пути

Дополнительные опции (3)

User agent --user-agent устарело

Устарело в пользу --add-headers. Оставлено потому, что множество старых руководств всё ещё это используют.

Referer --referer устарело

Устарело в пользу --add-headers.

Аргументы extractor --extractor-args

Опции для конкретного сайта, например youtube:player_client=web.

Вывод и отладка

Только показать форматы -F Печатает доступные форматы и завершает работу без скачивания.

Дополнительные опции (2)

Продолжать при ошибках -i Пропускает неудавшиеся элементы вместо остановки. Для больших плейлистов это обязательно.

Пробный прогон -s Делает всё, кроме записи файла.

Сбросить

Опции, которые здесь важны

Субтитры Встраивание помещает субтитры внутрь видео; сохранение пишет рядом отдельный файл .srt.
Языки субтитров --sub-langs Через запятую. Если нужны все доступные языки, напишите all.
Автоматические субтитры --write-auto-subs Включать машинные субтитры, когда человеческих нет.
Пробный прогон -s Делает всё, кроме записи файла.

Ещё нет yt-dlp?

Это бесплатная программа, которая работает на вашем компьютере. Установка занимает около минуты.

Субтитры без видео

Пробный прогон делает всё, кроме записи видеофайла, так что субтитры остаются, а скачивание не тратится. Для конвертации в SRT нужен ffmpeg.

Если ничего не появилось, скорее всего у видео просто нет субтитров, написанных человеком: автоматические — это отдельный переключатель, и без него yt-dlp ничего не находит и ничего об этом не говорит.

Симуляция — несущий переключатель на этой странице: без неё yt-dlp скачивает целое видео и лишь вдобавок сохраняет субтитры, что для файла длиной с фильм — много трафика ради текстовой дорожки. С ней запуск берёт метаданные, пишет файлы субтитров и не трогает видео вовсе. Плата в том, что симуляция также пропускает запись миниатюры и описания, к которым вы, возможно, привыкли, — это артефакты видеозапуска, а не субтитрового.

Выбор языка — место, где скачивание субтитров становится привередливым. --sub-langs en берёт ровно трек с меткой «en»; en-orig — имя YouTube для автоматически сгенерированного, а en.* как шаблон ловит оба плюс региональные варианты. Несколько языков задаются списком через запятую. Если у видео есть и человеческая, и автоматическая дорожки одного языка, это два отдельных элемента, и скачать оба — законный исход, а не баг.

Форматы имеют значение, когда файл субтитров пойдёт в редактор: SRT — безопасный обменный формат, VTT несёт стили, которые показывает веб-плеер, а собственные JSON3/_SRV форматы YouTube — для машин. Переключатель конвертации в SRT закрывает частый случай, требует ffmpeg и намеренно теряет стили — редактору нужен текст, а не разметка. Если вывод выглядит пустым, проверьте, что файл существует, прежде чем списывать всё на конвертацию: SRT в ноль байт означает, что пуста была сама дорожка.

Автоматические субтитры заслуживают предупреждения: это машинная расшифровка, со всем, что из этого следует — неверные омофоны, отсутствие пунктуации, измятые имена. Для видео на языке, который вы читаете, они — поисковый индекс; для всего, что будете цитировать, дорожка человека (когда она есть) — единственная, которую стоит хранить. У прямых трансляций автосубтитры пишутся на лету и сохраняются только после конца эфира — опции live-записи на этом сайте для картинки, а субтитры закончившейся трансляции скачиваются обычными субтитовыми опциями.

Частые вопросы

› Как скачать субтитры без видео?

Выберите вариант .srt и включите пробный прогон: он пропускает запись видеофайла, но субтитры всё равно сохраняет.

› Почему файл субтитров не появился?

Скорее всего у видео нет человеческих субтитров. Включите автоматические, чтобы получить машинные.

› Как выбрать языки субтитров?

Через запятую, например en,ru. Для всех доступных — all, а шаблон вида en.* заберёт все варианты английского.

› Можно ли получить SRT вместо VTT?

Да — вариант .srt их конвертирует, и для этого нужен ffmpeg.