Перейти к содержимому
yt-dlp
Сменить язык

Генератор команд yt-dlp для Twitch

Соберите команду yt-dlp для VOD, клипов и трансляций Twitch — с опциями, благодаря которым долгая запись доживает до конца.

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

Ваша команда

yt-dlp --merge-output-format mp4 -o '%(uploader)s - %(title)s.%(ext)s' -N 4 --live-from-start https://www.twitch.tv/videos/1234567890
Основное

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

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

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

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

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

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

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

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

Аудио

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

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

Субтитры

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

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

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

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

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

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

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

Фрагменты и главы
Дополнительные опции (2)

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

Метаданные и обложка
Дополнительные опции (3)
SponsorBlock

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

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

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

Файлы и папки

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

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

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

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

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

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

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

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

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

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

Сеть

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

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

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

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

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

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

Вход и cookies

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

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

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

Прямые трансляции
Дополнительные опции (2)

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

Обходные пути
Дополнительные опции (3)

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

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

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

Вывод и отладка
Дополнительные опции (2)
Сбросить

VOD, клипы и трансляции

VOD на Twitch длинные, поэтому параллельные fragment дают реальный выигрыш, а вырезать нужный диапазон обычно разумнее, чем скачивать восемь часов ради пяти минут.

Для трансляций запись с начала возвращает начало, пока Twitch его ещё хранит. Выбирайте MKV: прерванный MKV обычно всё равно воспроизводится, а MP4, обрезанный посреди записи, — часто нет.

Twitch отдаёт VOD как сегменты HLS, и его CDN щедр — практический предел — ваша связь, вот почему параллельные fragment здесь действительно помогают, тогда как на Instagram они вредят. VOD только для подписчиков требуют cookies аккаунта с подпиской на канал; сессия, которая не видит трансляцию, не скачает её. Хайлайты — отдельные элементы, не под-плейлисты VOD — берите их по собственным URL.

Клипы — собственный extractor со своим потолком — клип упирается в качество источника, из которого вырезан, часто 1080p60, и URL клипа не даст вам полного VOD, из которого он вышел. Чтобы сохранить кусок VOD, скачайте VOD и режьте локально, либо используйте диапазон секций: --download-sections принимает временное окно без скачивания восьми часов ради пяти минут, и естественно сочетается с метаданными глав.

Раньше реклама запекалась в сегменты VOD на Twitch — extractor Twitch в yt-dlp теперь вырезает её, но лишь в свежих версиях, поэтому старый бинарник даёт запись с рекламными разрывами. Обновитесь, если в VOD есть необъяснимые разрывы. Стена подписки — другая граница: без сессии никакая опция не достанет VOD только для подписчиков, и подделать её невозможно.

О чате: Twitch хранит чат отдельным артефактом, и yt-dlp сохраняет его как JSON, сопоставив --write-subs с ним — файл не является форматом субтитров, а инструменты, отрисовывающие чат в видео, — отдельный шаг. Всё остальное идёт по ожидаемой форме: файл архива для текущей синхронизации канала, MKV для live, MP4 для VOD, а номер плейлиста — только когда многочастный элемент придаёт ему смысл.

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

› Как скачать VOD с Twitch?
Передайте адрес VOD. Они длинные, поэтому увеличьте число параллельных fragment для скорости, а если нужна только часть — задайте диапазон времени.
› Можно ли записать трансляцию Twitch?
Да. Там, где трансляция это позволяет, запись с начала берёт её от начала, а не с текущего момента. Прерванную запись MKV переносит лучше, чем MP4.
› Клипы работают?
Да, адреса клипов работают напрямую и не требуют особых опций.
› А VOD только для подписчиков?
Нужна сессия с подпиской: --cookies-from-browser с аккаунтом, у которого эта подписка есть.