Guia de Nomenclatura Kodi: Filmes, Séries, Anime, Músicas e Arquivos NFO (2026)
O Kodi é famoso por sua flexibilidade na nomeação de arquivos — e é exatamente por isso que tantas bibliotecas quebram. O scanner aceita dezenas de padrões válidos, mas os aplica de forma inconsistente entre os scrapers. Acerte o padrão para o seu scraper e o Kodi encontrará artes, sinopses e títulos de episódios em segundos. Erre, e você ficará olhando para "nenhuma informação encontrada" por horas.
Este guia é a referência prática que gostaríamos que existisse quando montamos nossa primeira biblioteca Kodi — todos os tipos de mídia, cada peculiaridade dos scrapers, o sistema de arquivos NFO que permite ignorar completamente os scrapers e os passos para solucionar problemas quando a biblioteca se recusa a escanear. Os exemplos seguem a wiki oficial do Kodi e são verificados com o comportamento do Kodi 21 (Omega), com notas de retrocompatibilidade para o Kodi 20 (Nexus) e versões anteriores.
Ao final, você terá uma biblioteca Kodi que escaneia sem problemas na primeira vez — seja começando do zero, arrumando uma bagunça existente, ou vindo do Plex ou Jellyfin e se perguntando por que "os padrões que eu sempre usei" de repente pararam de funcionar.
Pule o trabalho manual — renomeie uma pasta em segundos
Comece grátisFundamentos da Nomenclatura do Kodi
Três conceitos sobre como o Kodi escaneia diferem o suficiente do Plex e Jellyfin para merecerem sua própria explicação. Pule esta seção e você continuará encontrando os mesmos três erros: scraper errado para sua biblioteca, tipo de conteúdo mal configurado e arquivos NFO inesperados sobrescrevendo seus scrapes.
Scrapers, não agentes
Onde o Plex tem "agents" e o Jellyfin tem "provedores de metadados", o Kodi tem "scrapers" — add-ons mantidos pela comunidade que consultam bancos de dados específicos. Os padrões são o scraper The Movie Database para filmes, o scraper The Movie Database ou o scraper The TVDB para séries, e o Universal Album Scraper para música. Anime é a grande exceção: o Kodi não tem um scraper de anime integrado, então os usuários instalam add-ons da comunidade como o Hama (o mesmo usado no Plex) para integração com o AniDB. A escolha do scraper ocorre por fonte, não por biblioteca. Abra uma fonte de vídeo do Kodi no navegador de arquivos, edite-a e escolha "Definir conteúdo" para atribuir um scraper. A mesma fonte pode ser escaneada por diferentes add-ons em dispositivos Kodi na mesma rede — o que é uma das razões pelas quais "meu Kodi funciona, mas o do meu amigo não" é tão comum.
Fontes da biblioteca e tipos de conteúdo
A biblioteca do Kodi é construída a partir de "fontes" que você adiciona manualmente — pastas, compartilhamentos de rede ou caminhos remotos. Ao adicionar uma fonte, você informa ao Kodi que tipo de conteúdo ela contém (Filmes, Séries, Clipes, Música, Nenhum) e qual scraper usar para esse conteúdo. Misturar tipos de conteúdo em uma única fonte é uma causa comum de arquivos não correspondidos: uma pasta contendo filmes e séries só pode ser processada por um scraper de um tipo ou de outro. A solução é separar o conteúdo misto em pastas de nível superior distintas, cada uma sendo sua própria fonte, cada uma com seu próprio tipo de conteúdo. Isso é mais rígido do que a detecção de biblioteca por pasta do Plex, mas mais previsível depois que você se compromete com a estrutura.
Quatro regras para evitar 90% das falhas
Quatro regras que evitam a grande maioria das falhas de escaneamento do Kodi: Regra 1 — Um tipo de conteúdo por fonte. Não misture filmes e séries em uma única pasta que o Kodi escaneia como "Filmes". Regra 2 — Defina o tipo de conteúdo e o scraper ANTES do primeiro escaneamento. Alterá-los depois exige uma "Atualização" e, às vezes, uma limpeza completa do banco de dados para remover correspondências erradas antigas. Regra 3 — Use sXXeYY para episódios de séries, em minúsculas e com preenchimento de zero. O Kodi aceita mais variações que o Plex, mas padrões previsíveis evitam casos extremos do scraper. Regra 4 — Quando um scraper falha repetidamente em um item específico, coloque um arquivo NFO ao lado dele. Arquivos NFO substituem completamente os scrapers — são a válvula de escape do Kodi.
Need it from zero? guia passo a passo.
Nomeando Filmes para o Kodi
O Kodi aceita dois layouts válidos para filmes — uma pasta por filme e um layout plano (flat). O padrão de pastas é recomendado pelos mesmos motivos que no Plex e Jellyfin (extras, pôsteres, arquivos NFO), além de um recurso específico do Kodi: filmes empilhados (stacked) em várias partes, que o Kodi lida nativamente, ao contrário do Plex e Jellyfin.
Layout de pastas recomendado
O layout de pastas recomendado:
Movies/
├── Blade Runner (1982)/
│ ├── Blade Runner (1982).mkv
│ ├── Blade Runner (1982).en.srt
│ ├── movie.nfo
│ ├── poster.jpg
│ └── fanart.jpg
├── Dune (2021)/
│ └── Dune (2021).mkv
└── The Matrix (1999)/
└── The Matrix (1999).mkvO nome do arquivo corresponde ao nome da pasta. Os arquivos de arte usam os nomes de arte local do Kodi: poster.jpg, fanart.jpg, clearart.png, landscape.jpg. As legendas seguem a convenção Title (Year).en.srt, .fr.srt etc. — o Kodi lê o código do idioma a partir do sufixo separado por ponto.
O sufixo (Ano) não é opcional
O ano entre parênteses não é negociável pelos mesmos motivos que no Plex e Jellyfin: o TheMovieDB retorna correspondências de títulos duplicados ordenadas por popularidade, e o Kodi escolherá silenciosamente o errado. Formato: Title (YYYY). Colchetes [YYYY], pontos Title.YYYY e anos sem formatação funcionam em alguns scrapers, mas falham em outros — os parênteses são universais. Para filmes que não existem no TMDB (lançamentos raros de cinema de arte, regionais), um arquivo NFO com um ID manual do TMDB é a única solução confiável. Veja a seção sobre NFO abaixo.
Filmes empilhados (stacked) em várias partes (exclusivo do Kodi)
O Kodi tem suporte nativo para filmes em várias partes armazenados como arquivos separados — um recurso da era dos rips de DVD que ainda é útil para filmes muito longos (LotR Extended, Once Upon a Time in America) divididos em vários discos. Use os padrões de sufixo cd1 / cd2 / partN / dvdN:
Movies/
└── Lord of the Rings - The Fellowship of the Ring (2001)/
├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
└── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkvO Kodi os reproduz em sequência como um único filme e os cataloga como uma única entrada na biblioteca. O padrão de correspondência não diferencia maiúsculas de minúsculas e aceita cd, part, dvd, pt e alguns outros — mas cd1/cd2 é o mais seguro e bem documentado.
Múltiplas versões do mesmo filme
O Kodi não tem o recurso de múltiplas versões unificadas que o Plex e o Jellyfin oferecem — você não pode armazenar uma versão 1080p e uma 4K sob uma única entrada na biblioteca e fazer o Kodi escolher a certa para o cliente. Cada arquivo se torna sua própria entrada na biblioteca. Duas soluções alternativas: Abordagem 1 — Mantenha uma versão por filme na biblioteca do Kodi e armazene as outras versões fora da pasta de origem catalogada. Alterne a pasta de origem manualmente quando quiser a outra qualidade. Abordagem 2 — Divida em duas bibliotecas (Movies-1080p, Movies-4K) com duas pastas de origem. Use perfis do Kodi ou atalhos de skin para alternar entre elas. Dá mais trabalho, mas permite que todas as versões coexistam na mesma instalação do Kodi. Se múltiplas versões são centrais para o seu fluxo de trabalho, esta é a única área onde o Plex e o Jellyfin são objetivamente mais capazes.
Conjuntos e coleções de filmes
O Kodi suporta conjuntos de filmes (às vezes chamados de "coleções") — Star Wars, Marvel Cinematic Universe, Lord of the Rings — agrupando filmes sob um único nó de coleção navegável. Os conjuntos são preenchidos automaticamente com os dados de coleção do TMDB para filmes que pertencem a uma. Nenhuma alteração no nome é necessária; o Kodi lê o ID da coleção dos metadados catalogados do TMDB. Para conjuntos personalizados (seu próprio agrupamento que não está no TMDB), use um arquivo NFO no nível do filme com uma tag <set> apontando para um nome de conjunto personalizado.
Quatro erros que causam a maioria das falhas de catalogação
1. Tipo de conteúdo da pasta de origem definido como "Nenhum" ou tipo errado. Sem um tipo de conteúdo, o Kodi simplesmente não escaneia os arquivos como filmes. 2. Ano ausente ou entre colchetes. "Inception 2010.mkv" corresponde por sorte; "Inception [2010].mkv" falha no scraper do TMDB. 3. Arquivo de filme na raiz da pasta de origem, sem uma pasta própria. Funciona para a correspondência, mas quebra os recursos de arte, NFO e partes empilhadas. 4. Entradas antigas de uma catalogação errada anterior. Mesmo após corrigir os nomes, o Kodi mostra a correspondência errada antiga. Solução: menu de contexto da biblioteca → "Limpar biblioteca" → e então escanear novamente.
Exemplos completos
Movies/
├── The Matrix (1999)/
│ ├── The Matrix (1999).mkv
│ ├── movie.nfo
│ └── fanart.jpg
├── Lord of the Rings - The Fellowship of the Ring (2001)/
│ ├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
│ └── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkv
├── Dune (2021)/
│ └── Dune (2021).mkv
└── 1917 (2019)/
└── 1917 (2019).mkvCompare to Equivalentes no Plex.
Pule a digitação — renomeie uma pasta de filmes em segundos
Comece grátisNomeando Séries de TV para o Kodi
É com séries que a flexibilidade do Kodi mais ajuda — múltiplos padrões de nome de arquivo válidos são aceitos, e o scraper perdoa pequenas variações. A desvantagem: quando algo não corresponde, a causa raramente é óbvia. Esta seção cobre os padrões seguros e os casos em que o Kodi difere do Plex/Jellyfin.
Estrutura de pastas
Estrutura padrão de dois níveis: pasta da série e, em seguida, subpastas de temporada.
TV Shows/
├── Breaking Bad (2008)/
│ ├── tvshow.nfo
│ ├── poster.jpg
│ ├── Season 01/
│ │ ├── Breaking Bad - s01e01 - Pilot.mkv
│ │ └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
│ └── Season 02/
│ └── Breaking Bad - s02e01.mkv
└── The Office (2005)/
└── Season 03/
└── The Office - s03e12.mkvNome da pasta da série: "Title (Year)". O ano desambigua remakes — The Office UK 2001 vs US 2005, House of Cards UK 1990 vs US 2013. Pasta da temporada: "Season XX" com dois dígitos preenchidos com zero, ou "Season 0" (ou "Season 00") para especiais. O Kodi aceita tanto "Season 0" quanto "Season 00"; escolha um e mantenha a consistência. Diferente da convenção de pasta "Specials" do Plex, o Kodi NÃO reconhece o nome de pasta literal "Specials". Use Season 0 ou Season 00.
Formato do nome de arquivo do episódio
Padrão de nome de arquivo de episódio recomendado pelo Kodi: Show Name - sXXeYY - Episode Title.ext Letras minúsculas, números de dois dígitos preenchidos com zero, título do episódio opcional para legibilidade. O Kodi aceita maiúsculas (SXXEYY), Show.S01E01, Show 1x01, Show 101 e várias outras variações — mas o formato com letras minúsculas e separado por hífen é o mais confiável entre os scrapers. O título do episódio no nome do arquivo é apenas para legibilidade humana — o scraper do Kodi o substitui pelo título canônico do TheTVDB ou TheMovieDB. Se o título fornecido pelo scraper estiver errado, edite-o pela interface do Kodi (clique com o botão direito no episódio → "Informações" → "Editar") ou através do arquivo NFO (abordado mais adiante).
Especiais na Season 0
Especiais, OVAs, episódios piloto, bastidores e conteúdo bônus vão em "Season 0" (ou "Season 00" — o Kodi trata ambos de forma idêntica). Dentro dela, use numeração sequencial: Show - s00e01.mkv, Show - s00e02.mkv. A ordem da numeração deve corresponder à lista de especiais do TheTVDB para essa série. A comunidade do TheTVDB organiza esses especiais em uma ordem específica (geralmente baseada na data de exibição); o Kodi espera que você siga essa ordem. Se seus especiais parecerem desordenados na interface do Kodi, verifique a aba de especiais da série no TheTVDB e reordene seus números s00eYY de acordo.
Arquivos com múltiplos episódios
Para episódios duplos em um único arquivo:
Breaking Bad - s05e15-e16 - Granite State + Felina.mkvO Kodi cria um único item reproduzível que mapeia para ambos os episódios nos metadados. O formato de intervalo (e15-e16) é mais limpo; a forma alternativa (s05e15-s05e16) também funciona. Ambos se estendem para episódios triplos ou quádruplos, se necessário (e15-e16-e17), embora isso seja raro na prática.
Séries diárias (baseadas em data)
Séries diárias (talk shows, notícias) sem números tradicionais de temporada/episódio usam o formato de data AAAA-MM-DD:
The Daily Show (1996)/
└── Season 29/
└── The Daily Show - 2024-03-15.mkvO scraper TheTVDB do Kodi compara a data com o índice de datas de séries diárias. Certifique-se de que a fonte use o scraper TheTVDB, e não o TheMovieDB — o TheMovieDB tem suporte limitado para séries diárias.
Exemplos completos
TV Shows/
├── Breaking Bad (2008)/
│ ├── tvshow.nfo
│ ├── 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
│ └── Season 00/
│ └── Breaking Bad - s00e01 - No Half Measures.mkv
├── Chernobyl (2019)/
│ └── Season 01/
│ └── Chernobyl - s01e01 - 1:23:45.mkv
└── The Daily Show (1996)/
└── Season 29/
└── The Daily Show - 2024-03-15.mkvCompare to Equivalentes no Jellyfin.
Nomeando Animes para o Kodi (com o Hama Scraper)
O Kodi não tem um scraper de animes integrado — os add-ons padrão TheMovieDB e TheTVDB tratam animes como séries de TV normais, o que funciona para shonen de temporada modernos, mas falha com séries de numeração absoluta (One Piece, Detective Conan, Bleach). A solução é o Hama, o mesmo scraper da comunidade usado no Plex para bibliotecas de animes. Instalá-lo uma vez libera a integração com o AniDB em todas as suas fontes de animes no Kodi.
Configurando o Hama (10 minutos, uma única vez)
A configuração do Hama no Kodi leva cerca de 10 minutos: 1. Baixe o Hama de github.com/ZeroQI/Hama.bundle (o bundle do Plex funciona no Kodi através do wrapper do add-on Hama para Kodi). Alternativa: instale o "Hama" do repositório oficial de add-ons do Kodi, se estiver disponível na sua versão do Kodi. 2. No Kodi: Configurações → Add-ons → Instalar do repositório → Provedores de informação → Séries de TV → instale o Hama (e o Hama.bundle se estiver listado separadamente). 3. Crie uma fonte dedicada para animes. Adicione uma fonte de vídeo apontando para sua pasta de animes, defina o tipo de conteúdo como "Séries de TV" e escolha "Hama" como o scraper em vez de TheMovieDB ou TheTVDB. 4. O Hama usa o AniDB como banco de dados principal por padrão. Você pode alterar a ordem de prioridade nas configurações do scraper — AniDB primeiro é recomendado para séries com numeração absoluta; TVDB primeiro para séries que você quer com metadados de dublagem em inglês. 5. Execute um scrape na fonte. O primeiro scrape é lento (o Hama consulta múltiplos bancos de dados) — seja paciente. Os scrapes seguintes são muito mais rápidos.
Numeração absoluta de episódios
Para séries com numeração absoluta como One Piece (episódio 1.064), use a temporada 01 com os números absolutos dos episódios preenchidos com zeros até 4 dígitos:
Anime/
└── One Piece [anidbid-69]/
└── Season 01/
├── One Piece - s01e0001.mkv
├── One Piece - s01e0002.mkv
└── One Piece - s01e1064.mkvO sufixo [anidbid-X] no nome da pasta força o Hama a usar a entrada do AniDB diretamente, pulando a correspondência aproximada de título. Encontre o ID em anidb.net pesquisando pela série — o ID está na URL. O preenchimento com 4 dígitos não é necessário para a correspondência, mas mantém a ordem de classificação do sistema de arquivos igual à ordem de reprodução. Sem o preenchimento, o arquivo e1064 é classificado depois de e11 em vez de depois de e1063, o que torna a navegação na pasta confusa fora do Kodi.
Temporadas divididas e arcos
Animes modernos divididos em "partes" (Attack on Titan Final Season Parts 1/2/3, arcos de Demon Slayer) causam a mesma confusão no scraping que no Plex e Jellyfin. A solução: decida qual banco de dados corresponde ao seu modelo mental da estrutura da série, force-o usando o sufixo de ID na pasta e mantenha a consistência em todos os seus animes.
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/ ← O AniDB cataloga a Parte 2 como uma entrada separada
└── Demon Slayer (2019)/
├── Season 01/
├── Season 02/ ← Arco do Trem Infinito + Distrito do Entretenimento
└── Season 03/Exemplos completos
Anime/
├── One Piece [anidbid-69]/
│ ├── Season 01/
│ │ ├── One Piece - s01e0001.mkv
│ │ └── One Piece - s01e1064.mkv
│ └── Season 00/
│ └── One Piece - s00e001 - Movie 14 Stampede.mkv
├── Attack on Titan [anidbid-9541]/
│ ├── Season 01/
│ └── Season 04/
└── Demon Slayer (2019)/
└── Season 02/
└── Demon Slayer - s02e01.mkvSame scraper in Plex? Animes no Plex (HAMA, mesmo scraper).
Nomeando Músicas para o Kodi
No Kodi, as músicas são organizadas primariamente por tags e secundariamente por pastas — exatamente como no Plex e no Jellyfin. O Universal Album Scraper (padrão no Kodi 19+) lê as tags ID3 e consulta o MusicBrainz e o TheAudioDB para obter artes e metadados. Corrija as tags primeiro e se preocupe com a estrutura de pastas depois.
Estrutura de pastas recomendada
Estrutura recomendada:
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
├── Various Artists/
│ └── Pulp Fiction Soundtrack (1994)/
│ ├── 01 - Misirlou - Dick Dale.flac
│ └── 02 - Royale with Cheese - John Travolta.flac
└── Tool/
└── Lateralus (2001)/
├── Disc 01/
│ └── 01 - The Grudge.flac
└── Disc 02/
└── 01 - Faaip de Oiad.flacÉ recomendado incluir o ano do álbum no nome da pasta. Álbuns com múltiplos discos usam subpastas "Disc XX". Coletâneas usam a tag de artista do álbum "Various Artists" (tag Album Artist = "Various Artists", enquanto a tag Artist individual permanece como o intérprete da faixa).
Tags ID3 que o Kodi realmente usa
Tags ID3 necessárias para uma correspondência limpa no Kodi: Artist, Album, Title, Track Number. Fortemente recomendadas: Album Artist (diferente de Artist em coletâneas), Year, Genre, Disc Number, MusicBrainz IDs. Os MusicBrainz IDs (Album ID e Recording ID, incorporados como frames TXXX do ID3v2.3 ou comentários Vorbis) permitem que o Universal Album Scraper do Kodi faça uma correspondência exata, evitando a correspondência aproximada por título. Use o MusicBrainz Picard para gravar esses IDs uma vez e a sua biblioteca do Kodi se tornará praticamente à prova de falhas. O modo de música do RenameFlow lê o MusicBrainz e produz nomes de arquivo + estrutura de pastas precisos; ele não grava tags ID3. Use-o após um editor de tags como o Picard, não como um substituto.
Exemplos completos
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.flacArquivos NFO — O Sistema de Sobrescrita de Metadados do Kodi
Arquivos NFO são a maior diferença entre o Kodi e o Plex/Jellyfin em relação à nomeação de arquivos. Um NFO é um pequeno arquivo XML que você coloca ao lado de um vídeo, e o Kodi o lê EM VEZ de consultar scrapers online. Eles são opcionais, mas extremamente úteis: permitem que você substitua correspondências erradas do scraper, documente coleções personalizadas e fixe metadados que poderiam mudar com o tempo conforme os bancos de dados online são atualizados. O Plex não tem nada equivalente; o Jellyfin tem suporte parcial através de imagens locais e XML mínimo. O sistema de NFO do Kodi é a implementação mais madura em qualquer media center de código aberto.
Quando criar arquivos NFO (e quando não criar)
Você não precisa de arquivos NFO para tudo — os scrapers acertam 90% das correspondências. Os quatro cenários em que vale a pena criar arquivos NFO: 1. O scraper identifica o filme/série errado e a opção "Editar" na interface do Kodi não funciona (comum em séries com muitos remakes). 2. Um filme ou série não está no TMDB/TVDB (lançamentos regionais, edições de fãs, conteúdo de nicho). 3. Você quer agrupamentos de coleções personalizados além do que o TMDB oferece (seu próprio conjunto "Melhor Ficção Científica dos anos 90", por exemplo). 4. Você está armazenando metadados que não pode perder — a biblioteca do Kodi pode ser reconstruída apenas com os arquivos NFO se o banco de dados for corrompido. Para bibliotecas com menos de 200 itens, arquivos NFO geralmente são um exagero. Para bibliotecas com mais de 1.000 itens onde você passou tempo corrigindo metadados, eles são uma garantia.
movie.nfo — o NFO mais útil
Formato NFO para filmes. Coloque o arquivo ao lado do filme com o nome movie.nfo (ou Title (Year).nfo, correspondendo ao nome do arquivo de vídeo — ambos funcionam, mas movie.nfo é a convenção):
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<movie>
<title>Blade Runner</title>
<originaltitle>Blade Runner</originaltitle>
<year>1982</year>
<plot>A blade runner must pursue and terminate four replicants...</plot>
<runtime>117</runtime>
<mpaa>R</mpaa>
<genre>Science Fiction</genre>
<genre>Thriller</genre>
<director>Ridley Scott</director>
<actor>
<name>Harrison Ford</name>
<role>Rick Deckard</role>
</actor>
<uniqueid type="tmdb" default="true">78</uniqueid>
<uniqueid type="imdb">tt0083658</uniqueid>
<set>
<name>Blade Runner Collection</name>
</set>
</movie>O campo <uniqueid type="tmdb"> força o Kodi a usar a entrada específica do TMDB em vez de fazer uma correspondência aproximada do título. Esta é a tag mais útil de todas — se você for escrever apenas uma coisa em seus arquivos NFO, que seja esta.
tvshow.nfo — sobrescritas no nível da série
Arquivos NFO de séries de TV ficam na pasta raiz da série, com o nome tvshow.nfo. O formato é semelhante ao movie.nfo, mas com campos para o nível da série:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tvshow>
<title>Breaking Bad</title>
<year>2008</year>
<plot>A high school chemistry teacher diagnosed with cancer...</plot>
<genre>Crime</genre>
<genre>Drama</genre>
<uniqueid type="tvdb" default="true">81189</uniqueid>
<uniqueid type="tmdb">1396</uniqueid>
<uniqueid type="imdb">tt0903747</uniqueid>
<status>Ended</status>
<studio>AMC</studio>
</tvshow>A tag <uniqueid type="tvdb"> é a trava mais confiável para séries de TV, já que o TheTVDB é o scraper de TV padrão do Kodi para a maioria dos usuários.
NFO por episódio (raramente necessário)
Arquivos NFO por episódio raramente são necessários — o NFO no nível da série e os metadados de episódio obtidos pelo scraper cobrem a maioria dos casos. Use-os apenas quando um episódio específico for correspondido incorretamente e atualizar a série não resolver o problema. Formato: coloque o arquivo Show - s01e01.nfo ao lado do arquivo de vídeo:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<episodedetails>
<title>Pilot</title>
<season>1</season>
<episode>1</episode>
<aired>2008-01-20</aired>
<plot>Walter White, a struggling high school chemistry teacher...</plot>
<uniqueid type="tvdb" default="true">349232</uniqueid>
</episodedetails>Tags de metadados avançadas
Além das tags básicas <title>, <year> e <plot>, o Kodi entende um conjunto rico de campos de metadados que permitem personalizar como os itens aparecem na sua biblioteca. Os mais úteis para usuários avançados são: <originaltitle> — o título no idioma original, exibido nas páginas de informações junto com o título localizado. Essencial para filmes estrangeiros onde o título da distribuidora local difere significativamente do original (pense em A Viagem de Chihiro vs Sen to Chihiro no Kamikakushi). <sorttitle> — substitui o comportamento de ordenação padrão. Use-a para forçar "The Matrix" a ser ordenado sob "M" em vez de "T", ou para agrupar sequências, independentemente de seus títulos canônicos. Exemplo: ordenar todos os filmes Missão: Impossível como "Mission Impossible 01", "Mission Impossible 02" etc. <tagline> — o slogan de marketing curto exibido abaixo do título (pense em "No espaço, ninguém pode ouvir você gritar"). Dá um toque de refinamento às páginas de informações da sua biblioteca. <status> para séries de TV — "Continuing", "Ended" ou "Returning Series". Permite que a skin do Kodi mostre indicadores apropriados nos cards das séries. <premiered> — a data oficial de primeira exibição. Útil para séries de antologia ou animes onde a data do scraper está errada. blocos <fileinfo> — metadados de arquivo pré-armazenados (codec, resolução, faixas de idioma de áudio). Útil se você cria arquivos NFO programaticamente e quer pular a análise de mídia da primeira varredura do Kodi.
Múltiplas fontes de avaliação lado a lado
O Kodi 19+ suporta a exibição de múltiplas fontes de avaliação simultaneamente. Adicione um bloco <ratings> com quantas fontes você quiser:
<ratings>
<rating name="imdb" max="10" default="true">
<value>8.1</value>
<votes>826543</votes>
</rating>
<rating name="themoviedb" max="10">
<value>8.2</value>
<votes>9876</votes>
</rating>
<rating name="rottentomatoes" max="100">
<value>89</value>
<votes>410</votes>
</rating>
</ratings>As skins padrão do Kodi exibem a avaliação "default" com destaque e permitem que você alterne entre as outras na caixa de diálogo de informações. Para bibliotecas onde você selecionou as fontes em que confia, isso é uma melhoria de qualidade de vida significativa em relação à avaliação de fonte única que vem do scraper.
Arquivos NFO de música (artista, álbum, faixa)
Música tem seu próprio formato NFO com três níveis — artista, álbum e por faixa. O NFO de nível de artista vai na raiz da pasta do artista, com o nome artist.nfo:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<artist>
<name>Pink Floyd</name>
<disambiguation>British rock band</disambiguation>
<formed>1965</formed>
<disbanded>2014</disbanded>
<genre>Progressive Rock</genre>
<musicBrainzArtistID>83d91898-7763-47d7-b03b-b92132375c47</musicBrainzArtistID>
</artist>O ID de Artista do MusicBrainz permite que a biblioteca de música do Kodi se vincule à entrada canônica sem correspondência aproximada (fuzzy matching) — extremamente útil para artistas com nomes comuns ou múltiplos projetos. O NFO de nível de álbum (album.nfo na pasta do álbum) aceita campos semelhantes, mais <title>, <year> e <musicBrainzAlbumID>. O NFO por faixa é raramente usado; o modelo de música do Kodi, orientado por tags, lida com as faixas através de tags ID3 em vez de arquivos NFO.
Armadilhas comuns com NFO
Quatro erros que quebram arquivos NFO na prática: 1. XML inválido — caracteres &, < ou > não escapados dentro das tags <plot> ou <title>. A solução: envolva o conteúdo de texto em <![CDATA[...]]> ou escape manualmente (&, <, >). 2. Codificação errada — arquivos NFO DEVEM ser UTF-8. Alguns editores de texto do Windows salvam como Windows-1252 por padrão, o que corrompe caracteres não-ASCII (acentos, cirílico, japonês). Use um editor que suporte UTF-8 (VS Code, Sublime Text, Notepad++). 3. Declaração XML ausente — a primeira linha <?xml version="1.0" encoding="UTF-8" standalone="yes"?> é obrigatória. Sem ela, algumas versões do Kodi simplesmente ignoram o arquivo. 4. Conflitos do NFO com metadados do scraper — se tanto um NFO quanto um scraper fornecerem dados para o mesmo campo, o Kodi prioriza o NFO. Isso geralmente é o que você quer, mas às vezes surpreende usuários que não percebem que seu NFO está sobrescrevendo as atualizações online. Para voltar a usar os dados do scraper, delete o NFO e atualize.
Como os arquivos NFO ficam ao lado da sua mídia
Movies/
└── Blade Runner (1982)/
├── Blade Runner (1982).mkv
├── movie.nfo ← ID do TMDB travado
└── poster.jpg
TV Shows/
└── Breaking Bad (2008)/
├── tvshow.nfo ← ID do TVDB travado
├── Season 01/
│ ├── Breaking Bad - s01e01 - Pilot.mkv
│ └── Breaking Bad - s01e01.nfo ← sobrescrita por episódio (raro)
└── Season 02/Don't want to hand-write NFOs? ou use o gravador de NFO do FileBot.
Solução de Problemas com Nomes no Kodi
Seis falhas cobrem aproximadamente 85% das reclamações sobre nomes no Kodi. Cada uma tem uma causa previsível e uma solução clara.
A biblioteca não escaneia de jeito nenhum — nada acontece ao reescanear
Filme aparece como 'Nenhuma informação encontrada'
Série errada identificada (The Office US vs. The Office UK)
Episódios não identificados, mas a série está correta
Episódios de anime mapeados para as temporadas erradas
A biblioteca mostra metadados antigos e errados mesmo depois de eu corrigir os arquivos
A Alternativa de 60 Segundos
Tudo acima é o jeito manual: entender os scrapers, digitar os nomes de arquivo corretos, escrever arquivos NFO para casos teimosos. Vale a pena fazer uma vez para uma biblioteca nova. Doloroso para uma biblioteca de 2.000 arquivos herdada de anos de downloads desestruturados.
O jeito manual
Manualmente, renomear um item na biblioteca do Kodi leva de 30 a 60 segundos — verificar o título, formatar o ano, acertar o padrão sXXeYY e escrever NFOs para os poucos casos problemáticos. Uma biblioteca de 2.000 arquivos é um fim de semana inteiro de trabalho.
O jeito de 60 segundos
O RenameFlow faz a renomeação em segundos. Arraste uma pasta: o parser detecta se são filmes / séries / animes, consulta TMDB / TheTVDB / AniList / MusicBrainz em paralelo e mostra a prévia da renomeação compatível com o Kodi. Confirme e as renomeações acontecem localmente no seu disco via File System Access API — sem upload. Grátis para os primeiros 15 arquivos por dia; pagamento único de 69 EUR para uso ilimitado. Quanto à geração de arquivos NFO, o RenameFlow não grava NFOs diretamente — mas gera nomes de arquivo que os scrapers padrão do Kodi reconhecem sem problemas, o que elimina a necessidade de NFOs em 90% dos casos. Para os 10% restantes, escrever o NFO à mão é um esforço feito uma única vez.
See Preços do RenameFlow.
Grátis: 15 arquivos/dia, conta gratuita em 30 segundos, sem upload.
Experimente o RenameFlow grátis