媒體整理指南

快速規則

電影使用 片名 (年份) 資料夾，影片、NFO 與字幕使用相同主檔案名稱。
劇集使用 剧名 (年份)/Season 01/剧名 - S01E01。
NFO 不是掃描或播放的前置條件；沒有 NFO 時，Vanto 會根據目錄名稱和檔案名稱建立媒體結構。
圖片放在其描述物件的約定目錄；只有在沒有可用圖片時，Vanto 才會產生視訊幀封面。
修改 NFO、圖片或字幕後，在 Vanto 首頁刷新目前來源。

推薦原則

目錄結構表達“這是什麼媒體”，NFO 表達“如何展示”，圖片和字幕是獨立的 sidecar 檔案。不要用 NFO 改寫季號、集號或目錄關係。

無 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

沒有 NFO、圖片或字幕也能入庫。電影目錄建議只保留一個主視頻；花絮放入 Extras 子目錄，避免被辨識成正片。年份能顯著降低同名影片配對歧義。

完整電影範例

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

電影優先使用與影片同名的 NFO。 Vanto 也能讀取已有的 movie.nfo，但新建檔案建議使用同名方式，讓多個視訊版本的歸屬保持明確。

<?xml version="1.0" encoding="UTF-8"?>
<movie>
  <title>降临</title>
  <originaltitle>Arrival</originaltitle>
  <year>2016</year>
  <plot>影片简介</plot>
  <genre>科幻</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>

完整劇集範例

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.zh-Hans.forced.ass

這套結構同時保留兩種季約定：

Jellyfin 與 Vanto：讀取季目錄中的 season.nfo、poster.jpg 和 fanart.jpg。
Kodi：季名稱與簡介位於劇根目錄的 tvshow.nfo，季圖片位於劇根目錄並命名為 season01-poster.jpg、season01-fanart.jpg。

兩套文件描述同一個季，內容不應衝突。

整部劇：tvshow.nfo

<?xml version="1.0" encoding="UTF-8"?>
<tvshow>
  <title>示例剧</title>
  <originaltitle>Example Show</originaltitle>
  <year>2026</year>
  <plot>整部剧简介</plot>
  <genre>剧情</genre>
  <uniqueid type="tvdb" default="true">123456</uniqueid>
  <namedseason number="1">第一季</namedseason>
  <seasonplot season="1">第一季简介</seasonplot>
</tvshow>

當季：Season 01/season.nfo

<?xml version="1.0" encoding="UTF-8"?>
<season>
  <title>第一季</title>
  <seasonnumber>1</seasonnumber>
  <plot>第一季简介</plot>
</season>

單集：與影片同名的 NFO

<?xml version="1.0" encoding="UTF-8"?>
<episodedetails>
  <title>第一集</title>
  <showtitle>示例剧</showtitle>
  <season>1</season>
  <episode>1</episode>
  <aired>2026-01-01</aired>
  <plot>本集简介</plot>
</episodedetails>

圖片命名

物件	推薦文件	位置
電影	`poster.jpg`、`fanart.jpg`	電影目錄
整部劇	`poster.jpg`、`fanart.jpg`	劇根目錄
季（Jellyfin / Vanto）	`poster.jpg`、`fanart.jpg`	`Season 01` 目錄
季（Kodi）	`season01-poster.jpg`、`season01-fanart.jpg`	劇根目錄
單集	`Example Show - S01E01-thumb.jpg`	單集影片目錄

建議使用 JPG 或 PNG。 NFO 中的相對圖片檔案名稱必須與真實檔案精確一致。 Vanto 不以類似檔名猜圖，無法確認時寧願不展示，以避免錯誤封面。

外掛字幕

字幕與影片放在同一目錄，並使用完全相同的主檔案名稱：

Arrival (2016).mkv
Arrival (2016).zh-Hans.srt
Arrival (2016).en.forced.ass
Arrival (2016).zh-Hant.vtt

語言可使用 zh-Hans、zh-Hant、en、ja 等標識。
可保留 forced 等常見用途後綴；是否啟用仍由播放器中的字幕選擇決定。
文字字幕支援 SRT、ASS、SSA、VTT 與 SMI。
外掛字幕不寫入 NFO。 NFO 描述媒體，字幕始終是綁定特定影片的獨立檔案。

在 Vanto 中編輯

iPhone、iPad 和 Mac 上的 SMB 與 WebDAV 詳情頁可透過「編輯資訊」為沒有 NFO 的條目創建 NFO，也可以更新電影、整部劇、當前季或當前集的元資料與圖片。儲存成功後，Vanto 會刷新對應目錄並從統一媒體庫重新展示結果。 Apple TV 只讀取和展示這些文件，不提供遠端編輯入口。

寫回範圍

每次只修改編輯頁明確選取的對象，不級聯重寫其他季或單集。儲存前確認 NAS 帳號對目標目錄具有寫入、取代與重新命名權限。

檢查與相容範圍

NFO 使用 UTF-8 XML，根節點必須與物件一致：movie、tvshow、season 或 episodedetails。
單一 NFO 最大 2 MB；Vanto 最多可讀取 32 位元人物。
未知 XML 元素會被忽略，不會阻止影片掃描與播放。
資訊未更新時，先檢查檔案名稱、XML、大小寫、圖片位置與來源寫入權限，再刷新目前來源。

本頁只承諾 Vanto 目前實作與 Jellyfin、Kodi 公共約定的交集。擴充能力請參考 Jellyfin NFO、Jellyfin Movies、Jellyfin Shows、Kodi NFO files 與 Kodi Artwork。