Ir para o conteúdo principal
SubtitleMatrix

Formato de legenda VTT

O que este formato consegue expressar

Estilo do texto
Negrito e itálico
Posição na tela
Não
Sincronização karaokê
Não
Quebras de linha dentro de um bloco
Sim
Linha do tempo
Hora de início e de término para cada bloco
Resolução dos tempos
1 ms
Tempos guardados como números de quadro
Não
Texto da direita para a esquerda
Sim

Exemplos

Um arquivo WebVTT comum e o que se lê dele

Arquivo

WEBVTT

intro
00:00:01.000 --> 00:00:04.000
Hello there.

00:00:04.500 --> 00:00:08.000 align:start position:10%
Second line with <i>italics</i>.

O que ele contém

2 cues, 2 lines of text

  00:00:01.000 → 00:00:04.000
    Hello there.
  00:00:04.500 → 00:00:08.000
    Second line with italics.   [italic ×1]
    [settings align:start position:10%]

Outside the cues:
  header     "WEBVTT"

O lado direito não é um arquivo convertido — é o que este site extrai do lado esquerdo, incluindo o cabeçalho, os blocos NOTE/STYLE/REGION e os ajustes de cada carimbo.

Um arquivo WebVTT problemático e o que ainda se lê dele

Arquivo

WEBVTT - boundary sample

NOTE a comment
spanning two lines

STYLE
::cue { color: red }

REGION
id:fred
width:40%

00:01.000 --> 00:03.000
Hours-less timecode with <b>bold</b> and <v Roger>a voice tag.

00:05.000 --> 00:04.000
End before start.

NOTE between cues

00:07.000 --> 00:09.000
&nbsp; entities stay literal.

00:10.000 --> oops
Unreadable end time.

NOTE trailing

O que ele contém

3 cues, 3 lines of text

  00:00:01.000 → 00:00:03.000
    Hours-less timecode with bold and <v Roger>a voice tag.   [bold ×1]
  00:00:05.000 → 00:00:05.001
    End before start.
  00:00:07.000 → 00:00:09.000
    &nbsp; entities stay literal.

Outside the cues:
  header     "WEBVTT - boundary sample"
  blocks     NOTE ×3, STYLE, REGION

Reported while reading — repaired or skipped, never silently:
  1 × blocks that were neither a cue nor a NOTE/STYLE/REGION block (they were skipped)
  1 × cues whose end time was not after their start time (they were given a 1ms duration)

Sem cabeçalho, com fim de linha do Windows e uma linha solta antes do carimbo: nada disso lança erro, e o que não é compreendido é informado em vez de descartado em silêncio.

Converter WebVTT (VTT) para outro formato

Cada uma destas roda inteiramente no seu navegador. Os rótulos dizem o que aquela direção custa antes de você abri-la.

Convertendo para este formato

WebVTT (VTT) é um dos formatos de legenda que este site trata, e esta página é a sua referência: o que ele guarda, o que não guarda e uma página para cada formato ao qual dá para convertê-lo.

O WebVTT foi feito para a web e é o formato que o elemento video reconhece nativamente. Além dos blocos, ele modela o documento: há um cabeçalho, comentários em blocos NOTE, uma folha de estilo em STYLE e regiões em REGION, e cada carimbo pode vir seguido de ajustes de alinhamento e posição. A tabela acima mostra o limite — e quando uma linha diz não, é exatamente o que se perde ao converter para VTT.

Todas essas conversões rodam no navegador. Nada é enviado e nenhuma conta é necessária, o que importa para material sob NDA, prontuário de paciente ou embargo de emissora.

Perguntas frequentes

O que é um arquivo WebVTT?

É o formato de legenda que a web usa nativamente: a primeira linha é WEBVTT, cada bloco traz um carimbo com ponto decimal e o texto, e o arquivo pode conter comentários, estilo e regiões. Um video com track apontando para .vtt mostra a legenda sem plugin.

O VTT guarda posicionamento?

Guarda, em dois níveis: as regiões definidas em REGION e os ajustes do carimbo, como align:start, line:0 ou position:10%. É mais do que o SRT consegue e menos do que o ASS faz com coordenadas exatas.

Quais conversões levam todos os construtos do VTT?

Nenhuma desta tabela: NOTE, STYLE, REGION e os ajustes de carimbo só existem no próprio formato. O que varia é o resto — para SMI e TTML perde-se apenas essa camada; para TXT ou MICRODVD, também o estilo e o tempo.

Por que o WebVTT usa ponto no tempo e o SRT usa vírgula?

É a diferença de notação entre os dois: 00:00:04.126 no VTT e 00:00:04,126 no SRT nomeiam o mesmo instante. Converter entre eles troca apenas o separador, sem arredondar.

Um arquivo VTT pode ser usado fora do navegador?

Pode, e é comum: players de desktop, editores de legenda e plataformas de vídeo leem o formato. O que muda é o suporte aos construtos extras — NOTE, STYLE e REGION costumam ser ignorados por ferramentas que não os modelam.