Guia de mídia

Guia de organização de mídia

Um layout SMB e WebDAV conservador que Vanto, Jellyfin e Kodi podem identificar de forma confiável.

Última atualização: 8 de agosto de 2026Para a versão atual do Vanto

Regras rápidas

  • Use um Title (Year) pasta para cada filme e dê ao vídeo, NFO e legendas o mesmo nome base.
  • Usar Show (Year)/Season 01/Show - S01E01 para episódios.
  • Arquivos NFO são opcionais. Sem ele, o Vanto constrói a estrutura de mídia a partir de nomes de pastas e arquivos.
  • Coloque a arte na pasta definida para o item que ela descreve. Vanto gera uma imagem de quadro de vídeo somente quando não existe nenhuma arte adequada.
  • Depois de alterar o NFO, a arte ou as legendas, atualize a fonte atual do Vanto Home.
Modelo recomendado

A estrutura de diretórios diz o que é a mídia; O NFO controla como é apresentado; a arte e as legendas permanecem arquivos secundários independentes. Não use NFO para reescrever relacionamentos de temporada, episódio ou pasta.

Layout mínimo sem NFO

Media/
├── Movies/
│   └── Arrival (2016)/
│       └── Arrival (2016).mkv
└── TV Shows/
    └── Example Show (2026)/
        ├── Season 01/
        │   ├── Example Show - S01E01.mkv
        │   └── Example Show - S01E02.mkv
        └── Season 02/
            └── Example Show - S02E01.mkv

A mídia pode ser indexada sem NFO, arte ou legendas. Mantenha um vídeo principal em uma pasta de filmes. Coloque extras em um Extras subpasta para que não sejam confundidos com o recurso. Incluir o ano de lançamento reduz bastante as correspondências ambíguas.

Exemplo completo de filme

Movies/
└── Arrival (2016)/
    ├── Arrival (2016).mkv
    ├── Arrival (2016).nfo
    ├── poster.jpg
    ├── fanart.jpg
    └── Arrival (2016).en.forced.srt

Prefira um NFO cujo nome base corresponda ao vídeo. Vanto também lê um texto existente movie.nfo, mas os nomes correspondentes mantêm a propriedade clara quando diversas versões de vídeo estão presentes.

<?xml version="1.0" encoding="UTF-8"?>
<movie>
  <title>Arrival</title>
  <originaltitle>Arrival</originaltitle>
  <year>2016</year>
  <plot>Movie summary</plot>
  <genre>Science Fiction</genre>
  <rating>7.9</rating>
  <uniqueid type="tmdb" default="true">329865</uniqueid>
  <actor>
    <name>Amy Adams</name>
    <role>Louise Banks</role>
    <thumb>amy-adams.jpg</thumb>
  </actor>
</movie>

Exemplo de show completo

TV Shows/
└── Example Show (2026)/
    ├── tvshow.nfo
    ├── poster.jpg
    ├── fanart.jpg
    ├── season01-poster.jpg
    ├── season01-fanart.jpg
    └── Season 01/
        ├── season.nfo
        ├── poster.jpg
        ├── fanart.jpg
        ├── Example Show - S01E01.mkv
        ├── Example Show - S01E01.nfo
        ├── Example Show - S01E01-thumb.jpg
        └── Example Show - S01E01.en.forced.ass

Este layout mantém as duas convenções comuns da temporada:

  • Jellyfin e Vanto: leia season.nfo, poster.jpge fanart.jpg dentro da pasta da temporada.
  • Código: lê os nomes das temporadas e resumos do nível do programa tvshow.nfoe arquivos de nível de exibição, como season01-poster.jpg e season01-fanart.jpg.

Ambas as convenções descrevem a mesma época e não devem conter fatos conflitantes.

Programa: tvshow.nfo

<?xml version="1.0" encoding="UTF-8"?>
<tvshow>
  <title>Example Show</title>
  <originaltitle>Example Show</originaltitle>
  <year>2026</year>
  <plot>Show summary</plot>
  <genre>Drama</genre>
  <uniqueid type="tvdb" default="true">123456</uniqueid>
  <namedseason number="1">Season One</namedseason>
  <seasonplot season="1">Season summary</seasonplot>
</tvshow>

Temporada: Temporada 01/season.nfo

<?xml version="1.0" encoding="UTF-8"?>
<season>
  <title>Season One</title>
  <seasonnumber>1</seasonnumber>
  <plot>Season summary</plot>
</season>

Episódio: NFO correspondente ao vídeo

<?xml version="1.0" encoding="UTF-8"?>
<episodedetails>
  <title>Episode One</title>
  <showtitle>Example Show</showtitle>
  <season>1</season>
  <episode>1</episode>
  <aired>2026-01-01</aired>
  <plot>Episode summary</plot>
</episodedetails>

Nomenclatura de obras de arte

ArtigoArquivos recomendadosLocalização
Filmeposter.jpg, fanart.jpgPasta de filmes
Mostrarposter.jpg, fanart.jpgMostrar raiz
Temporada (Jellyfin/Vanto)poster.jpg, fanart.jpgSeason 01
Temporada (Kodi)season01-poster.jpg, season01-fanart.jpgMostrar raiz
EpisódioExample Show - S01E01-thumb.jpgAo lado do vídeo do episódio

Utilize JPG ou PNG. Os nomes relativos das imagens no NFO devem corresponder exatamente aos arquivos reais. Vanto não adivinha por nomes semelhantes; quando a identidade é incerta, deixa a obra de arte vazia em vez de mostrar a imagem errada.

Legendas externas

Arrival (2016).mkv
Arrival (2016).en.srt
Arrival (2016).en.forced.ass
Arrival (2016).zh-Hant.vtt
  • Use tags de idioma como zh-Hans, zh-Hant, en, ou ja.
  • Sufixos comuns como forced poderão ser retidos. A seleção de legendas no player permanece oficial.
  • Os formatos de texto suportados incluem SRT, ASS, SSA, VTT e SMI.
  • Não liste legendas externas no NFO. Eles permanecem arquivos independentes vinculados a um vídeo específico.

Edição em Vanto

No iPhone, iPad e Mac, Editar informações nas páginas de detalhes SMB e WebDAV pode criar um NFO para um item que não possui um ou atualizar metadados e arte de um filme, programa, temporada selecionada ou episódio selecionado. Após um salvamento bem-sucedido, o Vanto atualiza a pasta afetada e renderiza os fatos atualizados da mídia unificada. A Apple TV lê e exibe esses arquivos, mas não expõe a edição remota.

Escopo de gravação

Cada salvamento altera apenas o item selecionado no editor e nunca se transforma em temporadas ou episódios não relacionados. Confirme se a conta NAS pode criar, substituir, renomear e excluir arquivos na pasta de destino.

Verificações e compatibilidade

  • Use XML UTF-8 e o elemento raiz correto: movie, tvshow, season, ou episodedetails.
  • Cada NFO poderá ter até 2 MB; Vanto lê até 32 membros do elenco.
  • Elementos XML desconhecidos são ignorados e não bloqueiam a verificação ou reprodução.
  • Se as alterações não aparecerem, verifique os nomes, XML, caso, localização da arte e permissões de gravação antes de atualizar a fonte.

Esta página documenta a interseção conservadora de Vanto, Jellyfin e Kodi. Para extensões, consulte Jellyfin NFO, Filmes de Jellyfin, Programas de Jellyfin, Arquivos Kodi NFOe Arte Kodi.