Vanto 幫助與法律App Store

Media Guide

媒體整理指南

一套適用於Local、SMB 與WebDAV，並可被Vanto、Jellyfin 和Kodi 穩定識別的建議結構。

最近更新：2026 年 9 月 7 日適用於 Vanto 目前版本

查找影片資料

先補標題、簡短介紹和圖片，其餘按需填寫，不需要學習 XML。

1. 確認是哪部作品

用片名或人物姓名搜尋。季與單集預設搜尋所屬劇名，在網站內核對年份與編號（如 S01E03）；注意翻拍、特別篇及分集順序差異，不改變檔案身分。

2. 選擇參考資料

  • 豆瓣电影

    核對中文片名和別名。

  • IMDb

    核對原名與演職員。

  • TMDB

    查閱電影、影集和人物條目。

3. 查閱並填寫

在 NFO 編輯頁點選「查找資料」。系統地區為中國大陸時預設豆瓣，其他地區預設 TMDB；可切換網站，並在本機記住手動選擇。確認關鍵字後在所選網站查找，進入正確作品或人物條目查閱資料和圖片，再返回手動填寫。網站無法存取時，可手動換站或複製關鍵字。

iPhone 關閉瀏覽介面即可返回；iPad 和 Mac 可將 Vanto 與瀏覽器並排，複製文字或拖入圖片。Apple TV 唯讀，請在 iPhone、iPad 或 Mac 編輯。

4. 匯入圖片

可從照片、檔案、拖放或圖片連結匯入。影片詳情頁網址不是圖片直連；連結匯入失敗時，請使用獲准下載的圖片檔案。海報和人物頭像使用 2:3，背景與單集圖片使用 16:9。

公開可見不代表可以任意使用。請核對來源條款和圖片授權，使用自己的內容或已獲授權的素材。

5. 儲存變更

整部劇、目前季和單集在同一頁編輯，單集只需標題、簡介和圖片。「儲存變更」提交本次編輯中全部已修改項目。App 終止後，尚未儲存的圖片無法復原。

快速規則

  • 一部電影使用一個 片名 (年份) 資料夾，並只保留一個主影片。
  • 劇集使用 剧名 (年份)/Season 01/剧名 - S01E01。
  • NFO 不是掃描或播放的前置條件；沒有 NFO 時，Vanto 會根據目錄名稱和檔案名稱建立媒體結構。
  • 目錄和檔案名稱確定媒體身分；NFO、圖片與字幕只補充展示資訊。
  • 在 Vanto 外修改檔案後，請重新整理來源；在 Vanto 內編輯儲存後，目前片庫會自動更新。
最穩當的原則

保持名稱簡潔並加入年份。不要用NFO 改寫季號、集號或目錄關係，也不要依賴複雜發布組名稱來表達媒體身分。

Media/
├── Movies/
│   └── Arrival (2016)/
│       ├── Arrival (2016).mkv
│       ├── Arrival (2016).nfo
│       ├── poster.jpg
│       ├── fanart.jpg
│       ├── Arrival (2016).zh-Hans.forced.srt
│       ├── Trailers/
│       │   └── trailer.mkv
│       └── Extras/
│           └── making-of.mkv
└── TV Shows/
    └── Example Show (2026)/
        ├── tvshow.nfo
        ├── poster.jpg
        ├── fanart.jpg
        ├── Season 00/
        │   └── Example Show - S00E01.mkv
        └── 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

NFO、圖片和字幕都是可選檔案。只保留影片也能入庫；加入這些檔案後，Vanto 會優先使用明確綁定的本機資訊。

電影

電影目錄建議只放一個主影片。預告片、花絮、樣片和訪談分別放入 Trailers、Extras、Samples 或 Interviews 子目錄，它們可以繼續瀏覽，但不會作為獨立正片進入首頁。

電影優先讀取與影片同名的NFO，也相容於單主影片目錄中的 movie.nfo。當前Vanto 不把同一目錄中的多個視訊合併成一個多版本條目；需要保留多個版本時，請為每個版本建立獨立電影目錄。

查看電影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>
</movie>

劇集、季與單集

劇名來自劇集根目錄，季號來自季目錄，集號來自影片檔名。特別篇使用 Season 00 和 S00E01。包含連續多集的單一影片可以使用 S01E01-E02，但拆分為單集檔案通常能獲得更清晰的播放進度和單集資訊。

整部劇使用 tvshow.nfo，季使用季目錄中的 season.nfo，單集使用與影片同名的NFO。 NFO 中的季號和集號不會改變掃描所得到的目錄關係。

查看劇集、季節和單集NFO 範例

整部劇：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>
</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劇根目錄
季poster.jpg、fanart.jpgSeason 01 目錄
單集Example Show - S01E01-thumb.jpg單集影片目錄

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

缺少圖片

SMB 與 WebDAV 沒有已確認 Sidecar 圖片時直接顯示對應媒體類型的預設封面，不讀取視訊影格，也不把單集截圖繼承給整部劇或季。

外掛字幕

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

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；圖片字幕支援PGS、SUP 以及同名配對的IDX + SUB。
  • 外掛字幕不寫入 NFO。 NFO 描述媒體，字幕始終是綁定特定影片的獨立檔案。
  • 同一語言有多份不同字幕時，從 .2 開始增加序號，例如 Arrival (2016).en.2.srt；相同內容不會重複儲存。

來源與編輯能力

在 iPhone、iPad 和 Mac 上，連接可寫入的 SMB 或 WebDAV，即可免費編輯 NFO。Apple TV 支援讀取，不提供編輯。

編輯電影與整部影集的標題、簡介、圖片和演職人員。

在同一頁切換季與單集；單集只保留標題、簡介和封面，編輯更輕鬆。

季可編輯標題、簡介、海報與背景；單集只編輯標題、簡介與 16:9 封面，不提供評分、播出日期或演職人員編輯。

來源掃描與讀取在Vanto 中寫回
Local影片、NFO、圖片與字幕不提供；請在檔案系統中管理
SMB / WebDAV影片、NFO、圖片與字幕iPhone、iPad 與Mac 支持，取決於目錄權限
Apple TV讀取並展示已掃描內容只讀

iPhone、iPad 和 Mac 上可寫入的 SMB 與 WebDAV 詳情頁可以建立或更新電影、整部劇、目前季或目前集的 NFO 與圖片。演員頭像按 2:3 裁剪為 JPG，電影儲存在媒體目錄的 .actors，劇集、季和單集共用劇根目錄的 .actors，並由 NFO 的標準 <actor><thumb> 相對路徑引用；刪除頭像只移除引用，不自動刪除可能重複使用的檔案。線上下載或從檔案匯入的字幕預設按上述命名寫入視訊所在目錄，成功後同一 NAS 來源的其他裝置也可在重新整理後使用；Vanto 不再額外保留一份裝置副本。NAS 明確沒有寫入成功時，可由使用者選擇僅儲存到目前裝置。Apple TV 不寫回 NAS，線上字幕只儲存在目前裝置。

寫回範圍

一次儲存本次工作階段中已修改的草稿，不重寫未修改的季或單集。儲存前確認 NAS 帳號具有目標目錄的建立、替換、重新命名與刪除權限。

相容與高級規則

查看Jellyfin、Kodi 與其他可識別命名
  • 為了相容於Kodi，可以在劇集根目錄中額外放置 season01-poster.jpg 和 season01-fanart.jpg。 Vanto 與Jellyfin 的推薦結構仍是季目錄中的 poster.jpg 和 fanart.jpg。
  • 人物使用標準 director、credits 和帶 name / role / order / thumb 的 actor；Vanto 不為導演或編劇建立私有頭像欄位。
  • Kodi 使用的 namedseason、seasonplot 等季級欄位可以保留在 tvshow.nfo，但Vanto 的季標題與簡介以季目錄中的 season.nfo 為準。
  • Vanto 還能辨識 1x01、在地化季目錄和其他常見命名；新整理的媒體仍建議統一使用本頁主結構。
  • 標題存在歧義時，優先在NFO 中寫入明確的 uniqueid，不要依賴不同應用各自的檔案名稱ID 擴充。

檢查與排查

  • 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。