Capítulos do YouTube a partir de um VOD da Twitch

Você subiu para o YouTube a live de quatro horas de ontem à noite e ela está lá, um bloco único. A barra de progresso não dá a ninguém um ponto óbvio para começar, então o VOD fica parado enquanto os clipes fazem o trabalho. Os capítulos mudam a cara dessa página, e o YouTube é bem específico sobre como você escreve eles.

O que o YouTube exige

Três requisitos vêm direto da página de ajuda do YouTube sobre como adicionar capítulos a um vídeo. Trate cada um como uma condição que o bloco precisa cumprir antes de o YouTube montar capítulos a partir dele.

• O primeiro timestamp tem que ser 00:00. Não 00:04, não 00:11.
• Você precisa de pelo menos três timestamps, em ordem crescente.
• Todo capítulo tem que durar pelo menos 10 segundos.

Confira se o primeiro timestamp que você listar começa com 00:00. Seu vídeo precisa ter pelo menos três timestamps listados em ordem crescente. A duração mínima dos capítulos de vídeo é de 10 segundos.

Ajuda do YouTube, Adicionar capítulos a um vídeo

Os timestamps ficam na descrição do vídeo. O YouTube também pode gerar capítulos por conta própria, e a mesma página de ajuda toma cuidado com isso: “Nem todos os vídeos são elegíveis para capítulos automáticos, e nem todos os vídeos elegíveis vão ter capítulos automáticos.” Uma lista manual substitui o que ele tiver produzido — a página diz que a opção “vai substituir os capítulos de vídeo automáticos”. Você também pode desligar os capítulos automáticos em um vídeo específico, na página de detalhes dele, ou no canal inteiro pelo YouTube Studio, em Configurações, Padrões de upload, Configurações avançadas.

Por que uma live republicada precisa deles

Um VOD de live tem um formato estranho para o YouTube. Ele é longo, não começa com nenhum gancho, e os primeiros minutos costumam ser você mexendo no OBS. Os capítulos deixam a barra de progresso legível: o YouTube divide ela em segmentos com rótulo e lista os títulos embaixo do player, então quem chegou por um clipe consegue cair na troca de jogo em vez do teste de microfone. É um conserto de navegação para um vídeo que é quase todo ambiente, e esse é o motivo inteiro para fazer isso.

De onde vêm os capítulos do ClipEZ

O ClipEZ detecta os capítulos como uma etapa da análise, depois da transcrição. A chamada enxerga a transcrição e a duração da live — os tempos de início de cada segmento e o texto deles, nada além disso. O log do chat, a forma de onda e os frames do vídeo não chegam até ela. O prompt pede um sumário amplo de uma live contínua: um jogo novo, uma atividade nova, uma pausa longa, um problema técnico, o encerramento. Ele também manda o modelo juntar capítulos vizinhos que cobrem a mesma atividade e pular uma divisão quando estiver em dúvida.

Vale conhecer dois detalhes de implementação. Todo tempo de início de capítulo é encaixado no limite exato de um segmento da transcrição, então um capítulo começa onde uma frase começa. E o número de capítulos que se busca sai da duração da live — mais ou menos um a cada quinze minutos, com teto de vinte, entregue ao modelo como um piso e um teto flexíveis, não como uma cota. O prompt manda devolver menos quando a live é homogênea, então três horas do mesmo jogo voltam com menos capítulos do que uma live variada da mesma duração.

Um capítulo longo pode carregar subcapítulos: uma tentativa contra um chefe, um problema técnico dentro de uma fase maior. Eles são pontos de navegação dentro do ClipEZ. O formato de capítulos do YouTube é plano, então nada aninhado sobrevive a uma colagem na descrição.

Como o bloco da descrição é gerado

Esta é a parte que pega as pessoas de surpresa. A exportação de capítulos do YouTube lê os seus cortes. Os capítulos detectados servem para você achar as divisões; o arquivo é montado com o que você marcou.

1. Marque um corte em cada ponto que você quer que vire capítulo. Pule para um capítulo detectado, confirme que ali tem uma mudança de fase de verdade e marque o corte.
2. Sinalize esses cortes para exportação, para que apareçam na lista de clipes da janela de exportação.
3. Marque Capítulos do YT na janela de exportação e rode a exportação.

O ClipEZ grava um único arquivo, youtube-chapters.txt, na pasta de saída — por padrão, uma pasta ao lado do seu vídeo de origem e com o nome dele. Os cortes são ordenados por tempo de início antes de qualquer coisa ser escrita, então a ordem em que você marcou não importa. Cada linha é um timestamp e um título. O título é o título do clipe quando você já gerou os metadados do clipe; se não, o rótulo que você digitou no corte; e se não, um simples Chapter 3. Abaixo de uma hora o timestamp sai como MM:SS; passando de uma hora, ele ganha o campo de horas.

Se o primeiro corte não começa na origem, o ClipEZ coloca antes uma linha 00:00 Intro para o bloco cumprir o primeiro requisito do YouTube. Um corte que comece em qualquer ponto do primeiro segundo já sai como 00:00, e nesse caso a linha Intro é pulada — duas linhas 00:00 quebrariam o conjunto. Um arquivo pronto fica assim:

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

Onde isso quebra

• Os timestamps são posições no VOD de origem. Corte a introdução antes de subir e todo capítulo desloca pelo tanto que você tirou, o que joga o bloco inteiro fora do lugar. Suba o VOD sem mexer, ou marque tudo de novo depois de cortar.
• O YouTube deduz a duração de um capítulo pelo intervalo até o próximo timestamp. A duração do seu corte não influencia nada, então dois cortes com cinco segundos de distância geram um capítulo de cinco segundos e ficam abaixo do mínimo de 10 segundos do YouTube.
• Você precisa de três timestamps. Um corte marcado mais a linha Intro automática te dão só dois.
• Os títulos são colados na íntegra em uma descrição pública e aparecem no tooltip da barra de progresso. Mantenha os títulos curtos.
• Os capítulos não estão disponíveis em todo vídeo. A página de ajuda do YouTube diz que, se o canal tiver algum strike ativo, ou se o conteúdo puder ser inapropriado para alguns espectadores, o recurso não fica disponível.

O que o ClipEZ não faz aqui

Ele não faz upload, não escreve a sua descrição e não toca no seu canal. A exportação é um arquivo de texto no seu disco. Você abre o vídeo no YouTube Studio, cola o bloco na descrição e salva. Se os capítulos automáticos estavam ligados nesse vídeo, a lista que você colou substitui os automáticos.

A detecção de capítulos te poupa aquela passada em que você arrasta uma linha do tempo de quatro horas tentando lembrar quando trocou de jogo. A exportação te poupa a formatação. Quais fases merecem uma linha continua sendo decisão sua, e essa é a parte que você sempre ia julgar melhor do que um modelo lendo uma transcrição.