Criador de SRT Trilíngue (TH / EN / ZH)
Um vídeo curto com legendas em três idiomas pode alcançar espectadores que nunca assistiriam a uma voz que não entendem. Mas legendas ruins são piores que nenhuma: linhas dessincronizadas, frases cortadas no meio da palavra, ou chinês que parece tradução automática fazem o clipe parecer barato. Este skill produz três arquivos SRT que compartilham exatamente os mesmos tempos, são lidos de forma natural e cabem na tela de um celular.
O script incluído scripts/make_srt.py (apenas biblioteca padrão Python) escreve os arquivos e os verifica. Use-o sempre que puder executar código; se não puder, siga as mesmas regras manualmente e forneça o texto SRT em blocos de código.
Passo 1 — Obter o texto fonte com tempos
Descubra qual destes o usuário possui, do melhor para o pior:
- Uma transcrição com timestamps (SRT/VTT do aplicativo de edição, legendas automáticas do YouTube, ferramenta de fala para texto) → use seus tempos. Mescle ou divida as falas para que cada uma seja uma única ideia de 1 a 3,5 segundos.
- O roteiro final + a duração do clipe → divida o roteiro em falas (uma frase falada cada) e deixe o script estimar os tempos com
--estimate <segundos>. Avise ao usuário que os tempos são estimativas e devem ser ajustados no editor dele para corresponder à voz — legendas estimadas são a causa mais comum de "legendas parecem estranhas". - Apenas um arquivo de áudio/vídeo → se você tiver uma ferramenta de fala para texto nesta sessão, transcreva primeiro com timestamps por palavra. Se não tiver, diga isso claramente e peça uma exportação da transcrição do aplicativo de edição (a maioria dos editores e do YouTube Studio podem exportar legendas). Nunca invente o que foi dito.
Mantenha o idioma de origem exatamente como falado — legendas que diferem da voz confundem os espectadores. Apenas corrija erros óbvios de transcrição (palavras ouvidas erradas, nomes de marcas) e informe ao usuário quais erros você corrigiu.
Passo 2 — Traduzir linha por linha
Traduza cada fala separadamente para que os tempos permaneçam idênticos entre os idiomas. Regras:
- Falado, curto, natural. Legendas são lidas em um ou dois segundos. Prefira "Desligue à noite" em vez de "Recomenda-se que o dispositivo seja desligado durante o período noturno."
- Significado sobre palavras. Enchimentos em tailandês (นะครับ, เลย, อ่ะ) desaparecem em inglês e chinês. Expressões idiomáticas ganham um equivalente, não uma cópia literal.
- Mantenha números, unidades, nomes de modelos e nomes de aplicativos idênticos nos três arquivos, e no mesmo formato (ex.: 80%, 20W, iOS 26). Verifique se todo número na linha em tailandês também aparece nas linhas em inglês e chinês.
- Chinês = Simplificado (zh-Hans) a menos que o usuário peça Tradicional (zh-Hant, para espectadores de Taiwan/Hong Kong). Use pontuação de largura total (,。?!). Não coloque espaços entre caracteres chineses.
- Rótulos de menu e texto de interface na tela: use o rótulo como ele realmente aparece na versão do aplicativo/telefone naquele idioma, se você souber; se não tiver certeza do rótulo oficial, traduza descritivamente e sinalize para o usuário verificar em um dispositivo configurado para aquele idioma.
- Nomes de produtos/marcas, nomes de lugares e nomes de pessoas: mantenha a romanização oficial; não traduza nomes de marcas para chinês a menos que a marca tenha um nome chinês oficial do qual você tenha certeza.
- Não adicione informações, piadas ou emojis que não estejam na voz.
Passo 3 — Escrever o JSON e executar o script
{
"langs": ["th", "en", "zh-Hans"],
"segments": [
{"start": 0.0, "end": 2.6, "th": "ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม?", "en": "Does charging overnight ruin your battery?", "zh-Hans": "整夜充电会伤电池吗?"},
{"start": 2.7, "end": 6.1, "th": "คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ", "en": "Short answer: not instantly, but heat is the real enemy.", "zh-Hans": "简单说:不会马上坏,但真正的敌人是热量。"}
]
}
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01
# sem tempos ainda:
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01 --estimate 38.5
Saída: subs/clip01.th.srt, subs/clip01.en.srt, subs/clip01.zh-Hans.srt mais um relatório de controle de qualidade.
Quebras de linha: o script quebra falas longas em duas linhas. O tailandês não tem espaços entre palavras, então ele só quebra nos espaços que escritores tailandeses colocam entre frases — nunca cortará uma palavra tailandesa ao meio. Se uma fala em tailandês for sinalizada como muito longa, adicione um espaço entre frases onde a quebra seja natural, ou force a quebra com | (espaço-pipe-espaço), ex.: "เปิดโหมดชาร์จ | แบบปรับให้เหมาะสม".
Passo 4 — Corrigir toda mensagem de controle de qualidade
O script verifica, por idioma:
| Verificação | Limite padrão | Por que é importante |
|---|---|---|
| Caracteres por linha | TH 24 · EN 38 · ZH 15 | Tela vertical; linhas mais longas ficam sob os botões de like/comentário |
| Linhas por fala | 2 | Três linhas cobrem a imagem |
| Velocidade de leitura (caracteres/segundo) | TH 17 · EN 20 · ZH 9 | Mais rápido que isso e os espectadores não conseguem terminar de ler |
| Tempo na tela | ≥ 0,7 s | Lampejos são ilegíveis |
| Sobreposições / fim antes do início / texto vazio | nenhum permitido | As plataformas rejeitam ou exibem mal o arquivo |
Corrija encurtando a tradução (primeira escolha), dividindo uma fala longa em duas, ou mesclando uma fala rápida com a vizinha. Reexecute até que haja 0 erros; alguns avisos são aceitáveis se você informar o usuário sobre eles. Os limites podem ser alterados com --max-line e --max-cps se o estilo do usuário for diferente.
A contagem de caracteres em tailandês ignora marcas de vogais e tons que ficam acima ou abaixo de uma letra, porque não ocupam largura na tela.
Passo 5 — Entregar
Forneça ao usuário:
- Os três arquivos
.srt(ou seu conteúdo em blocos de código se você não puder criar arquivos). - Uma pequena tabela de quaisquer linhas sobre as quais você não tinha certeza (rótulos de interface, gírias, nomes) para que ele possa verificar.
- Como usá-los:
- YouTube Studio: Legendas → escolha o vídeo → Adicionar idioma → Enviar arquivo → "Com sincronização". Envie um arquivo por idioma. Defina também primeiro o idioma original do vídeo.
- Legendas incorporadas (texto desenhado no vídeo): a maioria dos espectadores de vídeos curtos assiste sem áudio, então incorporar o idioma principal no vídeo e enviar os outros como SRT é uma escolha comum. Muitos editores importam SRT e estilizam.
- TikTok / Reels: o suporte para envio de arquivos SRT varia conforme a versão e região do aplicativo — se não houver opção de envio, incorpore as legendas no vídeo no editor. Verifique a página de ajuda atual da plataforma.
Exemplo
Usuário: "Faz legenda 3 idiomas aí, clipe 9s" + roteiro:
ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม? / คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ / เปิดโหมดชาร์จแบบปรับให้เหมาะสม ในตั้งค่าแบตเตอรี่
O que você faz: três falas → traduzir → executar com --estimate 9 → o QC avisa que a fala 3 em tailandês tem uma linha de 26 caracteres (เปิดโหมดชาร์จแบบปรับให้เหมาะสม, limite 24). Forçar uma quebra não ajudaria aqui (a segunda linha ficaria muito longa), então encurte a legenda: "เปิดโหมดถนอมแบต ในตั้งค่าแบตเตอรี่". Uma legenda pode ser um pouco mais curta que a linha falada, desde que o significado seja o mesmo; se o estilo do usuário for legendas palavra por palavra, pergunte antes de encurtar. Reexecute: 0 erros, 1 aviso (tempos estimados). Entregue os três arquivos e diga: "os tempos foram estimados a partir do comprimento do texto — ajuste-os para corresponder à sua voz no editor; verifique o nome em inglês/chinês da configuração de bateria em um telefone configurado para aquele idioma".
Resultado de clip01.th.srt:
1
00:00:00,000 --> 00:00:02,653
ชาร์จมือถือข้ามคืน
แบตเสื่อมจริงไหม?
2
00:00:02,653 --> 00:00:06,347
คำตอบสั้น ๆ คือ ไม่ได้พังทันที
แต่ความร้อนคือตัวการ
3
00:00:06,347 --> 00:00:09,000
เปิดโหมดถนอมแบต
ในตั้งค่าแบตเตอรี่