Pular para o conteúdo
SubDrive Baixar

SubDrive CLI

O SubDrive CLI (arquivo SubDrive-CLI, ou SubDrive-CLI.exe no Windows) é o programa de computador que acompanha o pacote SubDrive. Ele prepara o pendrive e deixa as legendas do jeito que o player aceita. Roda no Windows, no macOS e no Linux, sem instalar nada, nem Java.

Há dois jeitos de usar. O menu atende quase todo mundo. Os comandos de terminal fazem as mesmas coisas e servem para quem quer rapidez ou automatizar.

Pelo terminal

Abra um terminal na pasta do SubDrive CLI e use:

Windows:        .\SubDrive-CLI.exe comando opções
macOS e Linux:  ./SubDrive-CLI comando opções

Nos exemplos abaixo aparece só SubDrive-CLI; no seu computador, escreva como acima. Coloque entre aspas os nomes de arquivo com espaço. Sem nenhum comando, o programa abre o menu.

Cada comando e cada opção têm um nome em português e outro em inglês, e os dois funcionam: verificar é o mesmo que check, e --mostrar é o mesmo que --show. Aqui aparece primeiro o nome em português.

Opção geralO que faz
--ajuda (--help)Mostra a ajuda. Também funciona depois de um comando, como em SubDrive-CLI corrigir --ajuda.
--versao (--version)Mostra a versão do SubDrive CLI.
--sem-emoji (--no-emoji)Usa texto simples no lugar dos emojis, para terminais que não os mostram.
--sem-cor (--no-color)Tira as cores das mensagens.

verificar (check)

SubDrive-CLI verificar "Filme.srt"
SubDrive-CLI verificar legendas/

Confere um ou mais arquivos, ou todos os .srt e .sup de uma pasta. Para cada um, diz se está pronto para o player. Se não estiver, diz o motivo e como resolver.

--mostrar (--show)Lista cada fala com problema, com o horário dela no filme.

Use antes de copiar uma legenda nova para o pendrive. As regras completas estão em SubDrive-CLI regras, explicadas mais abaixo.

corrigir (fix)

SubDrive-CLI corrigir "Filme.srt"
SubDrive-CLI corrigir "Filme.srt" --mostrar
SubDrive-CLI corrigir "Filme.srt" --saida "Filme corrigido"

Cria uma cópia corrigida de um .srt e deixa o original como estava. A cópia ganha o nome Filme_2.srt, ou Filme_3.srt se a _2 já existir. Ela é verificada de novo antes de ser gravada. O que a correção faz:

  • converte o texto para UTF-8, para os acentos aparecerem certos;
  • conserta acentos quebrados, como é no lugar de é;
  • troca símbolos que o player não mostra pelo equivalente simples, como as aspas curvas e o travessão, e tira emojis e ♪;
  • tira marcações que o player não entende, como cor e posição, e mantém o itálico;
  • refaz a divisão das linhas que passam de 2 por fala ou de 64 letras;
  • renumera as falas e corrige tempos e falas sobrepostas.
--saida nome (--output)Escolhe o nome do arquivo novo.
--mostrar (--show)Mostra cada mudança, com o antes e o depois.
--remover-creditos (--remove-credits)Também tira as falas que parecem créditos ou propaganda, como "Legenda por…". O verificar avisa quando encontra falas assim.

Se sobrar algo que não dá para corrigir sozinho, o SubDrive CLI diz em qual fala está, para você arrumar à mão.

pgs

SubDrive-CLI pgs "Filme.srt"
SubDrive-CLI pgs "Filme.srt" --cor amarelo-escuro --fonte inter --negrito

Desenha cada fala do SRT numa imagem e grava um PGS (.sup) de 1080p. Use quando quiser um visual que o player não faz sozinho, como uma fonte com contorno mais grosso, ou para guardar a legenda já no estilo que você gosta. O arquivo novo leva a cor no nome, como Filme.dark-yellow.sup, e o painel do player mostra o nome dessa cor.

--cor (--color)A cor da letra. Padrão: branco suave. Aceita o nome em português ou em inglês: branco, branco-suave, cinza-claro, cinza, creme, amarelo, amarelo-claro, amarelo-escuro, ambar, laranja, verde, verde-claro, verde-limao, ciano, ciano-claro, azul-claro, lilas, rosa, magenta e vermelho-claro.
--fonte (--font)A fonte. Padrão: roboto. Opções: roboto, inter, arimo, notosans, opensans, sourcesans3, lato, atkinson e dejavusans.
--negrito (--bold)Letras em negrito.
--tamanho (--size)Tamanho da letra em pixels, numa tela de 1080p. Padrão: 48. Aceita de 30 a 72.
--contorno (--outline)Espessura do contorno preto em pixels. Padrão: 2. Aceita de 0 a 6.
--saida (--output)Escolhe o nome do arquivo novo.

O SRT precisa passar na verificação antes. Se não passar, use o corrigir primeiro. Com tamanhos grandes, uma fala muito longa pode não caber nos limites de imagem do player; o SubDrive CLI diz qual fala é, e um tamanho menor resolve.

sincronizar (sync)

SubDrive-CLI sincronizar "legendas/Filme.srt"

Lê os pontos de sincronia que você criou no player, na pasta sincronia do pendrive, e grava uma legenda nova com os tempos já acertados, como Filme_2.srt. Funciona com SRT e com PGS. A original fica como estava. Veja como funciona a sincronia.

--pontos (--points)Usa outro arquivo de pontos. Padrão: sincronia/<nome da legenda>.txt, ao lado da pasta legendas.
--saida (--output)Escolhe o nome do arquivo novo.

pendrives (drives)

SubDrive-CLI pendrives

Lista os pendrives conectados e diz se o player consegue ler cada um. O player só lê pendrives em FAT32, com uma partição e esquema MBR. Se o seu estiver diferente, o SubDrive CLI explica como formatar no seu sistema. Ele nunca formata nada sozinho.

preparar (prepare)

SubDrive-CLI preparar
SubDrive-CLI preparar --pendrive E:\ --ejetar
SubDrive-CLI preparar --pendrive /Volumes/PENDRIVE --firmware UPDATE_UB450P_UB150P_V113.zip

Instala ou atualiza o pacote SubDrive no pendrive. Antes de gravar, mostra o que vai fazer e pede confirmação. Na primeira vez, baixa o firmware oficial do site da Panasonic, confere o arquivo e guarda numa pasta firmware ao lado do programa, para não baixar de novo. Com ele, monta o programa do player no seu computador e confere cada parte com a versão testada.

O pendrive fica com as pastas legendas, sincronia, relatorios e fontes já criadas. O player não consegue criar pastas sozinho, então é o SubDrive CLI que faz isso. Suas legendas, os pontos de sincronia, as preferências e os relatórios que já estão no pendrive nunca são apagados.

--pendrive (--drive)O pendrive, como E:\ no Windows ou /Volumes/NOME no Mac. Só é preciso quando há mais de um conectado.
--pacote (--package)A pasta do pacote SubDrive. Padrão: a pasta pacote ao lado do programa.
--firmwareUsa um ZIP do firmware oficial que você já baixou, em vez de baixar.
--substituir-legendas (--replace-subtitles)Troca as legendas do pendrive que tenham o mesmo nome de uma que vem no pacote. Sem esta opção, as suas ficam.
--sim (--yes)Não pede confirmação.
--ejetar (--eject)Ejeta o pendrive no fim, quando tudo deu certo.

atualizar (update)

SubDrive-CLI atualizar
SubDrive-CLI atualizar --verificar
SubDrive-CLI atualizar --beta sim

Procura no GitHub uma versão mais nova do SubDrive CLI e do pacote SubDrive e instala, se você confirmar. Só procura quando você pede. Antes de instalar, confere a assinatura digital do arquivo baixado.

--verificar (--check)Só diz se existe versão nova, sem instalar.
--beta sim ou nao (on ou off)Liga ou desliga o recebimento de versões de teste. A escolha fica guardada ao lado do programa.
--sim (--yes)Não pede confirmação.

Depois de atualizar, prepare o pendrive de novo para levar a versão nova para o player.

regras (rules)

SubDrive-CLI regras

Lista as regras que uma legenda SRT precisa seguir para o player aceitar:

  • texto em UTF-8, senão os acentos aparecem errados;
  • só letras latinas, sem emoji, ♪, travessão ou aspas curvas, porque o player não tem essas letras;
  • até 2 linhas por fala, com até 64 letras cada, porque mais que isso não cabe na tela;
  • só itálico como marcação, porque o player recusa as outras;
  • falas numeradas em ordem e tempos no formato 00:01:02,500 --> 00:01:04,000;
  • cada fala com 0,2 s a 60 s, e uma fala só começando depois que a anterior termina;
  • até 4 horas, 3.000 falas e 256 KB, por causa da memória do player;
  • nome de arquivo simples, terminado em .srt ou .sup.

Códigos de saída

Para quem usa o SubDrive CLI em scripts: 0 quer dizer que deu tudo certo, 1 que algo precisa da sua atenção (uma legenda com problema, por exemplo) e 2 que o comando foi usado de um jeito errado, como um arquivo que não existe.