RenameFlow
    Cadastrar

    Guia de Nomenclatura Jellyfin: Filmes, Séries, Animes, Músicas e Migração do Plex (2026)

    O Jellyfin é mais flexível que o Plex com a nomenclatura — mas só até certo ponto. Acerte na estrutura e o scanner será rápido, preciso e gratuito para sempre. Se errar, você passará horas lutando contra itens "não identificados" que deveriam ter sido reconhecidos instantaneamente.

    Este guia é a referência prática para nomear arquivos de mídia no Jellyfin — todos os tipos de mídia, todas as exceções e o caminho de migração para quem vem do Plex. Os exemplos seguem a documentação do próprio Jellyfin e são verificados com o comportamento do Jellyfin 10.10+. Foco especial nos dois casos que complicam a vida dos usuários de Plex na migração: como o Jellyfin trata os especiais da temporada zero e como lida com animes sem um equivalente ao HAMA.

    Ao final, você saberá exatamente como estruturar uma biblioteca do Jellyfin que é escaneada corretamente na primeira vez — seja começando do zero, migrando do Plex ou organizando uma biblioteca que cresceu caoticamente por anos.

    Atualizado em 2026 Com referências cruzadas da documentação do Jellyfin 10.10+ Criado pela equipe por trás do RenameFlow ~11 min de leitura

    Pule o trabalho manual — deixe o RenameFlow cuidar dos padrões para você.

    Comece grátis

    Fundamentos da Nomenclatura no Jellyfin

    A arquitetura do scanner do Jellyfin é diferente da do Plex, e entender essa diferença evita a maior parte da frustração de "o Jellyfin não reconhece meus arquivos". A boa notícia: a maioria dos nomes compatíveis com o Plex funciona diretamente no Jellyfin. O problema: a flexibilidade do Jellyfin significa que você pode criar padrões de nomenclatura válidos que funcionam para uma biblioteca e falham em outra, dependendo dos provedores que você ativou.

    Código aberto, com scanner integrado

    O Jellyfin é de código aberto, auto-hospedado e gratuito para sempre — sem plano premium, sem telemetria, sem paywall para plugins. O scanner faz parte do próprio servidor, não é um plugin separado como o do Plex. Isso significa que as atualizações do Jellyfin trazem melhorias de nomenclatura através do ciclo de lançamento regular (atualmente quase mensal), e você pode ler o código de análise exato no GitHub se um padrão te surpreender. A desvantagem em relação ao Plex: a interface de metadados do Jellyfin é menos polida, a configuração de aceleração de hardware é mais manual e alguns recursos do Plex (Plex Pass DVR, análise sônica do Plexamp) não têm um equivalente direto. Para fins de nomenclatura, nada disso importa — você tem os mesmos pipelines do TMDB, TVDB, AniDB, MusicBrainz e OMDb que o Plex usa, apenas configurados de forma diferente.

    Provedores de metadados (não "agentes")

    Onde o Plex tem "agentes", o Jellyfin tem "provedores de metadados" configurados por biblioteca. Ao criar uma biblioteca, você escolhe quais provedores consultar e em que ordem. Para filmes, o padrão é o TheMovieDB; você pode adicionar OMDb, TVDb ou nenhum. Para séries de TV, são o TheMovieDB e o TheTVDB, com o The Open Movie Database (OMDb) como fallback. Para animes, você pode adicionar AniDB e AniList diretamente (sem necessidade de plugin externo no estilo HAMA). A ordem dos provedores importa: o Jellyfin os consulta de cima para baixo e usa a primeira correspondência bem-sucedida. Se o TheMovieDB retornar a série errada por causa de uma colisão de títulos, colocar o TheTVDB em primeiro lugar pode resolver o problema. Essa configuração por biblioteca é mais poderosa do que a escolha de agente fixa do Plex — e é o segredo para fazer animes funcionarem sem scanners de terceiros.

    Quatro regras que corrigem a maioria das falhas de correspondência

    Quatro regras que evitam a grande maioria dos problemas de correspondência do Jellyfin: Regra 1 — Use uma estrutura de uma pasta por item. Filmes em suas próprias pastas, séries de TV com subpastas de temporada explícitas. O Jellyfin escaneia a árvore de pastas para entender os limites dos itens antes de ler os nomes dos arquivos. Regra 2 — Inclua o ano de lançamento entre parênteses para filmes, assim como no Plex: "Title (YYYY)". O matcher do Jellyfin usa o ano de forma idêntica ao do Plex. Regra 3 — Use o padrão sXXeYY para episódios. O Jellyfin aceita mais variações que o Plex (a documentação lista mais de 8 formatos válidos), mas sXXeYY em minúsculas e com preenchimento de zero é o mais seguro e legível. Regra 4 — Na dúvida, incorpore o ID do provedor no nome da pasta. O Jellyfin suporta os sufixos "[tmdbid-12345]", "[tvdbid-67890]", "[imdbid-tt1234567]" que forçam correspondências exatas. Use-os sempre que um título for ambíguo.

    Need it from zero? renomeação passo a passo.

    Nomeando Filmes para o Jellyfin

    Filmes são o tipo de mídia mais simples do Jellyfin. O padrão de uma pasta por filme corresponde ao do Plex; o ano é obrigatório para desambiguação; arquivos com múltiplas versões são suportados através de uma convenção de nomenclatura um pouco diferente da do Plex. São apenas três pequenas diferenças que você precisa lembrar se estiver vindo do Plex.

    Estrutura de pastas

    Cada filme fica em sua própria pasta, nomeada "Title (Year)". O arquivo de vídeo dentro repete esse nome exato. Legendas, extras, pôsteres e trailers ficam na mesma pasta.

    Movies/
├── Blade Runner (1982)/
│   ├── Blade Runner (1982).mkv
│   ├── Blade Runner (1982).en.srt
│   ├── poster.jpg
│   └── trailers/
│       └── teaser.mp4
├── Dune (2021)/
│   └── Dune (2021).mkv
└── The Matrix (1999)/
    └── The Matrix (1999).mkv

    O Jellyfin lê primeiro o nome da pasta, depois o nome do arquivo. Mantê-los idênticos é o padrão mais limpo e permite que você armazene extras e artes sem colisões de nomes.

    O ano é inegociável

    O ano é inegociável pelo mesmo motivo do Plex: o TheMovieDB retorna correspondências de títulos duplicados ordenadas por popularidade e, sem o ano, você obtém a versão que for mais famosa no TMDB hoje. Formato: "Título (AAAA)" com o ano entre parênteses. A regex do Jellyfin é flexível — aceita "Title.YYYY.mkv" e "Title YYYY.mkv" — mas esses formatos quebram quando os títulos contêm números ("2001: A Space Odyssey", "1917"). Os parênteses são inequívocos. Use-os sempre.

    Filmes com múltiplas versões

    O Jellyfin suporta múltiplas versões do mesmo filme agrupadas em uma única entrada na biblioteca, de forma semelhante ao Plex, mas com um padrão de nomenclatura diferente. A convenção oficial do Jellyfin usa hifens e rótulos de versão:

    Dune (2021)/
├── Dune (2021) - 1080p.mkv
└── Dune (2021) - 2160p.mkv

    Ou o padrão de subpastas, que funciona de forma idêntica no Jellyfin e é mais organizado para bibliotecas com muitas edições:

    Dune (2021)/
├── 1080p/
│   └── Dune (2021).mkv
└── 2160p/
    └── Dune (2021).mkv

    Ambos os arquivos aparecem como um único card de filme com um seletor de versão. O Jellyfin seleciona automaticamente o arquivo de maior qualidade que o cliente pode reproduzir diretamente; se nenhum cliente puder reproduzir 4K HEVC, ele recorre à cópia de menor resolução sem precisar de transcodificação.

    Edições (Versão do Diretor, de Cinema, Estendida)

    Para versões do diretor, de cinema e edições estendidas, o Jellyfin suporta o padrão de sufixo "[edition-X]", que difere da convenção de chaves "{edition-X}" do Plex. Tenha cuidado ao migrar — o padrão com chaves é silenciosamente ignorado pelo Jellyfin:

    Movies/
├── Blade Runner (1982)/
│   ├── Blade Runner (1982) [edition-Theatrical].mkv
│   └── Blade Runner (1982) [edition-Final Cut].mkv
└── Apocalypse Now (1979)/
    ├── Apocalypse Now (1979) [edition-Theatrical].mkv
    └── Apocalypse Now (1979) [edition-Redux].mkv

    Cada edição aparece como um filme separado na biblioteca (não são agrupadas como as múltiplas versões). Use para versões com diferenças significativas de duração ou conteúdo; use múltiplas versões para a mesma versão em diferentes resoluções.

    Trailers, bastidores e extras

    O Jellyfin trata os extras (trailers, bastidores, cenas deletadas, entrevistas) como conteúdo de primeira classe. Coloque-os em subpastas dentro da pasta do filme usando exatamente estes nomes: `trailers/`, `behind the scenes/`, `deleted scenes/`, `interviews/`, `featurettes/`, `scenes/`, `shorts/`. Os arquivos dentro dessas pastas herdam os metadados do filme e aparecem no player do Jellyfin como conteúdo relacionado.

    Dune (2021)/
├── Dune (2021).mkv
├── trailers/
│   ├── trailer-1.mp4
│   └── trailer-2.mp4
└── behind the scenes/
    └── making-of.mp4

    A mesma convenção funciona para séries de TV — extras no nível da série vão em subpastas de extras na raiz da série.

    Erros que causam a maioria das falhas de correspondência

    Os quatro erros que causam a maioria das falhas de correspondência de filmes no Jellyfin: 1. Usar a sintaxe de edição do Plex com chaves `{edition-X}`. O Jellyfin a ignora silenciosamente — o sufixo se torna parte do título correspondido, quebrando a busca. 2. Ano ausente em um título não exclusivo. "Inception.mkv" corresponde por pura popularidade; "Dune.mkv" escolhe a versão de 2021 de Villeneuve em vez do filme de 1984 de Lynch 100% das vezes no TMDB. 3. Biblioteca de arquivo único na raiz (sem pasta). Funciona para correspondência, mas quebra o suporte a extras, pôsteres e múltiplas versões. 4. Codificação de caracteres errada em títulos não latinos. Caracteres de títulos em grego, cirílico e japonês precisam de codificação de nome de arquivo UTF-8; alguns extratores de zip legados gravam em Latin-1.

    Exemplos do mundo real

    Movies/
├── The Matrix (1999)/
│   └── The Matrix (1999).mkv
├── Dune (2021)/
│   ├── Dune (2021) - 1080p.mkv
│   └── Dune (2021) - 2160p.mkv
├── Blade Runner (1982)/
│   ├── Blade Runner (1982) [edition-Theatrical].mkv
│   └── Blade Runner (1982) [edition-Final Cut].mkv
├── 1917 (2019)/
│   └── 1917 (2019).mkv
└── Spirited Away (2001)/
    ├── Spirited Away (2001).mkv
    └── trailers/
        └── trailer.mp4

    Compare to Equivalentes no Plex.

    Official: Jellyfin movies docs · Jellyfin extras docs

    Tem uma biblioteca do Plex para converter? Experimente o modo em batch do RenameFlow.

    Comece grátis

    Nomeando séries de TV para o Jellyfin

    É em séries de TV que a flexibilidade do Jellyfin brilha e confunde novos usuários. O scanner aceita oito padrões de nome de arquivo válidos, o que parece ótimo até você misturá-los na mesma pasta da série e o sistema de correspondência escolher o errado. A solução é escolher um padrão e aplicá-lo de forma consistente — sendo `sXXeYY` em minúsculas o único padrão universalmente seguro.

    Estrutura de pastas

    Dois níveis: pasta da série e, em seguida, pasta da temporada. Igual ao Plex. O Jellyfin não agrupará os episódios corretamente se você achatar a estrutura.

    TV Shows/
├── Breaking Bad (2008)/
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
│   ├── Season 02/
│   │   └── Breaking Bad - s02e01.mkv
│   └── Specials/
│       └── Breaking Bad - s00e01 - Behind the Scenes.mkv
└── The Wire (2002)/
    └── Season 01/
        └── The Wire - s01e01.mkv

    Formato da pasta da série: "Título (Ano)". O ano desambigua remakes (The Office UK 2001 vs US 2005, House of Cards UK 1990 vs US 2013). Formato da pasta da temporada: "Season XX" com preenchimento de zero, ou "Specials" para a temporada 0.

    Forçar uma correspondência de provedor específica

    Bônus: anexe "[tmdbid-X]" ou "[tvdbid-Y]" ao nome da pasta da série. O Jellyfin usa isso como a busca canônica e ignora a correspondência baseada no título:

    The Office (2005) [tmdbid-2316]/
└── Season 01/
    └── The Office - s01e01.mkv

    Padrão de nome de arquivo

    O scanner do Jellyfin aceita estes padrões de episódio: - `Show - s01e01.mkv` (minúsculas, recomendado) - `Show - S01E01.mkv` (maiúsculas) - `Show - 1x01.mkv` (estilo cruzado) - `Show.S01.E01.mkv` (separado por pontos) - `Show s01e01 Title.mkv` (sem hífen) - `Show 101.mkv` (compacto — arriscado) - `Show 1.01.mkv` (compacto com ponto — arriscado) - `Show Season 1 Episode 1.mkv` (verboso) Escolha um e mantenha-o. As formas "compactas" (Show 101) funcionam, mas falham em séries com mais de 100 episódios por temporada ou com numeração absoluta de três dígitos. O padrão `sXXeYY` em minúsculas é o mais seguro e universal.

    Breaking Bad - s05e14 - Ozymandias.mkv

    Você pode adicionar um título de episódio para facilitar a leitura. O título do episódio não é usado para correspondência — o provedor de metadados do Jellyfin o substitui pelo título canônico do TVDB/TMDB.

    Especiais, OVAs e extras por temporada

    Especiais, OVAs, episódios de bastidores e extras vinculados a uma temporada vão para uma pasta "Specials" na raiz da série, ou em "Season 00". O Jellyfin trata ambos da mesma forma. Dentro, nomeie os arquivos como s00e01, s00e02, em ordem. Extras por temporada (trailers, cenas deletadas) também podem ficar em subpastas de extras dentro da pasta da temporada correspondente, usando as mesmas convenções de extras de filmes (`trailers/`, `deleted scenes/`, etc.).

    Programas diários baseados em data

    Programas diários (talk shows, notícias) sem numeração de temporada/episódio usam o padrão de data:

    The Daily Show (1996)/
└── Season 29/
    └── The Daily Show - 2024-03-15.mkv

    Formato AAAA-MM-DD. O Jellyfin faz a correspondência com o índice de datas do TheTVDB para programas diários — certifique-se de que o TheTVDB está ativado como provedor para a biblioteca.

    Arquivos com múltiplos episódios

    Para episódios duplos em um único arquivo:

    Breaking Bad - s05e15-e16 - Granite State + Felina.mkv

    O Jellyfin cria um item reproduzível que mapeia para ambos os episódios nos metadados. A forma de intervalo (`e15-e16`) é mais limpa; a forma de repetição completa (`s05e15-s05e16`) também funciona.

    Minisséries e séries limitadas

    Minisséries e séries limitadas (Chernobyl, Band of Brothers, The Queen's Gambit) seguem o padrão normal com "Season 01" como a única pasta de temporada. Não coloque os episódios diretamente na raiz da série — o scanner do Jellyfin espera a camada da pasta de temporada mesmo para séries de uma só temporada.

    As falhas mais comuns com séries de TV

    As falhas mais comuns com séries de TV no Jellyfin e suas causas: — "Episódio não correspondido" mas a temporada está correta: o padrão do nome do arquivo está malformado ou mistura estilos (s01E01 — E maiúsculo com s minúsculo). Padronize para sXXeYY minúsculos. — Temporada inteira não correspondida: a pasta da temporada não começa com "Season " (note o espaço). "S1", "Season1" e "s01" não funcionam. — Série errada correspondida: falta o ano em um título com conflitos. Adicione `(YYYY)` à pasta da série, ou use `[tmdbid-X]` para desambiguação absoluta. — Episódios divididos entre temporadas erradas: se você renomeou os arquivos mas o Jellyfin ainda mostra as atribuições antigas, force uma atualização de metadados no menu ⋯ da série → "Atualizar metadados" → "Substituir todos os metadados" → "Forçar". — Episódios especiais aparecendo como temporada 1: o arquivo está na raiz da série em vez da pasta "Specials/" ou "Season 00/". Mova o arquivo. — Minissérie exibida como um único episódio grande: todos os episódios estão na raiz da série sem uma pasta de temporada. Adicione "Season 01/" e mova os arquivos para dentro.

    Exemplos práticos

    TV Shows/
├── Breaking Bad (2008)/
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
│   ├── Season 05/
│   │   └── Breaking Bad - s05e15-e16 - Granite State + Felina.mkv
│   └── Specials/
│       └── Breaking Bad - s00e01 - No Half Measures.mkv
├── The Office (2005) [tmdbid-2316]/
│   └── Season 03/
│       └── The Office - s03e12 - Back from Vacation.mkv
├── Chernobyl (2019)/
│   └── Season 01/
│       └── Chernobyl - s01e01 - 1:23:45.mkv
└── The Daily Show (1996)/
    └── Season 29/
        └── The Daily Show - 2024-03-15.mkv

    Official: Jellyfin shows docs

    Nomeando Animes para o Jellyfin (Sem HAMA)

    É aqui que o Jellyfin se destaca do Plex para a maioria dos usuários. O Plex exige o plugin da comunidade HAMA para lidar com o AniDB corretamente — instalação manual, atualizações manuais, e pode quebrar. O Jellyfin já vem com AniDB e AniList como provedores de metadados nativos que você ativa nas configurações da biblioteca. Sem scanners externos, sem pasta de plugins do GitHub, sem permissões de plugin para conceder.

    Provedores nativos AniDB + AniList

    Para uma biblioteca de animes, crie uma nova biblioteca do tipo "TV Shows" e, na lista de provedores de metadados: 1. AniDB — o mais preciso para séries com numeração absoluta (One Piece, Detective Conan, Bleach) 2. AniList — secundário, útil para animes shonen modernos e de temporada 3. TheTVDB — como alternativa para séries com fortes lançamentos dublados em inglês 4. TheMovieDB — último recurso, frequentemente erra com animes Coloque o AniDB em primeiro. A maioria das reclamações no Reddit sobre "Jellyfin anime not matching" tem origem na priorização padrão do TheMovieDB.

    Para séries com ambiguidade no título (vários animes com o mesmo nome ao longo de décadas), force o ID do AniDB diretamente no nome da pasta:

    Anime/
└── One Piece [anidbid-69]/
    └── Season 01/

    O Jellyfin lê `[anidbid-X]`, `[tvdbid-X]`, `[tmdbid-X]` do nome da pasta e os usa como a busca canônica, ignorando completamente a correspondência aproximada baseada no título. Este é o equivalente mais próximo no Jellyfin ao scanner HAMA do Plex — e funciona sem precisar de configuração.

    Numeração absoluta (One Piece, Naruto)

    Para séries com numeração absoluta (episódio 1064 de One Piece, episódio 500 de Naruto Shippuden), o AniDB rastreia tudo como temporada 1 por padrão. Nomeie os arquivos de acordo:

    One Piece [anidbid-69]/
└── Season 01/
    ├── One Piece - s01e0001.mkv
    ├── One Piece - s01e0002.mkv
    └── One Piece - s01e1064.mkv

    O preenchimento de quatro dígitos (`e0001` em vez de `e1`) não é estritamente necessário, mas mantém a ordem de classificação do sistema de arquivos igual à ordem de reprodução — útil quando você navega pela pasta fora do Jellyfin. Se você quiser divisões de temporada no estilo TVDB (One Piece dividido em mais de 21 arcos), remova o ID do AniDB e deixe o provedor TheTVDB assumir. Escolha um modelo e mantenha a consistência em toda a série.

    Temporadas e cours divididos (Attack on Titan, Demon Slayer)

    Animes modernos divididos em várias "temporadas" ou "cours" (Attack on Titan Final Season Parts 1/2/3, arco Mugen Train de Demon Slayer vs arco Entertainment District) são a fonte mais comum de problemas de "temporada errada encontrada". A solução é a mesma do Plex: decida qual banco de dados corresponde ao seu modelo mental da série, defina a ordem dos provedores de acordo e use IDs no nível da pasta para forçar a correspondência:

    Anime/
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   ├── Season 02/
│   ├── Season 03/
│   └── Season 04/                    ← Final Season parte 1
├── Attack on Titan - Final Season Part 2 [anidbid-15689]/
│   └── Season 01/                    ← dividido como sua própria entrada no AniDB
└── Demon Slayer (2019)/
    ├── Season 01/
    ├── Season 02/                    ← Mugen Train + Entertainment District
    └── Season 03/                    ← Swordsmith Village

    OVAs e filmes de anime

    OVAs, filmes de anime vinculados a uma série e especiais vão todos em "Specials" ou "Season 00" com numeração sequencial. O AniDB tem metadados ricos para eles — a maioria dos casos de "OVA ambíguo" no estilo Plex se resolve corretamente no Jellyfin sem configuração extra. Para filmes de anime independentes (Your Name, Spirited Away, Akira), coloque-os na sua biblioteca de Filmes, não em uma biblioteca de séries de anime. O provedor de animes do Jellyfin lida melhor com filmes do que o provedor de séries.

    Legenda vs. dublagem

    Assim como o Plex, o Jellyfin pode armazenar várias faixas de áudio por arquivo ou armazenar arquivos de legenda/dublagem separados como versões múltiplas. O padrão de múltiplas versões permite que os espectadores alternem usando o seletor de versão:

    Show - s01e01 - JPN.mkv
Show - s01e01 - ENG.mkv

Ou use o padrão de sufixo de resolução com o idioma do áudio:
Show - s01e01 - 1080p JPN.mkv
Show - s01e01 - 1080p ENG.mkv

    Um único arquivo com áudio múltiplo embutido é mais organizado — o Jellyfin lê as tags de idioma do áudio do contêiner e permite que os espectadores escolham uma faixa na interface do player.

    Exemplos do mundo real

    Anime/
├── One Piece [anidbid-69]/
│   └── Season 01/
│       ├── One Piece - s01e0001.mkv
│       └── One Piece - s01e1064.mkv
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   ├── Season 02/
│   └── Specials/
│       └── Attack on Titan - s00e01 - Ilse's Notebook.mkv
└── Demon Slayer (2019)/
    └── Season 02/
        └── Demon Slayer - s02e01.mkv

    Coming from Plex? Compare com Plex + HAMA.

    Nomeando Músicas para o Jellyfin

    O gerenciamento de músicas do Jellyfin é um dos seus pontos mais fortes — integração total com o MusicBrainz, análise sônica para "mix instantâneo" (semelhante ao Plexamp) e bons aplicativos para Android/iOS. Em termos de nomenclatura, as regras espelham de perto as do Plex, com duas pequenas diferenças no tratamento de discos e no suporte a Various Artists.

    Estrutura de pastas

    Artista → Álbum → Faixa, assim como no Plex:

    Music/
├── Pink Floyd/
│   ├── The Dark Side of the Moon (1973)/
│   │   ├── 01 - Speak to Me.flac
│   │   └── 02 - Breathe.flac
│   └── Wish You Were Here (1975)/
│       └── 01 - Shine On You Crazy Diamond Pts. 1-5.flac
└── Daft Punk/
    └── Random Access Memories (2013)/
        └── 01 - Give Life Back to Music.flac

    Recomenda-se incluir o ano do álbum no nome da pasta. Os nomes dos arquivos de faixa começam com o número da faixa preenchido com zero, seguido por um hífen e o título.

    Tags ID3 prevalecem sobre nomes de arquivos

    O Jellyfin lê as tags ID3 antes dos nomes dos arquivos, como o Plex. Tags obrigatórias: Artist, Album, Title, Track Number. Altamente recomendadas: Album Artist (diferente do artista da faixa em compilações), Year, Genre, Disc Number. Renomeie os arquivos sem corrigir as tags e o Jellyfin ainda confiará nas tags erradas. O fluxo de trabalho mais organizado é: primeiro, corrija as tags com o MusicBrainz Picard ou Mp3tag e, em segundo lugar, cuide dos nomes dos arquivos. O modo de música do RenameFlow lê o MusicBrainz para sugerir nomes de arquivos, mas não escreve tags — use-o após um editor de tags.

    Various Artists / compilações

    Compilações e trilhas sonoras usam a tag de artista do álbum "Various Artists" — o mesmo padrão do Plex: Tag ID3: Album Artist = "Various Artists" Tag ID3: Artist = (artista individual da faixa) Estrutura de pastas:

    Music/
└── Various Artists/
    └── Pulp Fiction Soundtrack (1994)/
        ├── 01 - Misirlou - Dick Dale.flac
        └── 02 - Royale with Cheese - John Travolta.flac

    O Jellyfin exibe as compilações em "Various Artists", mas cada faixa mantém o crédito do seu artista real.

    Numeração de faixas

    Primeiro, o número da faixa com dois dígitos e preenchimento de zero, depois um hífen opcional e o título: 01 - Track Title.flac Ou apenas `01 Track Title.flac`. Ambos funcionam. Evite colocar o artista no nome de cada arquivo de faixa — é redundante com a hierarquia de pastas.

    Álbuns com múltiplos discos

    Álbuns com múltiplos discos usam subpastas "Disc XX" entre o álbum e as faixas, além da tag ID3 "Disc Number" em cada arquivo:

    Music/
└── Pink Floyd/
    └── The Wall (1979)/
        ├── Disc 01/
        │   └── 01 - In the Flesh?.flac
        └── Disc 02/
            └── 01 - Hey You.flac

    O Jellyfin os une em uma visualização de álbum contínua com divisores de disco. Sem a tag de disco, as faixas do disco 2 entram em conflito com as do disco 1 (dois "01", dois "02", e o scanner escolhe um).

    Exemplos práticos

    Music/
├── Pink Floyd/
│   ├── The Dark Side of the Moon (1973)/
│   │   ├── 01 - Speak to Me.flac
│   │   └── 10 - Eclipse.flac
│   └── The Wall (1979)/
│       ├── Disc 01/
│       │   └── 01 - In the Flesh?.flac
│       └── Disc 02/
│           └── 01 - Hey You.flac
└── Various Artists/
    └── Pulp Fiction Soundtrack (1994)/
        ├── 01 - Misirlou - Dick Dale.flac
        └── 02 - Royale with Cheese.flac

    Official: Jellyfin music docs

    Migrando do Plex para o Jellyfin

    Se você está migrando do Plex (cansaço de assinaturas, preocupações com telemetria, ou simplesmente querendo mais controle), a boa notícia é que cerca de 80% da sua nomeação compatível com o Plex funciona no Jellyfin sem alterações. Os 20% restantes — edições, animes e alguns casos específicos — precisam de renomeações direcionadas. Esta seção é o checklist completo.

    O que é mantido e o que não é

    O que é transferido sem alterações do Plex para o Jellyfin: - Nomeação de pastas de filmes: "Title (Year)/Title (Year).mkv" funciona de forma idêntica. - Nomeação de pastas de séries: "Show (Year)/Season XX/Show - sXXeYY.mkv" funciona de forma idêntica. - Sufixo de resolução para múltiplas versões: "Title (Year) - 1080p.mkv" funciona em ambos. - Música: A estrutura Artista/Álbum/Faixa é transferida sem alterações. - Especiais e o tratamento da "Season 00": mesma lógica. - Programas diários baseados em data (YYYY-MM-DD): mesmo formato. O que você precisa renomear: - Edições de filmes: O Plex usa `{edition-X}` (chaves), o Jellyfin usa `[edition-X]` (colchetes). Faça uma busca e substituição em toda a sua biblioteca de filmes. - Bibliotecas de animes construídas em torno do scanner HAMA do Plex: remova as tags específicas do HAMA e reative o AniDB como provedor de metadados na nova biblioteca do Jellyfin. Os IDs de pasta `[anidbid-X]` são mantidos e funcionam diretamente. - IDs de provedores nos nomes das pastas: o atalho `[tmdb-X]` do Plex se torna `[tmdbid-X]` no Jellyfin (note o sufixo `id`). O mesmo vale para tvdbid, imdbid, anidbid.

    Migração do status de assistido

    O status de assistido não migra automaticamente — o Plex o armazena em seu próprio banco de dados, não nos arquivos. Existem três opções: Opção 1 — Plex Watched History Importer (plugin da comunidade Jellyfin). Ele lê a exportação do banco de dados do Plex e importa as marcações de assistido por usuário. Funciona, mas exige que o Plex ainda esteja em execução por tempo suficiente para exportar. Opção 2 — Sincronização com Trakt.tv. Se você já fazia scrobble do Plex para o Trakt (através do plugin do Trakt), ative a sincronização com o Trakt no Jellyfin também. Seu histórico de assistidos é transferido usando o Trakt como ponte. Opção 3 — Aceitar a perda e começar do zero. Para bibliotecas com menos de algumas centenas de itens, este é frequentemente o caminho de menor esforço. Para famílias com múltiplos usuários, a sincronização com o Trakt é a mais confiável.

    Recursos do Plex Pass sem equivalente direto

    Alguns recursos do Plex Pass não têm um equivalente direto no Jellyfin. Saiba antes de migrar: - DVR / Live TV: O Jellyfin tem Live TV via sintonizadores (HDHomeRun, pendrives USB), mas a interface de agendamento do DVR é mais básica que a do Plex. - Análise sônica do Plexamp: O Jellyfin tem detecção básica de humor/gênero, mas não similaridade por impressão digital sônica. Symfonium ou Manet no celular são bons clientes parecidos com o Plexamp. - Pular introdução (só no Plex Pass): O Jellyfin tem plugins da comunidade para isso (Jellyscrub, Intro Skipper) — instale-os separadamente. - Plex Mobile Sync: Os aplicativos móveis do Jellyfin suportam sincronização, mas é menos refinada que a do Plex. - Mapeamento de Tom (Tone Mapping) / Transcodificação acelerada por hardware do Plex: O Jellyfin suporta as principais acelerações de hardware, mas requer configuração manual para cada plataforma. Esses não são problemas de nomeação, mas afetam a decisão de "devo migrar?". Nenhum deles impede uma migração limpa da biblioteca em si.

    Quando migrar (e quando ficar)

    Você é um bom candidato para migrar se: - O aumento de preço do Plex Pass mudou suas contas (Vitalício $250 vs. Jellyfin grátis para sempre). - Você quer seu histórico de exibição privado, sem telemetria. - Você usa Linux/BSD/unRAID e prefere apt/Docker aos pacotes oficiais do Plex. - Você não precisa do agendamento de DVR da Live TV. - Você não se importa em passar uma tarde configurando a aceleração de hardware. Você deve continuar no Plex se: - Membros da família dependem da sincronização móvel do Plex. - Você depende da descoberta refinada do Plex (Universal Watchlist, recomendações). - DVR é seu principal caso de uso. - Você prefere pagar uma vez por um produto refinado em vez de hospedar por conta própria (self-hosting). A migração de nomes em si leva 30 minutos para a maioria das bibliotecas — a conversão editorial (`{edition}` → `[edition]`) é uma única operação de localizar e substituir. Use o modo batch do RenameFlow para automatizar.

    Antes / depois

    Antes (Plex):
Movies/Blade Runner (1982)/Blade Runner (1982) - {edition-Final Cut}.mkv
TV/The Office (2005)/Season 03/The Office - s03e12 - Back from Vacation.mkv
Anime [HAMA]/One Piece [anidb-69]/Season 01/One Piece - s01e1064.mkv

Depois (Jellyfin):
Movies/Blade Runner (1982)/Blade Runner (1982) [edition-Final Cut].mkv
TV/The Office (2005)/Season 03/The Office - s03e12 - Back from Vacation.mkv
Anime/One Piece [anidbid-69]/Season 01/One Piece - s01e1064.mkv

Três mudanças: chaves por colchetes na edição do filme, remover a pasta de prefixo HAMA e renomear `[anidb-X]` para `[anidbid-X]`.

    Também útil: Usuários de FileBot vindo do Plex.

    Grátis: 15 arquivos/dia, conta gratuita em 30 segundos, sem upload.

    Comece grátis

    Solução de Problemas de Nomeação no Jellyfin

    Seis falhas cobrem cerca de 85% das reclamações de nomeação no Jellyfin. Cada uma tem uma causa previsível e uma solução clara.

    Filme aparece como não identificado

    Causas prováveis

    • Ano ausente ou em formato incorreto (colchetes em vez de parênteses)
    • Tag de edição com chaves {edition-X} do Plex copiada sem conversão
    • Arquivo do filme na raiz da biblioteca, sem pasta
    • Caracteres especiais de um 'scene release' ('BluRay.x264-SPARKS') interferindo no parser de títulos raros

    Passos para corrigir

    1. Adicione (AAAA) entre parênteses logo após o título na pasta e no nome do arquivo
    2. Converta {edition-X} para [edition-X] (chaves → colchetes)
    3. Mova o arquivo para uma pasta com o nome exatamente igual ao do arquivo
    4. No painel do Jellyfin → Biblioteca → Editar metadados do filme → Identificar → pesquise diretamente pelo ID do TMDB
    Série errada identificada

    Causas prováveis

    • Conflito de títulos (The Office UK vs US, House of Cards UK vs US, etc.)
    • Provedores de metadados em ordem errada — TheMovieDB retornando a variante mais popular

    Passos para corrigir

    1. Adicione (Ano) à pasta da série
    2. Force a identificação: anexe [tmdbid-X] ou [tvdbid-X] ao nome da pasta da série
    3. Configurações da biblioteca → Provedores de metadados → reordene o TheTVDB para cima do TheMovieDB se estiver lidando com uma série com forte identidade em bancos de dados de TV
    Episódios não são identificados, embora a série esteja correta

    Causas prováveis

    • Padrões de nome de arquivo misturados na mesma temporada (alguns s01e01, outros S01E01, outros 1x01)
    • 's' minúsculo com 'E' maiúsculo (s01E01) — o Jellyfin identifica, mas quebra em casos específicos
    • Título do episódio contém caracteres que parecem tokens de episódio (números, x)

    Passos para corrigir

    1. Padronize todos os arquivos de episódio de uma temporada para um único padrão. O mais seguro é sXXeYY em minúsculas
    2. Use um renomeador em lote (batch) para normalizar a temporada inteira de uma vez
    3. Se um episódio específico ainda falhar, adicione o título do episódio claramente separado: 'Show - s01e01 - Title.mkv'
    Anime dividido em temporadas erradas

    Causas prováveis

    • AniDB não está ativado como provedor de metadados na biblioteca de animes
    • TheMovieDB fornece divisões de temporada que não correspondem à estrutura canônica do AniDB
    • Falta o ID [anidbid-X] no nome da pasta

    Passos para corrigir

    1. Configurações da biblioteca → Provedores de metadados → ative o AniDB e mova-o para o topo
    2. Adicione [anidbid-X] ao nome da pasta da série (encontre o ID em anidb.net)
    3. Atualizar metadados: ⋯ → 'Atualizar metadados' → 'Substituir todos os metadados' → 'Forçar'
    A varredura da biblioteca termina, mas a biblioteca está vazia

    Causas prováveis

    • O servidor Jellyfin não tem permissão de leitura para a pasta da biblioteca
    • Compartilhamento de rede desmontado ou caminho alterado
    • Tipo de biblioteca errado (criada como 'Filmes', mas apontando para uma pasta de TV)

    Passos para corrigir

    1. Verifique se o usuário do SO do Jellyfin tem pelo menos permissão de leitura e execução no caminho
    2. Painel → Bibliotecas → verifique se o caminho ainda está acessível, monte novamente o compartilhamento de rede se necessário
    3. Verifique se o tipo de biblioteca corresponde ao conteúdo. Recriar a biblioteca é mais rápido do que corrigir o tipo
    Metadados parecem errados (pôster, resumo, lista de episódios)

    Causas prováveis

    • Metadados em cache de uma identificação errada antiga ainda estão aparecendo
    • O provedor retornou dados parciais e o Jellyfin preencheu as lacunas com dados de fallback em cache
    • Campo bloqueado — editado manualmente e depois esperado que atualizasse automaticamente

    Passos para corrigir

    1. Série/Filme ⋯ → 'Atualizar metadados' → 'Substituir todos os metadados' → 'Forçar'. Isso substitui a entrada do zero
    2. Desbloqueie os campos que você bloqueou anteriormente: Editar metadados → ícone do campo → desbloquear
    3. Se ainda estiver errado: 'Identificar' → pesquise manualmente e escolha a entrada correta do TMDB/TVDB

    A Alternativa de 60 Segundos

    Tudo acima é o jeito manual: entender os padrões, digitar os nomes dos arquivos, corrigir os casos específicos. Vale a pena fazer uma vez para uma biblioteca nova. É um processo doloroso para uma migração do Plex com 2.000 arquivos para converter.

    O jeito manual

    Manualmente, uma conversão de nomes do Plex para o Jellyfin leva cerca de 30 segundos por item se você for disciplinado — localizar e substituir a sintaxe de edição, verificar os IDs das pastas de animes, corrigir quaisquer tokens de episódio em formato compacto. Uma biblioteca de 2.000 arquivos significa mais de 16 horas de digitação cuidadosa.

    O jeito de 60 segundos

    O RenameFlow faz a conversão em segundos. Arraste a pasta nomeada para o Plex: o parser detecta o padrão existente, sugere o equivalente compatível com o Jellyfin e renomeia localmente após a sua confirmação. Sem upload — os arquivos ficam no seu disco graças à File System Access API. Grátis para até 15 arquivos por dia; € 69 vitalício para a biblioteca inteira de uma só vez. Para uma nova biblioteca do Jellyfin a partir de releases brutos da scene (sem nomenclatura do Plex para converter), o RenameFlow consulta o TheMovieDB, o TheTVDB, o AniList e o MusicBrainz em paralelo e gera diretamente o padrão compatível com o Jellyfin — seguindo exatamente as regras deste guia.

    Veja Planos do RenameFlow.

    Grátis: 15 arquivos/dia, conta gratuita em 30 segundos, sem upload.

    Experimente o RenameFlow grátis

    Nomenclatura do Jellyfin — Perguntas Frequentes

    A convenção de nomes do Jellyfin é compatível com o Plex?
    Sim, em cerca de 80%. A estrutura de pastas, o ano do filme, os padrões sXXeYY de séries, e Artista/Álbum/Faixa de músicas — tudo idêntico. As principais diferenças são: edições de filmes usam colchetes [edition-X] no Jellyfin em vez de chaves {edition-X} no Plex; os IDs de provedores usam o sufixo 'id' (tmdbid, tvdbid, anidbid) no Jellyfin; e animes usam o provedor nativo AniDB do Jellyfin em vez do plugin HAMA. Planeje cerca de 30 minutos de trabalho de localizar e substituir para uma migração típica.
    Preciso do HAMA para animes no Jellyfin?
    Não. O Jellyfin já vem com AniDB e AniList como provedores de metadados nativos — basta ativá-los nas configurações da biblioteca. A sintaxe de ID na pasta [anidbid-X] funciona sem precisar de configuração extra. Esta é uma das maiores vantagens do Jellyfin sobre o Plex para bibliotecas de animes.
    Por que o Jellyfin identifica a versão errada de filmes com títulos duplicados?
    Pelo mesmo motivo do Plex: o TheMovieDB retorna os resultados ordenados por popularidade. Corrija adicionando o ano entre parênteses '(YYYY)' tanto na pasta quanto no nome do arquivo. Para casos difíceis, force a identificação com '[tmdbid-X]' no nome da pasta.
    Qual é o padrão de nome de arquivo mais seguro para episódios de séries no Jellyfin?
    sXXeYY em minúsculas e com zero à esquerda. Exemplo: 'Show - s01e01 - Title.mkv'. O Jellyfin aceita mais de 8 variações, mas misturá-las na mesma série é a causa mais comum de falhas na identificação de temporadas parciais.
    Posso usar o Jellyfin e o Plex na mesma pasta de biblioteca?
    Sim, desde que a nomeação funcione para ambos. A estrutura de pastas compatível com o Plex funciona no Jellyfin para filmes, séries e músicas. As edições de filmes são a única exceção — escolha a sintaxe do servidor que você mais usa e aceite que o outro mostrará o rótulo da edição errado (ou genérico).
    O Jellyfin suporta 4K HDR e Dolby Vision como o Plex?
    Sim para HDR10 (na maioria dos clientes). O suporte a Dolby Vision depende do cliente — o servidor Jellyfin lida bem com o arquivo, mas a reprodução de DV exige um cliente que suporte o perfil DV do seu arquivo (perfil 5, 7, 8). A maioria dos clientes modernos suporta o perfil DV 8.1. Quanto à nomeação, basta usar múltiplas versões com o sufixo de resolução e o Jellyfin cuida da seleção automática para o cliente.
    Por que meus escaneamentos no Jellyfin são tão lentos em comparação com o Plex?
    Dois motivos principais: provedores de metadados 'faladores' (especialmente o TheTVDB) e a etapa de extração de capítulos no primeiro escaneamento. Acelere o processo desativando a extração de capítulos nas configurações da biblioteca (você pode reativar sob demanda para séries específicas), reduzindo o número de provedores ativados (um principal + um de fallback é suficiente) e executando os escaneamentos fora do horário de pico. A maioria das bibliotecas atinge uma velocidade razoável após o primeiro escaneamento completo.
    Posso automatizar a nomeação de novos downloads para o Jellyfin?
    Sim, de duas formas. Para fluxos automatizados: o Sonarr e o Radarr já nomeiam os arquivos antes de eles chegarem à sua biblioteca — configure a convenção de nomenclatura do Sonarr com os padrões do Jellyfin deste guia. Para revisão manual: use o RenameFlow como ferramenta de renomeação em lote ao importar — ele consulta os mesmos provedores de metadados que o Jellyfin usa (TMDB, TVDB, AniList, MusicBrainz) e gera nomes de arquivo compatíveis com o Jellyfin.

    → Ver todas as FAQs do RenameFlow