Roda o ffprobe em cada vídeo da pasta e devolve contêiner, codecs e cada faixa de legenda embutida, classificada por traduzibilidade. Nada é gravado em disco — o relatório vive na tela, e o TXT só sai se você clicar em Exportar.

1. subtitles
   Legenda de TEXTO (ASS, SSA, SRT, WebVTT, MOV_TEXT) Extraível e traduzível. É o caminho normal: segue para a 1.2. não escreve nada
2. image
   Legenda BITMAP (PGS, VobSub, DVB) É imagem, não texto. Exige OCR, que este projeto não faz — saber disso antes evita gastar uma noite tentando. não escreve nada

warning O sincronismo aqui não é diagnóstico. O ffprobe só devolve metadados, e a duração da faixa costuma ser um valor de enchimento igual à do vídeo. Atraso constante ou legenda de outro release só se confirma olhando os tempos dos eventos da própria legenda — o que esta tela não faz.

Tira as faixas de legenda de dentro do vídeo e as grava como arquivos soltos. A ferramenta muda conforme o contêiner, e você não precisa escolher.

1. movie
   Contêiner .mkv / .webm — MKVToolNix Identifica as faixas com mkvmerge --identify e extrai com mkvextract. É o caminho fiel: a faixa sai como estava dentro do arquivo. grava arquivos novos exige MKVToolNix instalado
2. theaters
   Demais contêineres (.mp4, .mov, .avi, .ts, .m2ts, .flv, .wmv) — ffmpeg Usa ffprobe para achar a faixa e ffmpeg -map para extrair. grava arquivos novos exige ffmpeg instalado

folder_off A pasta de saída é PLANA — ela não repete a árvore de subpastas. Se a varredura achar dois vídeos com o mesmo nome em temporadas diferentes (Season01/Episodio01.mkv e Season02/Episodio01.mkv), o segundo sobrescreve a legenda do primeiro. Extraia temporada por temporada, em pastas de saída separadas.

Traduz cada fala do .ass com o LLM rodando na sua máquina (LM Studio) e a lore da obra. O que já foi traduzido antes vem do cache e não vai ao modelo de novo — rodar duas vezes na mesma pasta custa quase nada.

1. shield
   As tags do ASS são mascaradas antes de o modelo ver Cada {\i1}, {\pos} e a quebra \N viram marcador e voltam no lugar. É o que impede o modelo de comer a tipografia da legenda. grava o .ass traduzido LM Studio local precisa do LM Studio no ar
2. fingerprint
   O cache carimba de ONDE veio cada tradução Modelo, idiomas, lore e o hash do prompt ficam gravados junto. Mudou a lore, muda o hash: aquela obra é retraduzida do zero em vez de reusar o que a lore antiga produziu. grava o cache da obra
3. policy
   Três defeitos são recusados sozinhos Fala que voltou igual ao inglês, resposta em que o modelo conversa em vez de traduzir e resíduo do original não entram na legenda — viram pendência. não publica o que não passou

inventory A legenda só é reescrita no fim, com o arquivo inteiro pronto. Sair pelo botão ou uma queda do LM Studio no meio deixa no cache o que já foi traduzido — a próxima execução recomeça de onde parou. Só o processo morto à força (falta de energia, encerrado pelo Gerenciador de Tarefas) perde o episódio em curso; os episódios anteriores já estão gravados.

É o caminho do acabei de baixar e quero ver como fica. Não pede obra — e por isso não aplica terminologia nenhuma.

1. person_off
   Nome próprio fica desprotegido Sem lista de termos da obra, nada impede um personagem chamado Sky virar Céu. O prompt pede para manter — pedido não é garantia. LM Studio local precisa do LM Studio no ar
2. folder_special
   A saída vai para pasta separada Grava em traducao_ptbr_sem_lore, e não na definitiva. Quando você escrever a lore de verdade, a 2.1 retraduz do zero — a proveniência divergiu e o cache desta execução é descartado sozinho. grava em pasta própria não toca a tradução definitiva
3. verified_user
   O que continua protegido mesmo sem lore Tags do ASS, detecção de alucinação e de meta-resposta, identificadores numéricos, resíduo em inglês e eco do original. Sem lore não significa sem guarda. as guardas de qualidade seguem valendo

warning Serve para ver, não para arquivar. Se a obra já tem lore escrita, use a 2.1 — esta tela desperdiça a proteção que alguém já escreveu.

Os três passos agem sobre o alvo escolhido acima e cada um gera backup antes de escrever. Fora de ordem eles ainda funcionam, mas rendem menos: o Google só preenche o que a limpeza esvaziou.

1. 1
   Limpar falhas do cache Invalida fallbacks e respostas defeituosas para que voltem à fila. Nomes e termos autorizados pela lore são preservados. escreve no cache
   delete_sweep Limpar falhas
2. 2
   Preencher lacunas via Google Envia ao Google Translate somente as falas que ficaram vazias ou inválidas. É contingência online, não o tradutor principal. escreve no cache precisa de internet
   Preencher via Google
3. 3
   Revisar concordância Gênero, pronomes, artigos e tratamentos nas falas suspeitas, com o LLM local e a lore registrada em cada arquivo. escreve no cache LLM local
   Revisar concordância

As duas leem e gravam os próprios arquivos .ass — não o cache. Cada arquivo tocado ganha backup em backups/revisao-legendas/ antes da escrita, e a primeira cópia da sessão nunca é sobrescrita.

1. psychology
   1 — Traduzir o que faltou (LLM local + dicionários) É esta que você roda. Acha as falas que ficaram em inglês e as traduz com o modelo local, que conhece a lore. Os dicionários ajustam a proposta que volta, e toda proposta passa por um portão que a descarta quando não melhora a legenda. Quando o modelo não resolve, a fala fica pendente — o Google não entra aqui, para não re-traduzir por cima do que já estava certo. Para o Google, use o botão 2. grava nos .ass LLM local sem Google
   Traduzir o que faltou
2. language
   2 — Só o Google (quando o LLM está desligado) A passada do Google, isolada — não passa pelo LLM local. Rode-a quando o LM Studio não estiver no ar. Ela re-traduz o inglês inteiro, então numa fala parcialmente traduzida substitui o que já estava certo — por isso é escolha explícita, não a continuação do botão 1. E fala com tag inline ({\i1}…{\i0}) costuma voltar como TAG_CORROMPIDA e ficar pendente — medido no Guilty Crown: 5 falas que a opção 1 resolveu. grava nos .ass precisa de internet
   Só o Google play_arrow

lyrics A varredura pega todos os estilos, inclusive as letras de abertura e encerramento. Se a legenda tem uma faixa de música em inglês (estilo Song ENG), ela será tratada como inglês residual e traduzida. Confira o relatório antes de dar a rodada por boa.

Põe o .ass original ao lado do traduzido e devolve ao traduzido a estrutura, os tempos, os estilos e as tags da original. A original nunca é reescrita — ela é só a referência.

1. rule
   Correção estrutural — sem LLM, sem internet É determinística: compara evento a evento e conserta o que se desalinhou. Sem obra escolhida, é só isto que roda, e é o caminho seguro. grava só o traduzido não usa LLM
2. psychology
   Correção por LLM — só quando você escolhe a obra Com a obra informada, as falas que ainda parecem quebradas depois do conserto estrutural podem ir ao modelo local. É camada extra e opcional, não o motor. grava só o traduzido LM Studio local precisa do LM Studio no ar

info Sem obra escolhida a operação é inteiramente determinística. Escolher a obra liga a segunda camada — e só ela depende do LM Studio estar no ar.

Junta o vídeo original com a legenda já revisada num .mkv novo, via mkvmerge. Vídeo e áudio passam sem recodificar — não há perda de qualidade e não demora como uma conversão.

1. build
   Gera em temporário, confere, e só então publica O arquivo nasce com nome temporário; o mkvmerge -J confere se vídeo, áudio e a legenda PT-BR estão lá; só depois ele vira o arquivo final. Uma falha no meio deixa o temporário para trás e não toca no seu vídeo. cria .mkv novo não sobrescreve o original exige MKVToolNix instalado
2. schedule
   Sincronismo manual (offset em ms) O valor vai como --sync 0:<ms> e desloca linearmente todos os tempos da legenda. Serve para atraso constante; não corrige legenda de outro release, onde o descompasso varia ao longo do episódio. deixe 0 se não houver atraso

folder_open O MKV final vai para mkv_final_ptbr, dentro da pasta de vídeos, a menos que você escolha outra pasta no campo de destino. Em nenhum dos dois casos o vídeo original é tocado, e destino que já existe é preservado, não sobrescrito.