Skip to content

Converter Legendas YouTube JSON3 para VTT

Transforme eventos timedtext JSON3 em WebVTT com cabeçalho WEBVTT obrigatório e tempos HH:MM:SS.mmm.

Arraste e solte seu arquivo JSON aqui

ou clique para procurar

Suporta arquivos .json, .json3, .xml, .html de até 50 MB

Arquitetura do motor principal

Sobre JSON para VTT

Os elementos track do HTML5 e a maioria das plataformas de vídeo web não aceitam JSON3. Esta ferramenta analisa o array events, une os fragmentos segs, calcula o tempo dos cues e escreve WebVTT válido com o cabeçalho WEBVTT obrigatório. O arquivo fica pronto para vídeo HTML5, YouTube Studio, Vimeo e players JavaScript.

Inspetor de payload e sintaxe

JSON para VTT Inspeção de sintaxe e estrutura de código

Comparação lado a lado da sintaxe de código ilustrando definições de cabeçalho, sintaxe de timestamp e formatação de payload de cues

Sincronização de milissegundos
input.json
JSON FONTE
{
"events": [
{ "tStartMs": 1000, "dDurationMs": 3000,
"segs": [{ "utf8": "Hello, world!" }] },
{ "tStartMs": 4500, "dDurationMs": 3500,
"segs": [{ "utf8": "This is a subtitle file." }] }
]
}
output.vtt
VTT RESULTADO
WEBVTT
 
00:00:01.000 --> 00:00:04.000
Hello, world!
 
00:00:04.500 --> 00:00:08.000
This is a subtitle file.
 
00:00:08.500 --> 00:00:12.000
Converted locally!
Folha de especificações

JSON vs VTT Especificações técnicas

Conforme aos padrões
Formato de Entrada

JSON

JSON

JSON3 é o formato de legendas interno do YouTube, exportado via API timedtext. O arquivo é um objeto JSON com um array de eventos. Cada evento tem tStartMs (milissegundo de início), dDurationMs (duração em ms) e segs (array de fragmentos de texto, cada um com um campo utf8). Baixado tipicamente com youtube-dl ou yt-dlp.

Formato de Saída

VTT

VTT

WebVTT (.vtt) é o padrão W3C para legendas em vídeo HTML5. Começa com o cabeçalho WEBVTT e usa timestamps no formato HH:MM:SS.mmm com a seta -->.

Diferenças de Formato

JSON3 usa um array events do YouTube; VTT usa cabeçalho WEBVTT e blocos de cue
JSON3 armazena tStartMs e dDurationMs; VTT armazena HH:MM:SS.mmm --> HH:MM:SS.mmm
JSON3 é proprietário do YouTube; VTT é o padrão W3C para vídeo web
Navegadores não conseguem carregar JSON3 via track; VTT é o formato nativo de HTML5

Solução de problemas de conversão e armadilhas comuns

Soluções práticas para compatibilidade de players, codificação de caracteres e sincronização de tempos

4 armadilhas comuns
GOTCHA #1

As legendas ficam fora de sincronia ou atrasadas no reprodutor

Vídeos com taxas de quadros distintas podem causar dessincronia. Use nossa ferramenta de Sincronização de Legendas para calibrar o atraso.

GOTCHA #2

Caracteres acentuados aparecem corrompidos ou como pontos de interrogação

Arquivos legados em codificações regionais podem falhar. Nosso exportador padroniza a saída em UTF-8 limpo e compatível.

GOTCHA #3

Legendas sobrepostas quando mais de uma pessoa fala ao mesmo tempo

Cada formato lida com sobreposições de forma diferente. Você pode ajustar as durações no nosso Editor de Legendas.

GOTCHA #4

Softwares de edição de vídeo recusam o arquivo importado

Nossos conversores geram saídas rigorosamente padronizadas para fluxos de trabalho no Premiere Pro e DaVinci Resolve.

Recursos

Analisa automaticamente o array de eventos JSON3 e fragmentos de texto segs
Converte timestamps JSON3 em milissegundos para o formato VTT HH:MM:SS.mmm
Processamento no cliente — seus arquivos nunca saem do seu dispositivo
Suporta codificação UTF-8 para caracteres CJK e não latinos
Processamento no navegador; os arquivos não são enviados
Grátis, sem registro, sem marca d'água, arquivos de até 50 MB cada

Por que Converter?

Elementos de vídeo HTML5 exigem VTT via a tag track. Arquivos JSON3 não carregam em nenhum navegador.
YouTube Studio aceita upload de VTT para legendas mas não reconhece formato JSON3.
Vimeo exige VTT para upload de closed captions pela interface web.
JSON3 é um formato legado; VTT é o padrão moderno para vídeo web.
O WebVTT é amplamente usado para legendas em vídeo HTML5 e players baseados em navegador.
Plataformas de cursos online (Coursera, Canvas LMS, Moodle) só aceitam VTT para legendas de vídeo.
O VTT suporta posicionamento, estilos e metadados que o JSON3 não consegue representar.
Scenarios

Casos de Uso Comuns

Vídeo HTML5

Adicione legendas a <video> HTML5 usando <track> com WebVTT.

YouTube

Carregue VTT no YouTube Studio após converter de JSON3.

Players JavaScript

Use VTT com Video.js, JW Player, Plyr.

Acessibilidade Web

Forneça legendas acessíveis usando VTT.

E-learning

Adicione legendas VTT a vídeos de aulas.

Format Ecosystem

Formatos Relacionados

JSON (YouTube JSON3)

JSON3 é o formato de legendas interno do YouTube, exportado via API timedtext. O arquivo é um objeto JSON com um array de eventos. Cada evento tem tStartMs (milissegundo de início), dDurationMs (duração em ms) e segs (array de fragmentos de texto, cada um com um campo utf8). Baixado tipicamente com youtube-dl ou yt-dlp.

SRT (SubRip)

Formato de legenda universal. Converta JSON3 para SRT para compatibilidade ampla.

VTT (WebVTT)

Formato de legenda web nativo. Já é o formato de saída desta conversão.

Como Funciona

  1. 1

    Carregue ou arraste seu arquivo .json para a área da ferramenta.

  2. 2

    O parser lê a estrutura JSON e itera o array de eventos.

  3. 3

    Timestamps JSON3 são convertidos para a notação VTT com seta e ponto decimal.

  4. 4

    Eventos sem segs (apenas temporização) são pulados automaticamente.

  5. 5

    O arquivo .vtt resultante começa com WEBVTT e contém cues válidos com notação de seta.

Perguntas Frequentes

JSON3 é o formato de legendas interno do YouTube, servido via API timedtext como um objeto JSON com array de eventos. Cada evento tem tStartMs, dDurationMs e segs.

Os fragmentos utf8 de cada evento são unidos na ordem original. Por exemplo, "Hello " e "world" formam a linha completa "Hello world".

Sim. A saída inclui o cabeçalho WEBVTT obrigatório e tempos de cue válidos para YouTube Studio, Vimeo, elemento track do HTML5, Video.js, Plyr e JW Player.

Use yt-dlp: yt-dlp --write-auto-sub --sub-format json3 <URL-do-vídeo>. O arquivo .json3 pode ser importado diretamente.

Eventos com apenas informação de tempo são pulados automaticamente e não afetam a saída VTT.

WebVTT (.vtt) é o padrão W3C para legendas em vídeo HTML5. Começa com o cabeçalho WEBVTT e usa timestamps no formato HH:MM:SS.mmm com a seta -->.

Pronto para converter suas legendas?

Solte seu arquivo JSON aqui e converta para VTT instantaneamente.