Guia de legendas

    Como nomear arquivos de legenda para o Plex, Jellyfin, Kodi e VLC encontrarem

    Você baixou um arquivo SRT, colocou ao lado do filme e o menu de legendas continua mostrando “Nenhuma”. Ou ela aparece como “Desconhecido”, ou as legendas forçadas dos diálogos alienígenas nunca são ativadas. Em nove de cada dez casos, o culpado é o nome do arquivo, não o arquivo em si.

    Este guia traz um único padrão de nomes que funciona no Plex, Jellyfin, Emby, Kodi, Infuse e VLC: a regra básica, os códigos de idioma, os indicadores forced, SDH e default, os formatos, as pastas Subs e as particularidades de cada player, conferidas na documentação oficial de cada um. No final, há um checklist para problemas de codificação, idioma errado e legendas fora de sincronia.

    Atualizado em 22 de novembro de 202612 min de leitura

    A regra básica: o mesmo nome do vídeo

    Todo player e servidor de mídia associa uma legenda externa a um vídeo pelo nome do arquivo. A legenda precisa começar com o nome exato do arquivo de vídeo, sem a extensão, seguido opcionalmente de um código de idioma e de indicadores, e depois a extensão da legenda.

    Um filme, legendas em dois idiomas
    Movies/
    └── Dune (2021)/
        ├── Dune (2021).mkv
        ├── Dune (2021).en.srt
        └── Dune (2021).fr.srt

    O padrão é sempre: nome do vídeo + .idioma + .indicadores + .extensão. Para um episódio de série a ideia é a mesma, com o nome completo do arquivo do episódio como prefixo:

    Legendas de um episódio de série
    TV Shows/
    └── Breaking Bad/
        └── Season 01/
            ├── Breaking Bad - S01E01 - Pilot.mkv
            ├── Breaking Bad - S01E01 - Pilot.en.srt
            └── Breaking Bad - S01E01 - Pilot.es.srt

    Três detalhes pegam muita gente:

    • Use pontos como separadores. O Jellyfin só aceita um ponto logo depois do nome do vídeo, então Dune (2021)-en.srt é ignorado nele, mesmo que o Kodi e o Infuse leiam esse nome. Pontos funcionam em todo lugar.
    • Copie o nome completo do vídeo, com o ano e todas as tags. Se o vídeo é Dune.2021.2160p.WEB-DL.mkv, uma legenda chamada Dune (2021).en.srt não bate. Renomeie um dos dois para que os prefixos fiquem idênticos.
    • Mostre as extensões dos arquivos. O Windows esconde as extensões por padrão, e é assim que se acaba com Dune (2021).en.srt.txt ou Dune (2021).mkv.en.srt. No Explorador de Arquivos, ative Exibir > Mostrar > Extensões de nomes de arquivos.

    Se você renomear seus vídeos, renomeie as legendas na mesma hora. Uma legenda que ficou com o nome antigo da release é o motivo mais comum para legendas sumirem depois de uma faxina na biblioteca.

    Códigos de idioma: ISO 639-1 e ISO 639-2

    O idioma vem logo depois do nome do vídeo. O Plex documenta dois padrões, e todos os outros players desta página também aceitam: ISO 639-1 (duas letras) e ISO 639-2/B (três letras). Os dois servem: escolha um e mantenha o mesmo em tudo.

    IdiomaISO 639-1ISO 639-2/BArquivo de exemplo
    InglêsenengDune (2021).en.srt
    FrancêsfrfreDune (2021).fre.srt
    EspanholesspaDune (2021).es.srt
    AlemãodegerDune (2021).de.srt
    PortuguêsptporDune (2021).pt.srt
    ItalianoititaDune (2021).it.srt
    HolandêsnldutDune (2021).nl.srt
    PolonêsplpolDune (2021).pl.srt
    JaponêsjajpnDune (2021).ja.srt
    ChinêszhchiDune (2021).zh.srt

    Alguns idiomas têm dois códigos de três letras: um código bibliográfico “B” e um código terminológico “T” (fre/fra, ger/deu, dut/nld, chi/zho). O Plex cita a lista B, então, se você usar três letras, o código B é a escolha segura. Os códigos de duas letras evitam essa dúvida por completo.

    Variantes regionais

    O suporte a variantes regionais, como português do Brasil ou chinês tradicional, é menos uniforme. O Emby documenta códigos como zh-CN e zh-TW, o próprio exemplo do Jellyfin usa en_us, e o Kodi 22 aceita tags BCP 47 trocando o hífen por um sublinhado (zh_yue). O artigo do Plex só documenta os códigos de duas e três letras. Se você precisa de duas variantes do mesmo idioma (por exemplo, português do Brasil e de Portugal), teste no seu próprio servidor antes de renomear uma biblioteca inteira.

    Nomes de idioma em vez de códigos

    O Kodi também aceita o nome do idioma em inglês (Dune (2021).English.srt, ou Dune (2021).Portuguese.srt e não Português), e os exemplos do Emby incluem spanish. O Plex não documenta nomes, e é por isso que um arquivo assim costuma aparecer como “Desconhecido” no Plex. Os códigos são a opção que funciona em qualquer lugar.

    Indicadores forced, SDH, CC e default

    Os indicadores vêm depois do código de idioma, separados por pontos. Eles dizem ao servidor que tipo de legenda é aquele arquivo, para que ele possa escolher a certa automaticamente.

    Legendas forçadas

    Legendas forçadas cobrem só falas em outro idioma, placas ou textos na tela: os diálogos em chakobsa de Duna, as ligações em espanhol de Breaking Bad. Elas foram feitas para aparecer mesmo com as legendas desligadas. Adicione forced:

    Dune (2021).en.forced.srt
    Breaking Bad - S01E01 - Pilot.en.forced.srt

    O Jellyfin e o Emby também aceitam foreign como sinônimo. O Kodi lê forced em maiúsculas ou minúsculas, e faz isso desde a versão 13.

    SDH, CC e legendas para surdos

    Legendas para surdos e ensurdecidos (SDH, na sigla em inglês) incluem indicações de som como [telefone tocando] e o nome de quem está falando. Marque essas legendas para poder diferenciá-las das comuns:

    Dune (2021).en.sdh.srt
    Dune (2021).en.cc.srt

    O Plex lê sdh e cc (é preciso ter o Plex Media Server 1.20.3.3401 ou mais recente e o agente Plex Movie atual, não o legado). O Jellyfin 10.9 e versões posteriores leem sdh, cc e hi. O Emby documenta sdh.

    No Jellyfin, hi sozinho significa híndi. Dune (2021).hi.srt é uma legenda em híndi, enquanto Dune (2021).en.hi.srt é uma legenda em inglês para surdos. Use sdh para evitar a ambiguidade.

    Default

    O indicador default pede ao servidor que selecione essa faixa automaticamente. O Jellyfin, o Emby e o Kodi leem esse indicador. O Plex não o documenta e usa as configurações de legenda da sua conta.

    Dune (2021).en.default.srt

    Qual indicador funciona em cada player

    IndicadorPlexJellyfinEmbyKodi 21InfuseVLC
    forcedSimSim (também foreign)Sim (também foreign)SimNão documentadoNão
    sdhSimSimSimFica no nome da faixaNão documentadoNão
    ccSimSimNão documentadoFica no nome da faixaNão documentadoNão
    hiNãoSim, junto com um idiomaNão documentadoFica no nome da faixaNão documentadoNão
    defaultNão documentadoSimSimSimNão documentadoNão

    O Kodi 21 só lê forced e default como indicadores. Qualquer outra palavra, como sdh, vai parar no nome exibido no menu de legendas, o que ainda permite escolher o arquivo certo manualmente. O VLC ignora os indicadores por completo: ele simplesmente lista todos os arquivos que batem com o vídeo.

    Várias legendas no mesmo idioma

    Você pode manter uma legenda comum, uma forçada e uma SDH lado a lado, desde que cada nome seja diferente:

    Um conjunto completo de legendas
    Movies/
    └── Dune (2021)/
        ├── Dune (2021).mkv
        ├── Dune (2021).en.srt
        ├── Dune (2021).en.forced.srt
        ├── Dune (2021).en.sdh.srt
        ├── Dune (2021).fr.srt
        └── Dune (2021).fr.forced.srt

    O que não dá para fazer em todos os players é manter dois arquivos simples em inglês, como a tradução do cinema e uma faixa de comentários. Cada servidor trata palavras extras de um jeito:

    • Jellyfin: qualquer texto que não seja um idioma nem um indicador vira o título da faixa. Dune (2021).Commentary.en.srt aparece como uma faixa em inglês chamada Commentary.
    • Emby: coloque um rótulo entre parênteses, como na documentação dele: Dune (2021).English(Commentary).srt.
    • Kodi: as palavras que sobram viram parte do nome da faixa, então Dune (2021).en.Commentary.srt funciona.
    • Plex: só entende o idioma e os indicadores documentados. Um membro da equipe do Plex explicou que um arquivo com tags que ele não reconhece pode ser ignorado sem aviso, e quando dois arquivos têm o mesmo idioma e os mesmos indicadores, o Plex não tem como diferenciá-los. No Plex, mantenha um arquivo por combinação de idioma e indicadores.

    Formatos de legenda: SRT, ASS, VTT, SUB/IDX e SUP

    A extensão importa tanto quanto o nome. Formatos de texto são leves, fáceis de editar e funcionam em quase todo lugar. Formatos de imagem são imagens do texto extraídas de DVDs e Blu-rays.

    FormatoExtensãoTipoBom saber
    SubRip.srtTextoA escolha universal. Funciona em todos os players desta página e é o que o OpenSubtitles mais oferece.
    SubStation Alpha.ass / .ssaTexto com estiloFontes, cores e posições, muito comum em animes. O Plex lista como totalmente compatível, mas o estilo não aparece igual em todos os apps.
    WebVTT.vttTextoO padrão da web. Compatível com Plex, Jellyfin, Emby e Kodi 20 ou mais recente.
    VobSub.sub + .idxImagem (DVD)Dois arquivos que precisam ter o mesmo nome base, ambos ao lado do vídeo: Dune (2021).en.idx e Dune (2021).en.sub.
    PGS.supImagem (Blu-ray)O Jellyfin e o Kodi leem arquivos .sup externos. Em muitos apps do Plex, legendas de imagem forçam uma transcodificação para gravá-las na imagem.
    SAMI.smiTextoFormato mais antigo, ainda na lista de formatos totalmente compatíveis do Plex.

    O Plex informa que SRT, SMI, SSA/ASS e VTT são totalmente compatíveis em todos os apps, enquanto VobSub e PGS podem exigir a transcodificação do vídeo para gravar as legendas na imagem. O Infuse avisa que AirPlay e Google Cast só aceitam legendas em texto. Se você faz streaming para TVs ou celulares, o SRT poupa muito trabalho do servidor.

    Precisa converter um .sup ou um .sub/.idx para SRT? Ferramentas gratuitas como o Subtitle Edit fazem OCR em legendas de imagem. Revise o resultado: o OCR confunde l, I e 1 com mais frequência do que você imagina.

    Legendas em uma pasta Subs

    Muitas releases vêm com uma pasta Subs. Se o seu player olha dentro dela depende do software, e os arquivos lá dentro ainda precisam ter o nome certo.

    PlayerLê uma subpasta?Nomes de pasta
    PlexSim, servidor 1.41.0 ou mais recente com o agente Plex Movie ou Plex SeriesSubs ou Subtitles, na mesma pasta do vídeo
    JellyfinNão, só a pasta do vídeoNão se aplica
    EmbyNão documentadoMantenha os arquivos ao lado do vídeo
    KodiSimsubs, subtitles, sub, subtitle, vobsub, vobsubs, além de uma pasta personalizada que você pode definir
    InfuseNão documentadoA Firecore recomenda manter o arquivo na mesma pasta
    VLCSimsubs e subtitles por padrão, editável nas preferências avançadas

    Para uma temporada, o Plex espera a pasta Subs dentro da pasta da temporada, ao lado dos episódios:

    Pasta Subs no Plex 1.41+
    TV Shows/
    └── Breaking Bad/
        └── Season 01/
            ├── Breaking Bad - S01E01 - Pilot.mkv
            ├── Breaking Bad - S01E02 - Cat's in the Bag....mkv
            └── Subs/
                ├── Breaking Bad - S01E01 - Pilot.en.srt
                └── Breaking Bad - S01E02 - Cat's in the Bag....en.srt

    Alguns grupos de release colocam na pasta arquivos como Subs/2_English.srt ou Subs/Dune.2021.1080p/3_French.srt. Nenhum dos players desta página consegue associar esses nomes ao vídeo. Mova os arquivos para o lado do vídeo e renomeie com o nome do vídeo mais um código de idioma.

    Como o Jellyfin ignora subpastas e o Emby e o Infuse só documentam arquivos ao lado do vídeo, a estrutura que funciona em todo lugar é a mais simples: legendas na mesma pasta do vídeo.

    Como cada player encontra as legendas

    Plex

    O padrão do Plex é Movie_Name (Release Date).[Language_Code].ext para filmes e Show_Name SxxEyy.[Language_Code].ext para episódios, com forced, sdh ou cc antes da extensão. Os agentes atuais Plex Movie e Plex TV Series sempre procuram legendas locais. Com um agente legado, abra as configurações (Settings), selecione seu servidor, vá em Agents e confira se Local Media Assets está marcado.

    O Plex só percebe uma legenda nova depois que o item é atualizado: abra o filme ou o episódio, clique no menu de três pontos e escolha Refresh Metadata (nome da opção na interface em inglês). Qual legenda começa automaticamente depende das configurações de idioma da sua conta (modo de legenda como “Shown with foreign audio” ou “Always enabled”). Mais regras de pastas estão no nosso guia de nomes do Plex.

    Jellyfin

    O Jellyfin lê os arquivos da pasta do vídeo cujo nome começa com o nome do vídeo seguido de um ponto. Cada campo extra é um idioma, um indicador (default, forced/foreign, sdh/cc/hi) ou texto livre usado como título da faixa. Ele aceita .srt, .ass, .ssa, .vtt, .sub, .sup, .smi e outros. Depois de adicionar arquivos, use o menu do item, Refresh metadata, e depois Scan for new and updated files (nomes da interface em inglês). A seleção automática segue o modo de legenda do usuário (Default, Smart, Only forced, Always, None) nas configurações de reprodução. Veja o guia de nomes do Jellyfin para as pastas de filmes e séries.

    Emby

    A regra do Emby é “o mesmo nome de arquivo do filme, exceto a extensão”: Home Alone (1990).spa.srt, com .default, .forced (ou .foreign) e .sdh antes da extensão. O Emby documenta ass, srt, ssa, sub/idx e vtt. Atualize os metadados do item depois de adicionar arquivos.

    Kodi

    O Kodi procura legendas externas quando a reprodução começa, então não é preciso escanear a biblioteca. Ele olha na pasta do vídeo, nas subpastas comuns listadas acima e em uma pasta personalizada opcional (na interface em inglês: Settings > Player > Subtitles > Subtitle storage location em Custom location, depois Custom subtitle folder). O idioma pode ser um código ou um nome em inglês, e o Kodi aceita pontos, espaços ou hifens como separadores: Dune (2021).en.forced.srt e Dune (2021)-English-Forced.srt funcionam. As regras de pastas da biblioteca em si estão no guia de nomes do Kodi.

    Infuse

    A documentação da Firecore pede para nomear a legenda igual ao vídeo e mantê-la na mesma pasta, com um sufixo de idioma para cada idioma extra (o exemplo deles: Inception-2010-en.srt). O estilo com pontos usado pelo Plex e pelo Jellyfin é a melhor escolha se os mesmos arquivos também forem servidos pelo Jellyfin. Legendas locais não funcionam em conexões UPnP ou DLNA, e quando o Infuse navega por um servidor Plex, Jellyfin ou Emby, ele pega as legendas desse servidor, então valem as regras de nomes do servidor.

    VLC

    O VLC é o mais tolerante. A detecção automática de legendas (Autodetect subtitle files na interface em inglês) vem ativada por padrão (Ferramentas > Preferências > Mostrar configurações: Tudo > Vídeo > Legendas / OSD): ele carrega legendas cujo nome começa com o nome do vídeo, mesmo com texto extra depois, e também procura nas pastas subs e subtitles. Ele ignora os indicadores e lista tudo o que bate, então o VLC é um bom teste rápido: se nem o VLC enxerga o seu arquivo, o problema está no nome ou no local. Você sempre pode carregar uma legenda manualmente em Legenda > Adicionar arquivo de legenda.

    Solução de problemas: legenda não aparece, idioma errado, caracteres estranhos ou fora de sincronia

    Legendas não aparecem no Plex, Jellyfin ou Kodi

    1. Compare os nomes caractere por caractere. A legenda precisa começar com o nome exato do vídeo, incluindo o ano, os espaços, os colchetes e as tags da release.
    2. Confira a extensão real com as extensões visíveis. .srt.txt não é legenda.
    3. Verifique se o arquivo está na mesma pasta do vídeo (ou em uma pasta Subs, só no Plex 1.41+, Kodi e VLC).
    4. Tire as palavras que o servidor não conhece. No Plex, deixe só o idioma e forced, sdh ou cc.
    5. Atualize o item (Plex: Refresh Metadata; Jellyfin e Emby: Refresh metadata com busca de arquivos novos). O Kodi e o VLC leem as legendas na hora da reprodução.
    6. Confira se o modo de legenda da sua conta não está como somente manual ou desligado.

    Idioma errado ou “Desconhecido”

    “Desconhecido” (Unknown) quase sempre quer dizer que o servidor não encontrou um código que entenda: o nome do idioma em vez de um código no Plex, um erro de digitação como .eng1.srt ou um código colocado depois de texto livre. Use códigos ISO de duas ou três letras logo depois do nome do vídeo. No Jellyfin, lembre que hi sozinho é híndi. Se o servidor identifica o arquivo direitinho mas mostra o texto errado, a própria legenda está em outro idioma: baixe outra.

    Caracteres estranhos (é, ’, quadradinhos)

    É um problema de codificação, típico de legendas antigas salvas em Windows-1252 ou outra página de código antiga. O Plex recomenda salvar legendas de texto em UTF-8. Para converter, abra o .srt em um editor de texto (Bloco de Notas no Windows, TextEdit no Mac, VS Code ou Subtitle Edit em qualquer sistema), escolha Salvar como e selecione UTF-8 como codificação. No Kodi você também pode mudar o conjunto de caracteres (Character set, em Settings > Player > Subtitles), e no VLC a codificação padrão (Default encoding, em Legendas / OSD), mas converter o arquivo resolve para todos os players de uma vez.

    Legendas fora de sincronia

    • Atraso constante (sempre dois segundos adiantada): a legenda foi feita para uma release com outra abertura ou outro logo de estúdio. Desloque todos os tempos. As teclas G e H do VLC movem as legendas em passos de 50 ms, o Kodi tem um ajuste de atraso de legenda no menu de reprodução e o Subtitle Edit pode salvar o ajuste de vez.
    • Desvio progressivo (certa no começo, dez segundos fora no final): taxa de quadros diferente, geralmente 23,976 contra 25 fps. Use a conversão de taxa de quadros do Subtitle Edit em vez de um atraso.
    • Fora de sincronia depois de uma cena: a legenda é de outra versão do filme (versão de cinema contra versão estendida). Nenhum atraso resolve: procure uma legenda feita para a sua versão exata.

    A solução mais rápida para problemas de sincronia costuma ser uma legenda mais compatível. Legendas enviadas para a mesma release do seu vídeo (mesma fonte, mesmo grupo e mesma duração) têm muito mais chance de bater certinho.

    Legendas com o nome certo usando o RenameFlow

    Nomear legendas na mão funciona para um filme. Para uma temporada inteira fica cansativo, e um único caractere errado significa uma faixa faltando.

    O RenameFlow é um app web que roda no Chrome, Edge ou Opera em um computador. O módulo Legendas busca legendas para os seus vídeos no OpenSubtitles e salva a que você escolher ao lado do vídeo, com o nome do vídeo e um código de idioma (por exemplo Dune (2021).pt.srt), que é a estrutura que todos os players desta página leem. No plano gratuito você tem 3 downloads de legendas por mês, e os planos pagos são ilimitados. O passo a passo está no nosso guia para baixar legendas.

    Vale a pena organizar os nomes dos vídeos antes. O RenameFlow renomeia os próprios arquivos de vídeo direto no seu disco (nada é enviado), com os presets Plex, Jellyfin, Kodi ou Simple, então as legendas que você baixar depois batem com os nomes finais. Lembre que o RenameFlow só renomeia arquivos: ele não cria nem move pastas, então as pastas Dune (2021) ou Season 01 ficam por sua conta. Os indicadores forced e SDH também são com você, se precisar deles.

    Baixe legendas que já vêm com o nome certo

    Renomeie seus vídeos com os presets de Plex, Jellyfin ou Kodi e depois baixe legendas do OpenSubtitles que ficam ao lado de cada vídeo com o nome correspondente. Grátis para começar, nada para instalar.

    Experimente o RenameFlow grátis

    Perguntas frequentes

    Qual é o jeito certo de nomear um arquivo de legenda?
    Use o nome exato do arquivo de vídeo, depois um código de idioma, depois os indicadores que quiser e por fim a extensão: Dune (2021).pt.srt, Dune (2021).pt.forced.srt ou Dune (2021).en.sdh.srt. Separe as partes com pontos e mantenha a legenda na mesma pasta do vídeo. Esse formato funciona no Plex, Jellyfin, Emby, Kodi, Infuse e VLC.
    Devo usar pt ou por no nome do arquivo SRT?
    Os dois funcionam. O Plex documenta os códigos ISO 639-1 de duas letras (pt) e os ISO 639-2/B de três letras (por), e o Jellyfin, o Emby e o Kodi também aceitam. Se usar três letras, prefira no Plex os códigos B como fre e ger (em vez de fra e deu). Seja qual for a escolha, mantenha o mesmo padrão na biblioteca inteira.
    Por que minhas legendas não aparecem no Plex?
    As causas mais comuns são um nome que não bate exatamente com o vídeo, uma extensão .txt escondida, uma palavra não reconhecida no nome ou uma legenda que o Plex ainda não escaneou. Corrija o nome e use Refresh Metadata no item. Com um agente legado, confira também se Local Media Assets está ativado em Settings > Agents.
    Como nomear legendas forçadas?
    Adicione forced depois do código de idioma: Dune (2021).pt.forced.srt. O Plex, o Jellyfin, o Emby e o Kodi reconhecem esse indicador, e o Jellyfin e o Emby também aceitam foreign. Legendas forçadas servem para falas em idioma estrangeiro e placas, e podem aparecer mesmo com as legendas comuns desligadas.
    Como nomear legendas SDH ou para surdos?
    Adicione sdh depois do código de idioma: Dune (2021).pt.sdh.srt. O Plex também aceita cc, e o Jellyfin aceita sdh, cc ou hi. Evite hi sozinho no Jellyfin, porque ele é lido como híndi.
    Por que as legendas não aparecem no Kodi?
    O Kodi precisa que o nome da legenda comece com o nome do vídeo e que o arquivo esteja na pasta do vídeo, em uma subpasta comum como Subs ou na pasta de legendas personalizada definida em Settings > Player > Subtitles. Confira também o idioma de legenda preferido: se estiver como somente forçadas, as legendas comuns existem mas não são ativadas automaticamente. Escolha a legenda no menu durante a reprodução.
    O Jellyfin lê legendas de uma pasta Subs?
    Não. O Jellyfin procura legendas externas na mesma pasta do arquivo de vídeo (e na própria pasta de metadados), não em subpastas. Mova os arquivos para o lado do vídeo e nomeie como Nome do vídeo.pt.srt.
    Como corrigir legendas fora de sincronia?
    Se o atraso é constante, desloque os tempos: teclas G e H do VLC, atraso de legenda do Kodi ou Subtitle Edit para salvar de vez. Se o atraso aumenta com o tempo, converta a taxa de quadros (muitas vezes de 23,976 para 25 fps). Se a legenda sai de sincronia depois de uma cena específica, ela é de outra versão do filme e você precisa de uma feita para a sua.