Главы для YouTube из записи с Twitch
Правила YouTube для тайм-кодов глав, зачем они перезалитым записям стримов и как ClipEZ находит главы и собирает блок для описания.
Ты залил вчерашний четырёхчасовой стрим на YouTube, и он лежит там одним сплошным куском. По полосе воспроизведения зрителю непонятно, с какого места начинать, так что запись в основном простаивает, а всю работу делают клипы. Главы меняют вид этой страницы, и у YouTube есть чёткие правила, как их писать.
Что требует YouTube
Три требования взяты прямо со страницы справки YouTube про добавление глав в видео. Считай их условиями, которым блок должен отвечать, прежде чем YouTube построит по нему главы.
- Первый тайм-код должен быть 00:00. Не 00:04 и не 00:11.
- Тайм-кодов нужно минимум три, по возрастанию.
- Каждая глава должна длиться не меньше 10 секунд.
Первый тайм-код в списке должен начинаться с 00:00. В видео должно быть не менее трёх тайм-кодов в порядке возрастания. Минимальная длительность главы видео — 10 секунд.
Справка YouTube, «Как добавить главы в видео»
Тайм-коды живут в описании видео. YouTube умеет создавать главы и сам, и та же страница справки формулирует это осторожно: «Автоматические главы доступны не для всех видео, и не у всех подходящих видео они появятся». Ручной список перебивает всё, что получилось у автоматики, — на странице сказано, что этот вариант «переопределяет автоматические главы видео». Автоматические главы можно и отключить: для одного видео на странице сведений о нём или сразу для всего канала в YouTube Studio в разделе «Настройки», «Настройки загрузки по умолчанию», «Расширенные настройки».
Зачем они перезалитому стриму
Запись стрима плохо ложится на YouTube. Она длинная, в ней нет цепляющего начала, а первые минуты — это обычно ты, чинящий OBS. Главы делают полосу воспроизведения читаемой: YouTube разбивает её на подписанные отрезки и выводит названия под плеером, так что зритель, пришедший из клипа, попадёт на смену игры, а не на проверку микрофона. Для видео, которое чаще всего идёт фоном, это решение проблемы навигации, и в этом весь смысл затеи.
Откуда берутся главы в ClipEZ
Поиск глав в ClipEZ — это отдельный этап разбора, который идёт после расшифровки. Запрос видит расшифровку и длину стрима: время начала сегментов и их текст, больше ничего. Ни лога чата, ни волновой формы, ни кадров видео до него не доходит. Промпт просит общее оглавление одного непрерывного стрима: новая игра, новое занятие, долгий перерыв, технические неполадки, прощание в конце. Ещё он велит модели объединять соседние главы, если они про одно и то же занятие, и пропускать границу, если модель в ней не уверена.
Про две детали реализации стоит знать. Время начала каждой главы притягивается к точной границе сегмента расшифровки, так что глава начинается там же, где начинается предложение. А нужное количество глав считается от длины стрима — примерно по одной на пятнадцать минут, но не больше двадцати, и модель получает это как мягкие нижнюю и верхнюю границы, а не как норму. Промпт говорит ей возвращать меньше, если стрим однообразный, поэтому три часа одной игры вернутся с меньшим числом глав, чем разноплановый стрим той же длины.

У длинной главы могут быть подглавы — попытка пройти босса, технический сбой внутри более длинного отрезка. Это точки навигации внутри ClipEZ. Формат глав у YouTube плоский, так что вложенность не переживает вставку в описание.
Как собирается блок для описания
Вот место, где обычно все удивляются. Экспорт глав для YouTube читает твои клипы. Найденные главы нужны, чтобы увидеть границы; сам файл собирается из того, что ты отметил.
- Отмечай клип в каждой точке, которая должна стать главой. Перейди к найденной главе, убедись, что там правда начинается новый этап, и поставь отметку.
- Выбери эти клипы для экспорта, чтобы они попали в список клипов в окне экспорта.
- Поставь галочку «Главы YT» в окне экспорта и запусти его.
ClipEZ пишет один файл, youtube-chapters.txt, в папку вывода — по умолчанию это папка рядом с исходным видео, названная по нему. Перед записью клипы сортируются по времени начала, так что порядок, в котором ты их отмечал, роли не играет. Каждая строка — это тайм-код и заголовок. Заголовок берётся из метаданных клипа, если ты их сгенерировал, иначе — из подписи, которую ты сам вписал клипу, иначе это будет просто Chapter 3. До часа тайм-код пишется как MM:SS, после часа добавляется поле часов.

Если первый клип начинается не с нуля, ClipEZ добавляет сверху строку 00:00 Intro, чтобы блок отвечал первому требованию YouTube. Клип, начинающийся где угодно внутри первой секунды, и так выводится как 00:00, и тогда строка Intro пропускается — две строки с 00:00 сломали бы весь блок. Готовый файл выглядит так:
00:00 Intro 40:37 His crit build suddenly deletes the entire room 58:03 Gets saved by a resurrection relic after barely surviving the puppet fight 1:07:11 Survives an impossible boss attack and kills him mid-monologue 1:09:20 Thinks he died, then discovers he actually won
Где это ломается
- Тайм-коды — это позиции в исходной записи. Обрежешь интро перед загрузкой — каждая глава сдвинется ровно на вырезанное, и весь блок поедет. Заливай запись без изменений или переотмечай клипы после обрезки.
- Длину главы YouTube считает по расстоянию до следующего тайм-кода. Длина самого клипа на это никак не влияет, так что два клипа с разницей в пять секунд дадут пятисекундную главу и не дотянут до минимума YouTube в 10 секунд.
- Тайм-кодов нужно три. Один отмеченный клип плюс автоматическая строка Intro дают только два.
- Заголовки попадают в публичное описание слово в слово и всплывают подсказкой на полосе воспроизведения. Держи их короткими.
- Главы доступны не для каждого видео. На странице справки YouTube сказано, что функция будет недоступна, если у канала есть активные предупреждения или если контент может оказаться неприемлемым для части зрителей.
Чего ClipEZ здесь не делает
Он ничего не загружает, не пишет за тебя описание и не трогает твой канал. Экспорт — это текстовый файл у тебя на диске. Ты открываешь видео в YouTube Studio, вставляешь блок в описание и сохраняешь. Если для этого видео были включены автоматические главы, вставленный список их заменит.
Поиск глав избавляет тебя от прохода, в котором ты мотаешь четырёхчасовой таймлайн и пытаешься вспомнить, когда сменил игру. Экспорт избавляет от возни с форматированием. Какие отрезки заслуживают отдельной строки, решаешь по-прежнему ты, и как раз это ты всегда рассудишь лучше, чем модель, читающая расшифровку.
ClipEZ в закрытой бете. Если ты перезаливаешь свои стримы на YouTube, а блок глав — та рутина, которую ты вечно откладываешь, запишись.
Записаться в лист ожидания