Local .nfo metadata
Jellyfin can read and write local .nfo metadata files to import or export metadata from and to other programs and tools.
Naming .nfo files
In order for Jellyfin to find the .nfo files, you have to name them correctly. The table below will help you name them.
| Media Type | Filename |
|---|---|
| Movies | movie.nfo, VIDEO_TS.nfo or for DVDs <filename of the movie>.nfo |
| TV Shows | tvshow.nfo |
| TV Season | season.nfo |
| Episode | <filename of the episode>.nfo |
| Music Artist | artist.nfo |
| Music Album | album.nfo |
| Music Video | see Movies |
Reading metadata from .nfo files
Jellyfin supports a common set of .nfo metadata tags. The following list may not be exhaustive.
If there are multiple tags that map to the same internal Jellyfin data like plot and review, the last of these tags in the file will have priority.
It's currently not possible to disable .nfo metadata. Local metadata will always be fetched and has priority over remote metadata providers like TMDb.
User data importing is only possible for a single user. This user can be set in the .nfo settings.
| Tag | Note |
|---|---|
| name | |
| title | same as name |
| localtitle | same as name |
| dateadded | |
| originaltitle | |
| sortname | |
| criticrating | |
| sorttitle | |
| plot | |
| biography | same as plot |
| review | same as plot |
| language | |
| watched | please see the note about user data |
| playcount | please see the note about user data |
| lastplayed | please see the note about user data |
| countrycode | |
| lockedfields | |
| tagline | |
| country | |
| mpaa | |
| customrating | |
| runtime | |
| aspectratio | |
| lockdata | |
| studio | multiple tags allowed |
| director | multiple tags allowed |
| credits | multiple tags allowed |
| writer | multiple tags allowed |
| actor | multiple tags allowed |
| trailer | kodi format |
| displayorder | |
| year | |
| rating | same as customrating |
| ratings | multiple child tags allowed; name attribute of each tag will specify wheter the rating is critics or community rating |
| aired | |
| formed | |
| premiered | |
| releasedate | |
| enddate | |
| genre | multiple tags allowed |
| tag | multiple tags allowed |
| style | multiple tags allowed |
| fileinfo | |
| uniqueid | type attribute specifies id provider |
| thumb | please see the section about images |
| fanart | please see the section about images |
Provider id tags are supported as well if they follow the scheme: <PROVIDER_NAME+ id>.
You can also use your .nfo files to help Jellyfin identify your media. You can just enter an IMDb, TMDb or TVDb link, to link the media to the specific provider id.
For more information about .nfo files, please also see the Kodi wiki.
Writing metadata to .nfo files
Jellyfin can write metadata to .nfo files. To enable this option, select the "Nfo saver" in the settings of you library. While writing .nfo files, the following tags are supported for saving:
| .nfo tag | Note |
|---|---|
| title | |
| id | IMDb id for moves, TVDb id for tv shows, |
| originaltitle | |
| seasonnumber | only for tv show seasons |
| showtitle | only for tv show episodes |
| episode | only for tv show episode |
| season | only for tv show episode |
| aired | only for tv show episode |
| airsafter_season | only for tv show episode |
| airsbefore_episode | only for tv show episode |
| airsbefore_season | only for tv show episode |
| displayepisode | only for tv show episode; which episode this special airs before |
| displayseason | only for tv show episode; season the special aired in |
| director | new tag for each director |
| writer | new tag for each writer |
| credits | new tag for each credit |
| trailer | YouTube URL in the Kodi format plugin://plugin.video.youtube/?action=play_video&videoid=<Youtube Video ID> |
| rating | |
| year | |
| sorttitle | |
| mpaa | |
| aspectratio | |
| dateadded | in UTC |
| collectionnumber | TMDb collection id |
| set | collection name; only for movies |
| imdb_id | only for TV shows |
| imdbid | for all other media types |
| tvdbid | |
| idmbid | |
| tmdbid | |
| language | |
| countrycode | |
| formed | only for music artists |
| premiered | |
| enddate | |
| releasedate | |
| criticrating | |
| runtime | |
| country | new tag for each production country |
| genre | new tag for each genre |
| studio | new tag for each studio |
| disbanded | only for music artists |
| audiodbartistid | only for music |
| audiodbalbumid | only for |
| zap2itid | only for tv shows |
| musicbrainzalbumid | only for music |
| musicbrainzalbumartistid | only for music |
| musicbrainzartistid | only for music |
| musicbrainzreleasegroupid | only for music |
| tvrageid | |
| art | only if save image paths is enabled in the nfo settings; backdrops with child element fanart, posters with the tag poster |
Additional provider ids are supported as well. They will be exported with the tag <providernameid>.
Image paths and URLs in .nfo files
There are some small caveats to keep in mind when using .nfo files for your images.
- Jellyfin supports only one image for each artwork type. This means that only the first
thumbtag for each artwork type is used. - Artwork defined in .nfo files with local paths or URLs have priority over remote image providers and images in the media folders.