Запись трансляций — генератор команд yt-dlp

Соберите команду yt-dlp для записи прямой трансляции — с начала, если платформа это позволяет.

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

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

Ваша команда

yt-dlp --merge-output-format mkv --no-playlist -N 4 --live-from-start --wait-for-video 60-300 'https://www.youtube.com/watch?v=live_stream_id'

Основное

Что вам нужно

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

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

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

Максимальное качество -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 Делает всё, кроме записи файла.

Сбросить

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

Записывать с начала --live-from-start Начинает запись трансляции с начала, а не с текущего момента.
Ждать начала трансляции --wait-for-video Опрашивает, пока запланированная трансляция не начнётся. MIN-MAX — интервал между проверками в секундах.
Container --merge-output-format Тип файла, в который объединяются раздельные видео- и аудиодорожки.
Параллельных fragment -N Ускоряет фрагментированные потоки. Четыре — разумное начало.

Как записывать трансляцию без потерь

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

Выбирайте MKV. Запись, оборвавшаяся неожиданно — а записи трансляций обрываются, — обычно оставляет воспроизводимый MKV, тогда как MP4, обрезанный посреди записи, часто вообще не открывается. Возобновить запись трансляции нельзя, поэтому выбор container и есть вся страховка.

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

› Можно ли записать трансляцию с начала?

Включите запись с начала. Это работает только там, где платформа ещё хранит предыдущую часть трансляции.

› Как записать трансляцию, которая ещё не началась?

Используйте ожидание трансляции с интервалом MIN-MAX. yt-dlp будет опрашивать и начнёт в тот момент, когда стрим выйдет в эфир.

› Какой container лучше для трансляций?

MKV. Он переносит обрыв записи, тогда как MP4, обрезанный посреди записи, может оказаться невоспроизводимым.

› Что будет, если запись прервётся?

С MKV обычно остаётся всё, что успело записаться. Возобновить запись трансляции нельзя — пропущенная часть потеряна.