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.
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.
Movies/
└── Dune (2021)/
├── Dune (2021).mkv
├── Dune (2021).en.srt
└── Dune (2021).fr.srtO 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:
TV Shows/
└── Breaking Bad/
└── Season 01/
├── Breaking Bad - S01E01 - Pilot.mkv
├── Breaking Bad - S01E01 - Pilot.en.srt
└── Breaking Bad - S01E01 - Pilot.es.srtTrê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 chamadaDune (2021).en.srtnã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.txtouDune (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.
| Idioma | ISO 639-1 | ISO 639-2/B | Arquivo de exemplo |
|---|---|---|---|
| Inglês | en | eng | Dune (2021).en.srt |
| Francês | fr | fre | Dune (2021).fre.srt |
| Espanhol | es | spa | Dune (2021).es.srt |
| Alemão | de | ger | Dune (2021).de.srt |
| Português | pt | por | Dune (2021).pt.srt |
| Italiano | it | ita | Dune (2021).it.srt |
| Holandês | nl | dut | Dune (2021).nl.srt |
| Polonês | pl | pol | Dune (2021).pl.srt |
| Japonês | ja | jpn | Dune (2021).ja.srt |
| Chinês | zh | chi | Dune (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.srtO 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.srtO 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.srtQual indicador funciona em cada player
| Indicador | Plex | Jellyfin | Emby | Kodi 21 | Infuse | VLC |
|---|---|---|---|---|---|---|
| forced | Sim | Sim (também foreign) | Sim (também foreign) | Sim | Não documentado | Não |
| sdh | Sim | Sim | Sim | Fica no nome da faixa | Não documentado | Não |
| cc | Sim | Sim | Não documentado | Fica no nome da faixa | Não documentado | Não |
| hi | Não | Sim, junto com um idioma | Não documentado | Fica no nome da faixa | Não documentado | Não |
| default | Não documentado | Sim | Sim | Sim | Não documentado | Nã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:
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.srtO 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.srtaparece 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.srtfunciona. - 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.
| Formato | Extensão | Tipo | Bom saber |
|---|---|---|---|
| SubRip | .srt | Texto | A escolha universal. Funciona em todos os players desta página e é o que o OpenSubtitles mais oferece. |
| SubStation Alpha | .ass / .ssa | Texto com estilo | Fontes, 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 | .vtt | Texto | O padrão da web. Compatível com Plex, Jellyfin, Emby e Kodi 20 ou mais recente. |
| VobSub | .sub + .idx | Imagem (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 | .sup | Imagem (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 | .smi | Texto | Formato 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.
| Player | Lê uma subpasta? | Nomes de pasta |
|---|---|---|
| Plex | Sim, servidor 1.41.0 ou mais recente com o agente Plex Movie ou Plex Series | Subs ou Subtitles, na mesma pasta do vídeo |
| Jellyfin | Não, só a pasta do vídeo | Não se aplica |
| Emby | Não documentado | Mantenha os arquivos ao lado do vídeo |
| Kodi | Sim | subs, subtitles, sub, subtitle, vobsub, vobsubs, além de uma pasta personalizada que você pode definir |
| Infuse | Não documentado | A Firecore recomenda manter o arquivo na mesma pasta |
| VLC | Sim | subs 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:
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.srtAlguns 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
- 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.
- Confira a extensão real com as extensões visíveis.
.srt.txtnão é legenda. - Verifique se o arquivo está na mesma pasta do vídeo (ou em uma pasta Subs, só no Plex 1.41+, Kodi e VLC).
- Tire as palavras que o servidor não conhece. No Plex, deixe só o idioma e
forced,sdhoucc. - 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.
- 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