Referência · WebVTT
Arquivo VTT (VTT file): o formato de legenda da web
Todo VTT file se identifica logo na primeira linha: a palavra WEBVTT, seguida de trechos cronometrados que o navegador desenha sobre um vídeo HTML5 — texto puro, nada além disso. O que o resto do documento guarda, quais serviços produzem essas faixas, como abrir e validar uma, como ela se conecta a uma página e onde o SRT ainda leva vantagem vêm a seguir.
Atualizado em
O que tem dentro de um arquivo VTT
A primeira linha entrega tudo: todo documento WebVTT começa com a palavra WEBVTT, e um player que não encontra isso descarta a faixa inteira. Os trechos vêm depois, separados por linhas em branco. Um trecho pode abrir com um identificador opcional, depois carrega uma linha de tempo como 00:01:30.500 --> 00:01:33.000 — ponto antes dos milésimos, com o campo de hora podendo faltar — seguida do texto a exibir.
O formato tem espaço para mais do que fala. Ajustes de trecho anexados à linha de tempo (line:, position:, align:, size:, vertical:) posicionam as palavras na tela; blocos NOTE guardam comentários; blocos STYLE carregam CSS mirando o pseudo-elemento ::cue; definições REGION descrevem as áreas que a legenda ao vivo usa para rolar texto. A codificação não é negociável, porque a especificação exige UTF-8. Se a conversa é o que você queria, reduza os trechos a um texto corrido e leia como qualquer outro documento.
De onde vêm essas faixas
A maioria das pessoas encontra o formato sem ter pedido por ele. O Zoom grava um ao lado de toda gravação transcrita na nuvem; o Microsoft Teams oferece o mesmo download depois de uma reunião; serviços de legenda automática exportam nesse formato por padrão. O streaming é a outra grande origem, já que uma playlist HLS entrega legendas como segmentos WebVTT, então qualquer reprodução adaptativa num navegador já usa esse formato por baixo dos panos. Plataformas de vídeo e ferramentas de curso seguem o mesmo caminho, porque é o que os players deles leem sem conversão — por isso um .vtt costuma chegar sem ter sido pedido, em vez de escolhido. Zoom e Teams também escrevem o nome de quem fala dentro do próprio texto do trecho, então a limpeza carrega esses nomes para o texto final.
Abrindo e validando um arquivo VTT
É texto puro, então Notepad, TextEdit ou VS Code abrem na hora, e o VLC anexa a faixa a um vídeo em reprodução quando você arrasta o arquivo para dentro. O Subtitle Edit e o Aegisub acrescentam uma forma de onda quando os trechos precisam de ajuste. Para checar se uma faixa é realmente válida, o teste mais rápido é o próprio navegador: aponte um elemento <track> para ela, abra o console de desenvolvedor e observe os avisos de interpretação.
Três falhas respondem por quase toda faixa rejeitada — um cabeçalho ausente ou escrito errado, vírgula onde deveria haver ponto, e um arquivo salvo numa página de código antiga em vez de UTF-8. As três aparecem já na primeira tela. Uma faixa escrita para uma timeline de edição em vez de um navegador fica melhor como SubRip para um editor de vídeo.
WebVTT ao lado do SRT
Os dois se sobrepõem quase inteiramente: ambos são listas de trechos cronometrados em texto puro, e um conversor anda entre eles em milissegundos. O WebVTT acrescenta o cabeçalho, o ponto, o UTF-8 obrigatório, identificadores de trecho opcionais, posicionamento e estilo. O SubRip mantém numeração obrigatória, vírgula, e o suporte mais amplo entre os formatos de legenda que existem. Use WebVTT quando um navegador ou um stream vai reproduzir o vídeo, SubRip quando um editor, um player de mesa ou um formulário de upload estiver envolvido. Quando a fonte é um vídeo publicado e nenhum dos dois formatos é realmente o que você quer, as legendas do YouTube como texto puro entregam só as palavras. O outro lado desta comparação, o arquivo SRT explicado com o mesmo nível de detalhe, cobre o formato mais antigo.
Perguntas frequentes
O que é um arquivo VTT?
Uma faixa de legenda no formato WebVTT, definido pelo W3C para vídeo HTML5. É texto puro: um cabeçalho WEBVTT, depois trechos que carregam início, fim e as palavras a exibir.
Como abro um arquivo VTT?
Qualquer editor de texto abre, já que é texto puro. O Subtitle Edit e o Aegisub acrescentam uma forma de onda para recronometrar, e arrastar o arquivo sobre uma janela do VLC anexa a legenda ao que está tocando.
Qual a diferença entre um arquivo VTT e um arquivo SRT?
O WebVTT exige o cabeçalho, usa ponto antes dos milésimos, precisa ser UTF-8 e aceita posicionamento, regiões e estilo em CSS. O SubRip numera cada trecho, usa vírgula, e é o formato que editores e players de mesa esperam.
De onde vêm os arquivos VTT?
De gravações do Zoom e do Teams, serviços de legenda automática, plataformas de streaming e playlists HLS — todos produzem esse formato porque é o que navegadores e pipelines de entrega falam nativamente.