Arquivo de legenda que não abre: erros mais comuns

A legenda não aparece ou o arquivo não abre? Siga um roteiro do sintoma à causa: extensão, linhas em branco, tempos, cabeçalho do VTT e codificação.

Por irokod.com Publicado em 7 min de leitura Fundamentos de legendas

Ilustração original do irokod.com, gerada para este artigo.

Você enviou o arquivo, o vídeo tocou normalmente e a legenda não apareceu. Ou ela apareceu só até certo ponto. Quase sempre a causa é pequena: uma extensão trocada, uma linha em branco que faltou, uma vírgula onde devia ter um ponto.

A boa notícia é que dá para procurar o erro em ordem, do mais provável ao menos provável. Este roteiro parte do sintoma que você vê, percorre os pontos do arquivo e termina na ligação com a página, quando o vídeo está em HTML.

Comece pelo sintoma

O que você vê aponta para onde olhar primeiro. A tabela resume os casos mais comuns:

Sintoma Causa provável O que fazer
O programa recusa o arquivo Extensão errada ou formato que o destino não lê Conferir o nome completo e a lista de formatos aceitos
O arquivo abre, mas não aparece nenhuma legenda Tempos inválidos, linhas em branco faltando ou VTT sem a palavra WEBVTT Conferir os blocos e a primeira linha
Só as primeiras legendas aparecem Um bloco com erro, a partir do qual a leitura falha Achar o primeiro bloco defeituoso
Aparecem símbolos no lugar dos acentos Codificação errada Reabrir ou converter para UTF-8
Em uma página HTML, nada aparece Problema na ligação entre o vídeo e o arquivo Revisar os atributos do elemento track
A legenda aparece fora de hora Não é erro de abertura, e sim de sincronia Seguir o guia de sincronização

Para um diagnóstico ordenado, percorra esta lista do começo ao fim e pare quando achar o problema:

Troque uma coisa por vez. Se você mudar três itens e a legenda voltar, não saberá qual deles era o culpado.

A extensão do arquivo

A ajuda do YouTube lista os formatos de legenda que aceita, entre eles .srt e .vtt. A especificação do WebVTT registra apenas a extensão vtt. Um arquivo chamado “legenda.txt” não entra nessa conta.

O erro mais traiçoeiro é o nome duplo. Dependendo da configuração do sistema, as extensões ficam escondidas, e “legenda.srt.txt” aparece como “legenda.srt”. Ative a exibição das extensões nas opções do gerenciador de arquivos e confira o nome completo. Também não adianta trocar .srt por .vtt no nome: mudar a extensão não muda o conteúdo.

A numeração e as linhas em branco

O registro PRONOM descreve o SRT como grupos de linhas de texto, com uma linha vazia entre cada grupo, e diz que a contagem das legendas começa em 1 e segue em ordem. Essa descrição não é norma, mas é o uso comum. É a linha vazia que separa um bloco do outro.

Quando ela falta, dois blocos grudam, e o programa pode ler o segundo número e o segundo tempo como se fossem texto da primeira fala. Quando sobra uma no meio do texto, o bloco se parte. Deixe uma linha vazia separando os blocos e nenhuma no meio de um bloco.

A numeração fora de ordem costuma incomodar menos, mas é melhor corrigi-la. Para rever o molde de cada bloco, leia a estrutura do SRT com um exemplo anotado.

O formato do tempo

A linha de tempo é o ponto mais frágil. Compare um arquivo defeituoso com a versão corrigida. O exemplo é inventado, de uma visita a um museu escolar.

Antes, com quatro defeitos:

1
00:00:01.000 -> 00:00:03,500
Bem-vindos ao museu da escola.
2
00:00:04,000 --> 00:00:02,000
Vamos começar pela sala de fósseis.

Depois:

1
00:00:01,000 --> 00:00:03,500
Bem-vindos ao museu da escola.

2
00:00:04,000 --> 00:00:06,500
Vamos começar pela sala de fósseis.

Os defeitos eram quatro: ponto no lugar da vírgula no primeiro tempo, seta com um hífen só, falta da linha em branco entre os blocos e fim menor que o início no segundo bloco. O PRONOM descreve o tempo do SRT com vírgula antes dos milissegundos e dois dígitos em cada unidade. Para o WebVTT, o W3C pede ponto, minutos e segundos de 00 a 59, três dígitos de milissegundos, a seta com espaços e um tempo final maior que o inicial.

Um programa mais rígido pode ignorar o bloco com erro, ou parar de ler a partir dele. Por isso o sintoma “só as primeiras legendas aparecem” quase sempre aponta para o primeiro bloco defeituoso. No irokod.com, abra o arquivo no editor de legendas: a mensagem de status informa quantas falas ele encontrou e avisa quando ignora blocos sem tempo válido.

O cabeçalho do VTT e a ligação com a página

Um arquivo WebVTT precisa começar com a palavra WEBVTT. O W3C aceita, antes dela, só um BOM opcional. Logo depois pode vir um cabeçalho de texto livre na mesma linha, seguido de uma linha vazia.

Se você converteu um SRT sem acrescentar essa linha, o arquivo deixa de ser WebVTT válido. Detalhes do cabeçalho estão em o arquivo VTT, do cabeçalho aos estilos.

Se o seu vídeo fica numa página HTML, o arquivo pode estar certo e a ligação, errada. A MDN lista pontos de atenção do elemento track:

  • Um valor inválido em kind é tratado como metadata, e esse tipo não aparece para o usuário. Digitar “subtitle” em vez de “subtitles” causa isso.
  • O atributo src é obrigatório e deve ter a mesma origem da página, a menos que o vídeo tenha o atributo crossorigin.
  • O atributo srclang é obrigatório quando kind é subtitles.
  • O atributo default só pode aparecer em um track por vídeo.
  • Não pode haver dois track com a mesma combinação de kind, srclang e label.

O W3C também diz que o arquivo deve ser servido com o tipo text/vtt. Se a página é sua, peça a quem cuida do servidor que confira. A MDN lembra, ainda, que cada navegador suporta um conjunto diferente de recursos de legenda. Os atributos, um a um, estão em como ligar a legenda a um vídeo em HTML.

A codificação

Se o arquivo abre e a legenda aparece, mas os acentos viram símbolos, o erro é de codificação. O YouTube pede arquivos .srt em UTF-8 simples, e o W3C diz que o corpo de um WebVTT deve ser UTF-8. A explicação completa, com a tabela de exemplos e o passo a passo para corrigir, está em UTF-8, Windows-1252 e BOM: o que são e como corrigir. Aqui basta lembrar: se o programa mostra “Ô ou um losango com interrogação no lugar da letra, o conserto não é no tempo nem no número, e sim na codificação.

Erros comuns

  • Mudar vários itens de uma vez. A causa é a pressa. Troque um item e teste, depois o seguinte, até achar o responsável.
  • Editar o arquivo em um processador de texto. Esses programas podem trocar símbolos pela autocorreção ou salvar em formato próprio. Prefira um editor de texto puro ou o editor de legendas.
  • Renomear a extensão em vez de converter. O arquivo continua sendo o que era. Se quer outro formato, faça a conversão.
  • Procurar o defeito só no arquivo quando o problema está na página. Se o arquivo abre em outro lugar, revise o elemento track.
  • Testar em um único navegador ou player. O suporte varia. Teste no ambiente onde a legenda será usada.
  • Mexer no arquivo sem guardar o original. Se o conserto piorar, você perde o ponto de partida. Faça uma cópia antes.

Perguntas frequentes

Como saber se o arquivo é mesmo um SRT?

Abra-o em um editor de texto. Você deve ver blocos com numeração, tempos ligados por uma seta e o texto, separados por linhas vazias. A ficha PRONOM diz que os primeiros bytes de um SRT seguem o desenho hh:mm:ss,mmm —> hh:mm:ss,mmm.

O arquivo abre no editor de texto, mas não no player. O que fazer?

Compare-o com um modelo que funciona e confira o tempo, as linhas em branco e a codificação. Abrir o arquivo no editor de legendas e exportar de novo costuma regravar os blocos no formato padrão, o que limpa problemas de numeração e de linhas em branco.

Por que a legenda funciona no meu computador e não na plataforma?

Cada destino impõe as suas regras. O YouTube, por exemplo, aceita só as versões básicas do SRT e exige UTF-8 simples. Leia a página de formatos aceitos do destino antes de enviar.

Um VTT sem a palavra WEBVTT funciona?

Pela especificação, ele não é um WebVTT válido. Alguns programas podem ser mais tolerantes, mas não vale contar com isso. Acrescente a linha na primeira posição e deixe uma linha em branco depois dela.

Fontes

  1. W3C. WebVTT: The Web Video Text Tracks Format. Consultado em 19 de novembro de 2026.
  2. MDN Web Docs (Mozilla). <track> HTML embed text track element - HTML | MDN. Consultado em 19 de novembro de 2026.
  3. MDN Web Docs (Mozilla). Adding captions and subtitles to HTML video - Media | MDN. Consultado em 19 de novembro de 2026.
  4. Google (Ajuda do YouTube). Supported subtitle and closed caption files - YouTube Help. Consultado em 19 de novembro de 2026.
  5. The National Archives (Reino Unido), registro PRONOM. SubRip Subtitle File - PRONOM - The National Archives. Fonte não oficial: descreve o uso comum do formato. Consultado em 19 de novembro de 2026.

Continue lendo