polyshValidador de VTT
Saiba exatamente por que um arquivo WebVTT falha em um player e baixe um corrigido.
- Roda no seu navegador
- Sem uploads
- Sem conta
Carregando a ferramenta no navegador…
O que faz: Validador de VTT
Os navegadores são rigorosos com o WebVTT. Um cabeçalho que não está na primeira linha, uma vírgula em um timestamp ou um bloco STYLE depois da primeira legenda podem fazer uma faixa carregar sem legendas, e o console do desenvolvedor raramente explica por quê.
Cole o arquivo e cada problema é listado com a linha, de uma linha em branco faltando depois do cabeçalho a um & sem escape que esconde texto. Corrigir problemas gera um arquivo corrigido e o valida de novo. A correção também faz a limpeza de rotina: legendas vazias, ordenação e sobreposições.
Exemplo
Entrada
WEBVTT 00:00:01.000 --> 00:00:03.000 align:centre Termos & condições 00:00:03.000 --> 00:00:05.000 Pronto.
O relatório mostra
Linha 2 [erro] Adicione uma linha em branco entre o cabeçalho WEBVTT e a primeira legenda. Linha 2 [erro] A configuração de legenda inválida “align:centre” foi ignorada. Configurações válidas têm este formato: line:0, position:10%, align:start ou size:80%. Linha 3 [erro] A legenda 1 tem um “<” ou “&” solto. Escreva < ou &, ou os players podem esconder parte do texto.
O WebVTT só aceita a grafia align:center. Corrigir problemas acrescenta a linha em branco, descarta a configuração inválida e escreve &, e o arquivo corrigido passa.
Como usar: Validador de VTT
- Cole o texto WebVTT, escolha Abrir arquivo ou escolha Usar exemplo.
- Revise a tabela Problemas, ordenada pelo número da linha.
- Escolha Corrigir problemas e depois Baixar .vtt no painel Arquivo corrigido.
Bom saber
- O CSS dentro dos blocos STYLE não é verificado. Um erro de digitação em uma regra ::cue passa na validação, mas o estilo não é aplicado.
- Os nomes de região não são cruzados, então uma legenda que se refere a uma região que o arquivo nunca define é aceita.
- IDs de legenda duplicados geram avisos, e Corrigir problemas não mexe neles. Renomeie-os no Editor de VTT.
Perguntas sobre Validador de VTT
Por que minhas legendas VTT não aparecem?
Confira se o arquivo começa com WEBVTT na primeira linha, usa ponto antes dos milissegundos e tem uma linha em branco depois do cabeçalho e entre as legendas. Em um site, ele também precisa ser servido como text/vtt, com cabeçalhos CORS se estiver em outro domínio. O validador cobre tudo o que está dentro do arquivo.
Como validar um arquivo WebVTT?
Cole ou abra o arquivo aqui. O validador aponta problemas de cabeçalho, timestamps, configurações, escapes e ordem com os números das linhas e classifica cada um como erro ou aviso, para você saber o que corrigir primeiro.
Preciso escapar o & no WebVTT?
Sim. Um & ou < solto pode ser lido como início de marcação, e os players podem esconder o texto seguinte. Escreva & e < no lugar. Corrigir problemas faz esses escapes para você.
Um arquivo WebVTT pode ter BOM?
Sim, o formato permite uma marca de ordem de bytes (BOM) UTF-8 antes de WEBVTT. Mesmo assim, o validador a aponta como aviso, porque algumas ferramentas mais antigas a mostram como caracteres estranhos no início do arquivo.