Skip to content

Supported Formats and Fields

Kevin Peter Koekemoer edited this page Oct 7, 2026 · 1 revision

🎞️ Supported Formats & Fields

Metadata Editor supports seven distinct NFO and metadata formats out of the box. It automatically detects the format from the root XML element (or text content) when loading a file, and allows you to convert between formats at any time.


πŸ“Š Format Overview

Format Mode Root XML Tag Typical Filenames Supported Media Servers
Movie <movie> movie.nfo, <MovieFileName>.nfo Kodi, Emby, Jellyfin, Plex (via NFO agents), TinyMediaManager
TV Show (Series) <tvshow> tvshow.nfo Kodi, Emby, Jellyfin, Sonarr, TinyMediaManager
TV Episode <episodedetails> / <episode> <EpisodeFileName>.nfo Kodi, Emby, Jellyfin, Sonarr
Music Album <album> album.nfo Kodi, MusicBrainz / Lidarr, Emby, Jellyfin
Music Artist <artist> artist.nfo Kodi, Lidarr, Emby, Jellyfin
Generic XML (Any custom root tag) *.nfo, *.xml Custom media tools, XML databases
Plain Text / Scene ASCII (None β€” raw text) <ReleaseName>.nfo Scene release notes, DOS CP437 / ANSI ASCII art viewers

1. 🎬 Movie (<movie>)

Used for feature films, documentaries, stand-up specials, and home videos.

Mapped Visual Fields

  • Titles:
    • Title (<title>)
    • Original Title (<originaltitle>)
    • Sort Title (<sorttitle>)
  • Dates, Runtime & Ratings:
    • Year (<year>)
    • Premiered Date (<premiered>, <releasedate>)
    • Runtime (mins) (<runtime>)
    • Rating (0-10) (<rating>)
    • Votes (<votes>)
    • Certification / MPAA (<mpaa>, <certification>)
    • Top 250 Rank (<top250>)
  • Story & Plot:
    • Tagline (<tagline>)
    • Plot / Overview (<plot>, <overview>)
    • Short Outline (<outline>)
  • Collections & Tags:
    • Genres (<genre>) β€” supports multiple tags and automatically splits / separated strings.
    • Studios (<studio>)
    • Directors (<director>)
    • Writers / Credits (<credits>, <writer>)
    • Countries (<country>)
  • Movie Set / Franchise:
    • Set Name (<set><name>...</name></set>)
    • Set Overview (<set><overview>...</overview></set>)
  • Cast & Characters (<actor>):
    • Order (<order>)
    • Actor Name (<name>)
    • Character / Role (<role>)
    • Photo URL (<thumb>)
  • Online Identifiers & Links:
    • IMDb ID (<imdbid>, <id>) β€” e.g., tt0097981
    • TMDb ID (<tmdbid>) β€” e.g., 10160
    • TVDb ID (<tvdbid>)
    • Trailer URL (<trailer>)

2. πŸ“Ί TV Show (<tvshow>)

Stored as tvshow.nfo in the root folder of a television series.

Key Fields

Includes all common fields (Title, OriginalTitle, SortTitle, Year, Premiered, Plot, Rating, Votes, MPAA, Genres, Studios, Actors, ImdbId, TmdbId, TvdbId) plus:

  • Series Status (<status>): e.g., Continuing or Ended.

3. 🎞️ TV Episode (<episodedetails>)

Stored alongside individual episode video files (e.g., Breaking Bad - S05E14 - Ozymandias.nfo).

Episode-Specific Fields

When Episode mode is active, the Primary Information card automatically reveals:

  • TV Series / Show Title (<showtitle>)
  • Season # (<season>)
  • Episode # (<episode>)
  • Aired Date (YYYY-MM-DD) (<aired>, <firstaired>)

4. πŸ’Ώ Music Album (<album>) & πŸ‘€ Music Artist (<artist>)

When MusicAlbum or MusicArtist is selected, the visual form enables music-specific metadata cards:

Music Fields

  • Artist / Performer Name (<artist>)
  • Album Name (<album>)
  • Record Label (<label>)
  • Album Type (<type>) β€” e.g., Album, EP, Single, Compilation
  • Review / Biography (<review>, <biography>)
  • Artist Details: ArtistType (Person / Group), Gender, Born, Formed, Disbanded, Died
  • Interactive Album Tracklist (<track>):
    • # (<position>)
    • Track Title (<title>)
    • Duration (<duration>, e.g., 3:45)

5. πŸ“„ Plain Text / Scene ASCII (PlainText)

Many .nfo files distributed with scene releases are not XML files at allβ€”they are plain text release notes decorated with intricate DOS Code Page 437 (CP437) box-drawing and shading characters (β–ˆ, β–“, β–’, β–‘, β•”, ═, β•—).

When Metadata Editor opens a non-XML .nfo file:

  1. It never throws a fatal XML parsing error.
  2. It automatically detects CP437 (DOS / Scene ASCII) encoding so all box-drawing characters render authentically.
  3. It automatically switches to the πŸ“ Raw Text / XML Editor tab in a crisp monospace font.
  4. If you want to replace the scene NFO with a media-server XML NFO, simply use Import β†’ Convert Active Format To β†’ Movie (or select Movie in the Format dropdown).

Clone this wiki locally