NFO files/Movies: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Updated for v19)
Line 1: Line 1:
{{NFO_content}}
{{NFO_content}}
{{mininav|[[NFO files]]}}
{{mininav|[[NFO files]]}}


__TOC__




= General =
= Introduction =
The order of importing metadata is as follows:
NFO files to be scraped into the movie library are relatively simple and require only a single nfo file per title.
#nfo file. If no nfo file exists then
#Depending on your scraper settings for your source, either
#*Online scraper sites- if a scraper is set in your source settings, or
#*Nothing- if Local Info Only is set
 
When Kodi locates the nfo file it will load the *.nfo file and:
#If the file is a metadata nfo, Kodi will import the meta-data directly into the library from the .nfo file or
#If the file is a parsing nfo, Kodi will parse the nfo file for a direct URL to the scraper info page, then scrape the online metadata. '''''See: [[NFO_files#Parsing_nfo|Parsing NFO]]'''''
#If the file is a combination nfo, Kodi will parse the nfo file and scrape the online metadata, then import the metadata from the nfo file. '''''See: [[NFO_files#Combination_nfo|Combination NFO]]'''''
 
 
 
== Known Issues ==
* v18 introduced a bug where any class of nfo file can be scanned into any part of the video library. See [https://github.com/xbmc/xbmc/issues/16112 Issue 16112]




Line 27: Line 13:
'''{{resize|1.2em|Regardless of what settings you have set for the source and scraper, {{Kodi}} will always search for and scan the nfo file first where available.}}'''
'''{{resize|1.2em|Regardless of what settings you have set for the source and scraper, {{Kodi}} will always search for and scan the nfo file first where available.}}'''


Correct placement of the nfo file is essential. Failing to save the file with the correct name and in the correct location, as detailed below, will force Kodi to either:
There are two naming schemes for movie nfo files. Both are explained and {{kodi}} recommends using the ''<VideoFileName>.nfo'' format.
#Scrape the metadata from the online source set in your scraper or,
#If you have ''Local Info Only'' set as your scraper, then no entry will be made into the library.
 


<section begin="MovieNFONaming" />;<VideoFileName>.nfo
<section begin="MovieNFONaming" />;<VideoFileName>.nfo
:*NFO Files are named the same as the video file except with the ''.nfo'' extension. See image below.
:*NFO Files are named the same as the video file except with the ''.nfo'' extension.
:*We recommend using this format to name nfo files.
:*We recommend using this filename format to name nfo files.


;movie.nfo
;movie.nfo
:{{Kodi}} may also scan nfo files named '''''movie.nfo'''''. To use this name, the setting '''Movies are in separate folders that match the movie title''' must be '''Enabled''' in the [[Adding_video_sources#Set_Content|Set Content Screen]].
:{{Kodi}} may also scan nfo files named '''''movie.nfo'''''. To use this name, the setting '''Movies are in separate folders that match the movie title''' must be '''Enabled''' in the '''[[Adding_video_sources#Set_Content|Set Content Screen]]'''
:*If the above setting is not enabled, {{kodi}} will ignore the ''movie.nfo''. If the ''<VideoFileName>.nfo'' formatted file is available, {{kodi}} will scan this one instead, otherwise an online scrape will be performed.
:*If the above setting is not enabled, {{kodi}} will ignore the ''movie.nfo''. If the ''<VideoFileName>.nfo'' file is available, {{kodi}} will scan this one instead, otherwise an online scrape will be performed if a valid scraper is set for the Source.
:*If you use ''movie.nfo'' and later Export your library to Separate Files, {{kodi}} will still create the nfo file in the ''<VideoFileName>.nfo'' format and two nfo files will exist. If a Refresh or rescan is run in future, the ''<VideoFileName>.nfo'' file will be ignored in favour of ''movie.nfo'', which means any changes you may have made to the library entry (play counts, watched status etc) will not be re-scanned back into the library.
:*If you use ''movie.nfo'' and later Export your library to Separate Files, {{kodi}} will still create the nfo file in the ''<VideoFileName>.nfo'' format and two nfo files will exist. If a Refresh or rescan is run in future, and the above setting is still enabled, the ''<VideoFileName>.nfo'' file will be ignored in favour of ''movie.nfo'', which means any changes you may have made to the library entry (play counts, watched status etc) will not be re-scanned back into the library.
:*We recommend using the ''<VideoFileName>.nfo'' format name for nfo files to avoid the above traps.<section end="MovieNFONaming" />
:*We recommend using the ''<VideoFileName>.nfo'' format for nfo files to avoid the above traps.<section end="MovieNFONaming" />


The below image details naming and location for Single File, DVD and Bluray movies:


Movies require one nfo file. The below image details naming and location for Single File, DVD and Bluray movies:
<gallery mode="packed" widths="1000px" heights="562px">
<gallery mode="packed" widths="1000px" heights="562px">
File:LocalMovieArtwork01.jpg|'''''Example of correct use of Movie Folder with artwork, nfo file, trailer and theme.<br> Take note of file naming and location.'''''
File:LocalMovieArtwork01.jpg|'''''Example of correct use of Movie Folder with artwork, nfo file, trailer and theme.<br> Take note of file naming and location.'''''
</gallery>
</gallery>


= nfo Tags =
The following table lists most available XML tags. Some system generated tags are ommitted and are not required if you are creating your own nfo files as {{kodi}} will create the missing XML tags internally. <ref>https://github.com/xbmc/xbmc/blob/master/xbmc/video/VideoInfoTag.cpp</ref>


Two XML tags are required and are indicated in the table below. All other tags are optional. Of course the less tags used, the less information scanned into the library.


Children tags are displayed correctly with parent tags. The list is ordered in the same order as the exported nfo file.
= nfo Tags =
The following table lists available XML tags. <ref>https://github.com/xbmc/xbmc/blob/master/xbmc/video/VideoInfoTag.cpp</ref>


The "Required" column indicates whether a tag can be optionally added or ommitted when creating the nfo to suit your purpose. The less tags used, the less information added to the library.


{|class="prettytable"
{|class="prettytable"
! width=430px | NFO (xml) Tag || Required || Multiple || Notes
! width=430px | NFO (xml) Tag || Required || Multiple || Notes
|-
|-
|<movie></movie> || scope="cell" ! style="background-color:#ff9c95;" | Yes || No || The top level parent tag for the nfo file. All other tags must be contained within these two tags
|<movie></movie> || {{Yes}} || No || The top level parent tag for the nfo file. All other tags must be contained within these two tags
|-
|-
|<title></title> || No || No || The title for the movie
|<title></title> || {{Yes}} || No || The title for the movie
|-
|-
|<originaltitle></originaltitle> || No || No || Displays the original title of the movie. <br>
|<originaltitle></originaltitle> || No || No || Displays the original title of the movie. <br>
Line 76: Line 58:
   </ratings>
   </ratings>
|| No || No || ''default="true"''  ''default="false"''<br>
|| No || No || ''default="true"''  ''default="false"''<br>
::Only one rating can be set as ''default="true"'', additional ratings must be set as ''default="false"'' or ommitted<br>
::Only one rating can be set as ''default="true"'', additional ratings must be set as ''default="false"'' or omit the default attribute<br>


''name="identifier"''. Do not use "default". Examples of identifier include...<br>
''name="identifier"''. Do not use "default". Examples of identifier include...<br>
Line 98: Line 80:
|<plot></plot> ||  ||  || Can contain more information on multiple lines, will be wrapped
|<plot></plot> ||  ||  || Can contain more information on multiple lines, will be wrapped
|-
|-
|<tagline></tagline> || No || No || Short movie slogan. "The true story of a real fake" is the tagline for "Catch me if you can  
|<tagline></tagline> || No || No || Short movie slogan. "The true story of a real fake" is the tagline for "Catch me if you can"
|-
|-
|<runtime></runtime> || No || No || Minutes only. Overwritten when movie played
|<runtime></runtime> || No || No || Minutes only. If ommitted, {{kodi}} will add runtime upon scanning
|-
|-
|<thumb aspect="" preview=""></thumb> || No || Yes || Path to available Movie Posters<br>
|<thumb aspect="" preview=""></thumb> || No || Yes || Path to available Movie Posters. Not needed when using local artwork<br>
Example use of ''aspect=""''
Example use of ''aspect=""''
:<thumb aspect="banner"
:<thumb aspect="banner"
Line 108: Line 90:
:<thumb aspect="clearlogo"
:<thumb aspect="clearlogo"
:<thumb aspect="discart"
:<thumb aspect="discart"
:<thumb aspect="keyart"
:<thumb aspect="landscape"
:<thumb aspect="landscape"
: <thumb aspect="poster"
:<thumb aspect="poster"
|-
|-
|
|
Line 118: Line 101:
:^ Multiple <thumb> entries allowed between the <fanart></fanart> tags
:^ Multiple <thumb> entries allowed between the <fanart></fanart> tags
|-
|-
|<mpaa></mpaa> || No || No || Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country local rating system
|<mpaa></mpaa> || No || No || Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country certification flags
|-
|-
|<playcount></playcount> || No || No || Number of times movie has been played.<br>
|<playcount></playcount> || No || No || Number of times movie has been played.<br>See... [[Import-export_library/Video#Watched.2C_PlayCount.2C_ResumePoints|Import-Export]]
Setting this to 1 or greater will mark the movie as watched if the ''importwatchedstate'' flag is set in advancedsettings.xml
|-
|-
|<lastplayed></lastplayed> || No || No || Date movie was last played
|<lastplayed></lastplayed> || No || No || Date last played as ''yyyy-mm-dd''
|-
|-
|<id></id> || No || No || The default ID. <br>
|<id></id> || No || No || The default ID. <br>
Do not use as this is a Kodi generated tag. See next item.
Do not use. This is a Kodi generated tag. See next item.
|-
|-
|<uniqueid type="xxxx" default="true"></uniqueid> || scope="cell" ! style="background-color:#ff9c95;" | Yes || Yes ||The ID from the scraper site.<br>
|<uniqueid type="" default=""></uniqueid> || {{Yes}} || Yes ||The ID from the scraper site.<br>
''type="xxxx"'' = Identifier of the ID. Do not use "default". Examples of identifier include...<br>
''type=""'' Identifier of the ID. Do not use "default". Examples of identifier include...<br>
::''<uniqueid type="imdb">''<br>
::''<uniqueid type="imdb"''<br>
::''<uniqueid type="tvdb">''<br>
::''<uniqueid type="tvdb"''<br>
::''<uniqueid type="tmdb">''<br>
::''<uniqueid type="tmdb"''<br>
::For non-scraped items, use simple values like ''"home", "sport", "doco"'' etc<br>
::For non-scraped items, use simple values like ''"home", "sport", "doco"'' etc<br>
::The value can be alpha-numeric eg ''tt3480556'' for imdb, ''286668'' for tmdb, ''home001'' for home movies, etc<br>
::The value can be alpha-numeric eg ''tt3480556'' for imdb, ''286668'' for tmdb, ''home001'' for home movies, etc<br>
''default="true"''  ''default="false"''<br>
''default="true"''  ''default="false"''<br>
::Only one uniqueID can be set as ''default="true"'', additional uniqueID's must be set as ''default="false"'' or ommitted<br>
::Only one uniqueID can be set as ''default="true"'', additional uniqueID's must be set as ''default="false"'' or ommit the default attribute<br>
Example of complete entry...
Example of complete entry...
::''<uniqueid type="tmdb" default="true">''<br>
::''<uniqueid type="tmdb" default="true">''<br>
Line 143: Line 125:
|<genre></genre> || No || Yes || Movie genre.  
|<genre></genre> || No || Yes || Movie genre.  
|-
|-
|<country></country> || No || Yes || Country of origin
|<tag></tag> || No || Yes || Library Tags. See...'''[[Video library tags]]'''
|-
|-
|
|
Line 152: Line 134:
|| No || No || Movie set tags <br />
|| No || No || Movie set tags <br />
The <overview> tag allows a short summary of the movie set. It can be displayed by some skins.
The <overview> tag allows a short summary of the movie set. It can be displayed by some skins.
<br />See... '''[[Movie sets]]'''
|-
|-
|<tag></tag> || No || Yes || Movie tags. See: ''[[Video library tags]]''
|<country></country> || No || Yes || Country of origin
|-
|-
|<credits></credits> || No || Yes || Field for writers.
|<credits></credits> || No || Yes || Field for writers.
Line 159: Line 142:
|<director></director> || No || Yes || Movie Director
|<director></director> || No || Yes || Movie Director
|-
|-
|<premiered></premiered> || No || No || Release date of movie. Format as ''2019-01-31''
|<premiered></premiered> || No || No || Release date of movie. Format as ''yyyy-mm-dd''
|-
|-
|<year></year> || No || No || Release Year.<br>
|<year></year> || No || No || Release Year.<br>
Line 172: Line 155:
|<studio></studio> || No || Yes || Production studio
|<studio></studio> || No || Yes || Production studio
|-
|-
|<trailer></trailer> || No || No || Local or online path to movie trailer  
|<trailer></trailer> || No || No || Local or online path to movie trailer<br> Do not add local path to trailer. {{kodi}} will automatically scan for local trailers.<br> See... '''[[Trailers]]'''
|-
|-
|
|
Line 215: Line 198:
   <total></total>
   <total></total>
  </resume>
  </resume>
|| No || No || Movie resume point in Seconds
|| No || No || Movie resume point in Seconds<br>See... [[Import-export_library/Video#Watched.2C_PlayCount.2C_ResumePoints|Import-Export]]
|-
|-
|<dateadded></dateadded> || No || No || mTime of the playable video file. Can be altered in advancedsettings.xml
|<dateadded></dateadded> || No || No || mTime of the playable video file. Can be altered in advancedsettings.xml<br>See... '''[[Advancedsettings.xml#videolibrary]]'''
|}
|}
= Template nfo =
A template NFO File is provided below that can be copied into your own file and completed. It is a simplified file:
*System generated tags are removed
*Assumes local artwork is being used
*Assumes no online information is available, so items like Ratings have no relevance
*This will be the first time scanned into library so watched status and play counts are not required.
If any of these removed tags are required, simply add the appropriate tags, and refer to the Sample NFO File in the next section to confirm correct usage.
<syntaxhighlight lang="xml" line='line'>
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<movie>
    <title></title>
    <originaltitle></originaltitle>
    <userrating>0</userrating>
    <outline></outline>
    <plot></plot>
    <tagline></tagline>
    <runtime></runtime>
    <mpaa></mpaa>
    <uniqueid type="" default="true"></uniqueid>
    <genre></genre>
    <country></country>
    <credits></credits>
    <director></director>
    <premiered></premiered>
    <studio></studio>
    <actor>
        <name></name>
        <role></role>
        <order></order>
        <thumb></thumb>
    </actor>
</movie>
</syntaxhighlight>
= Sample nfo =
Below is a sample nfo file that was exported from Kodi after scraping into the library using the Universal Movie Scraper.
'''Press Expand at right edge of the green bar to view'''
{{collapse top| Movie nfo file  (click 'expand' to view)}}
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<movie>
    <title>Justice League</title>
    <originaltitle>Justice League</originaltitle>
    <ratings>
        <rating name="imdb" max="10" default="true">
            <value>6.400000</value>
            <votes>335583</votes>
        </rating>
        <rating name="metacritic" max="10">
            <value>4.500000</value>
            <votes>52</votes>
        </rating>
        <rating name="themoviedb" max="10">
            <value>6.200000</value>
            <votes>7788</votes>
        </rating>
<rating name="tomatometerallcritics" max="10">
<value>7.6</value>
<votes>71</votes>
</rating>
<rating name="tomatometerallaudience" max="10">
<value>6.2</value>
<votes>119873</votes>
</rating>
    </ratings>
    <userrating>0</userrating>
    <top250>0</top250>
    <outline>Fueled by his restored faith in humanity and inspired by Superman&apos;s selfless act, Bruce Wayne enlists the help of his new-found ally, Diana Prince, to face an even greater enemy.</outline>
    <plot>Fueled by his restored faith in humanity and inspired by Superman&apos;s selfless act, Bruce Wayne enlists the help of his newfound ally, Diana Prince, to face an even greater enemy. Together, Batman and Wonder Woman work quickly to find and recruit a team of meta-humans to stand against this newly awakened threat. But despite the formation of this unprecedented league of heroes-Batman, Wonder Woman, Aquaman, Cyborg and The Flash-it may already be too late to save the planet from an assault of catastrophic proportions.</plot>
    <tagline>Justice for all.</tagline>
    <runtime>120</runtime>
    <thumb aspect="set.poster" preview="https://assets.fanart.tv/preview/movies/468551/movieposter/justice-league-collection-5c24ea65591d3.jpg">https://assets.fanart.tv/fanart/movies/468551/movieposter/justice-league-collection-5c24ea65591d3.jpg</thumb>
    <thumb aspect="set.poster" preview="https://assets.fanart.tv/preview/movies/468551/movieposter/justice-league-collection-5c24ea65591d3.jpg">https://assets.fanart.tv/fanart/movies/468551/movieposter/justice-league-collection-5c24ea65591d3.jpg</thumb>
    <thumb aspect="set.clearlogo" preview="https://assets.fanart.tv/preview/movies/468551/hdmovielogo/justice-league-collection-5ba855ed4239a.png">https://assets.fanart.tv/fanart/movies/468551/hdmovielogo/justice-league-collection-5ba855ed4239a.png</thumb>
    <thumb aspect="set.clearart" preview="https://assets.fanart.tv/preview/movies/468551/hdmovieclearart/justice-league-collection-5c24eae8d4d71.png">https://assets.fanart.tv/fanart/movies/468551/hdmovieclearart/justice-league-collection-5c24eae8d4d71.png</thumb>
    <thumb aspect="set.landscape" preview="https://assets.fanart.tv/preview/movies/468551/moviethumb/justice-league-collection-5c24ebc7d0d2b.jpg">https://assets.fanart.tv/fanart/movies/468551/moviethumb/justice-league-collection-5c24ebc7d0d2b.jpg</thumb>
    <thumb aspect="set.poster" preview="http://image.tmdb.org/t/p/w500/cigoYpXWgYYgsIsEPwMneVYpuwo.jpg">http://image.tmdb.org/t/p/original/cigoYpXWgYYgsIsEPwMneVYpuwo.jpg</thumb>
    <thumb aspect="set.poster" preview="http://image.tmdb.org/t/p/w500/2ZOCiOdAOVSKsFjC1Vl2ZlANrPj.jpg">http://image.tmdb.org/t/p/original/2ZOCiOdAOVSKsFjC1Vl2ZlANrPj.jpg</thumb>
    <thumb aspect="set.poster" preview="http://image.tmdb.org/t/p/w500/cigoYpXWgYYgsIsEPwMneVYpuwo.jpg">http://image.tmdb.org/t/p/original/cigoYpXWgYYgsIsEPwMneVYpuwo.jpg</thumb>
    <thumb aspect="set.poster" preview="http://image.tmdb.org/t/p/w500/2ZOCiOdAOVSKsFjC1Vl2ZlANrPj.jpg">http://image.tmdb.org/t/p/original/2ZOCiOdAOVSKsFjC1Vl2ZlANrPj.jpg</thumb>
    <thumb aspect="set.poster" preview="http://image.tmdb.org/t/p/w500/7iO1C4c5igXsB6AyxnqsCPv6fiq.jpg">http://image.tmdb.org/t/p/original/7iO1C4c5igXsB6AyxnqsCPv6fiq.jpg</thumb>
    <thumb aspect="set.fanart" preview="http://image.tmdb.org/t/p/w500/vyxOJuk6cxrRcGzuMRbDTpwji1w.jpg">http://image.tmdb.org/t/p/original/vyxOJuk6cxrRcGzuMRbDTpwji1w.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/9rtrRGeRnL0JKtu9IMBWsmlmmZz.jpg">http://image.tmdb.org/t/p/original/9rtrRGeRnL0JKtu9IMBWsmlmmZz.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/eRoXqOzciHkSPs1Z8pGnJMZo0Zb.jpg">http://image.tmdb.org/t/p/original/eRoXqOzciHkSPs1Z8pGnJMZo0Zb.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/aQkEdqaXVxYObMLeoBSAUcgkxLs.jpg">http://image.tmdb.org/t/p/original/aQkEdqaXVxYObMLeoBSAUcgkxLs.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/4lo1fTexk2eNIeQx3Tp74kN7ASE.jpg">http://image.tmdb.org/t/p/original/4lo1fTexk2eNIeQx3Tp74kN7ASE.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/fF94rvT1kJpVzIE2aSYgYj9B3pc.jpg">http://image.tmdb.org/t/p/original/fF94rvT1kJpVzIE2aSYgYj9B3pc.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/uwegp70cWe16EtwsSjbL6ShPenG.jpg">http://image.tmdb.org/t/p/original/uwegp70cWe16EtwsSjbL6ShPenG.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/exLtrlI7JjKcfQVTccI7XdQRFMz.jpg">http://image.tmdb.org/t/p/original/exLtrlI7JjKcfQVTccI7XdQRFMz.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/paLcue01KpfQftorfjKqqD4qvlL.jpg">http://image.tmdb.org/t/p/original/paLcue01KpfQftorfjKqqD4qvlL.jpg</thumb>
    <thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/yVDIfiKIsCbdFcgLXW34bAsnQvy.jpg">http://image.tmdb.org/t/p/original/yVDIfiKIsCbdFcgLXW34bAsnQvy.jpg</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/movies/141052/hdmovielogo/justice-league-5865bf95cbadb.png">https://assets.fanart.tv/fanart/movies/141052/hdmovielogo/justice-league-5865bf95cbadb.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/movies/141052/hdmovielogo/justice-league-585e9ca3bcf6a.png">https://assets.fanart.tv/fanart/movies/141052/hdmovielogo/justice-league-585e9ca3bcf6a.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/movies/141052/hdmovielogo/justice-league-57b476a831d74.png">https://assets.fanart.tv/fanart/movies/141052/hdmovielogo/justice-league-57b476a831d74.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/movies/141052/hdmovielogo/justice-league-57947e28cf10b.png">https://assets.fanart.tv/fanart/movies/141052/hdmovielogo/justice-league-57947e28cf10b.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/movies/141052/hdmovielogo/justice-league-5863d5c0cf0c9.png">https://assets.fanart.tv/fanart/movies/141052/hdmovielogo/justice-league-5863d5c0cf0c9.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/movies/141052/hdmovielogo/justice-league-5a801747e5545.png">https://assets.fanart.tv/fanart/movies/141052/hdmovielogo/justice-league-5a801747e5545.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/movies/141052/hdmovielogo/justice-league-5cd75683df92b.png">https://assets.fanart.tv/fanart/movies/141052/hdmovielogo/justice-league-5cd75683df92b.png</thumb>
    <thumb aspect="banner" preview="https://assets.fanart.tv/preview/movies/141052/moviebanner/justice-league-586017e95adbd.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebanner/justice-league-586017e95adbd.jpg</thumb>
    <thumb aspect="banner" preview="https://assets.fanart.tv/preview/movies/141052/moviebanner/justice-league-5934d45bc6592.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebanner/justice-league-5934d45bc6592.jpg</thumb>
    <thumb aspect="banner" preview="https://assets.fanart.tv/preview/movies/141052/moviebanner/justice-league-5aa9289a379fa.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebanner/justice-league-5aa9289a379fa.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/movies/141052/moviethumb/justice-league-585fb155c3743.jpg">https://assets.fanart.tv/fanart/movies/141052/moviethumb/justice-league-585fb155c3743.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/movies/141052/moviethumb/justice-league-585edbda91d82.jpg">https://assets.fanart.tv/fanart/movies/141052/moviethumb/justice-league-585edbda91d82.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/movies/141052/moviethumb/justice-league-5b86588882c12.jpg">https://assets.fanart.tv/fanart/movies/141052/moviethumb/justice-league-5b86588882c12.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/movies/141052/moviethumb/justice-league-5bbb9babe600c.jpg">https://assets.fanart.tv/fanart/movies/141052/moviethumb/justice-league-5bbb9babe600c.jpg</thumb>
    <thumb aspect="clearart" preview="https://assets.fanart.tv/preview/movies/141052/hdmovieclearart/justice-league-5865c23193041.png">https://assets.fanart.tv/fanart/movies/141052/hdmovieclearart/justice-league-5865c23193041.png</thumb>
    <thumb aspect="discart" preview="https://assets.fanart.tv/preview/movies/141052/moviedisc/justice-league-5a3af26360617.png">https://assets.fanart.tv/fanart/movies/141052/moviedisc/justice-league-5a3af26360617.png</thumb>
    <thumb aspect="discart" preview="https://assets.fanart.tv/preview/movies/141052/moviedisc/justice-league-58690967b9765.png">https://assets.fanart.tv/fanart/movies/141052/moviedisc/justice-league-58690967b9765.png</thumb>
    <thumb aspect="discart" preview="https://assets.fanart.tv/preview/movies/141052/moviedisc/justice-league-5a953ca4db6a6.png">https://assets.fanart.tv/fanart/movies/141052/moviedisc/justice-league-5a953ca4db6a6.png</thumb>
    <thumb aspect="discart" preview="https://assets.fanart.tv/preview/movies/141052/moviedisc/justice-league-5a0b913c233be.png">https://assets.fanart.tv/fanart/movies/141052/moviedisc/justice-league-5a0b913c233be.png</thumb>
    <thumb aspect="discart" preview="https://assets.fanart.tv/preview/movies/141052/moviedisc/justice-league-5a87e0cdb1209.png">https://assets.fanart.tv/fanart/movies/141052/moviedisc/justice-league-5a87e0cdb1209.png</thumb>
    <thumb aspect="discart" preview="https://assets.fanart.tv/preview/movies/141052/moviedisc/justice-league-59dc595362ef1.png">https://assets.fanart.tv/fanart/movies/141052/moviedisc/justice-league-59dc595362ef1.png</thumb>
    <fanart>
        <thumb preview="https://assets.fanart.tv/preview/movies/141052/moviebackground/justice-league-5793f518c6d6e.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebackground/justice-league-5793f518c6d6e.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/movies/141052/moviebackground/justice-league-5a5332c7b5e77.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebackground/justice-league-5a5332c7b5e77.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/movies/141052/moviebackground/justice-league-5a53cf2dac1c8.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebackground/justice-league-5a53cf2dac1c8.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/movies/141052/moviebackground/justice-league-5976ba93eb5d3.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebackground/justice-league-5976ba93eb5d3.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/movies/141052/moviebackground/justice-league-58fa1f1932897.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebackground/justice-league-58fa1f1932897.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/movies/141052/moviebackground/justice-league-5a14f5fd8dd16.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebackground/justice-league-5a14f5fd8dd16.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/movies/141052/moviebackground/justice-league-5a119394ea362.jpg">https://assets.fanart.tv/fanart/movies/141052/moviebackground/justice-league-5a119394ea362.jpg</thumb>
    </fanart>
    <mpaa>Australia:M</mpaa>
    <playcount>0</playcount>
    <lastplayed></lastplayed>
    <id>tt0974015</id>
    <uniqueid type="imdb" default="true">tt0974015</uniqueid>
    <genre>Action</genre>
    <genre>Adventure</genre>
    <genre>Fantasy</genre>
    <genre>Sci-Fi</genre>
    <country>USA</country>
    <country>Canada</country>
    <country>UK</country>
    <set>
        <name>Justice League Collection</name>
        <overview>Based on the DC Comics superhero team</overview>
    </set>
    <credits>Jerry Siegel</credits>
    <credits>Joe Shuster</credits>
    <director>Zack Snyder</director>
    <premiered>2017-11-15</premiered>
    <year>2017</year>
    <status></status>
    <code></code>
    <aired></aired>
    <studio>DC Comics</studio>
    <trailer></trailer>
    <fileinfo>
        <streamdetails>
            <video>
                <codec>h264</codec>
                <aspect>1.777778</aspect>
                <width>1920</width>
                <height>1080</height>
                <durationinseconds>6268</durationinseconds>
                <stereomode></stereomode>
            </video>
            <audio>
                <codec>truehd</codec>
                <language>eng</language>
                <channels>8</channels>
            </audio>
            <audio>
                <codec>ac3</codec>
                <language></language>
                <channels>6</channels>
            </audio>
            <subtitle>
                <language>eng</language>
            </subtitle>
        </streamdetails>
    </fileinfo>
    <actor>
        <name>Ben Affleck</name>
        <role>Batman</role>
        <order>0</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMTI4MzIxMTk0Nl5BMl5BanBnXkFtZTcwOTU5NjA0Mg@@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Henry Cavill</name>
        <role>Superman</role>
        <order>1</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMTUxNTExMzUzOF5BMl5BanBnXkFtZTgwOTI1MjA3OTE@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Amy Adams</name>
        <role>Lois Lane</role>
        <order>2</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMTg2NTk2MTgxMV5BMl5BanBnXkFtZTgwNjcxMjAzMTI@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Gal Gadot</name>
        <role>Wonder Woman</role>
        <order>3</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMjUzZTJmZDItODRjYS00ZGRhLTg2NWQtOGE0YjJhNWVlMjNjXkEyXkFqcGdeQXVyMTg4NDI0NDM@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Ezra Miller</name>
        <role>The Flash</role>
        <order>4</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMjEwMjQ3ODgxOV5BMl5BanBnXkFtZTgwNzc4NjE4NTE@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Jason Momoa</name>
        <role>Aquaman</role>
        <order>5</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMTI5MTU5NjM1MV5BMl5BanBnXkFtZTcwODc4MDk0Mw@@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Ray Fisher</name>
        <role>Cyborg</role>
        <order>6</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BYzdhMzkyYTgtMjQzMC00ODhmLWExZmItNTU4MDVlMzY2NzgwXkEyXkFqcGdeQXVyNzA5NjQ5MDk@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Jeremy Irons</name>
        <role>Alfred</role>
        <order>7</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMTY5Mzg2NDY5OV5BMl5BanBnXkFtZTcwMDQwNzA0Mg@@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Diane Lane</name>
        <role>Martha Kent</role>
        <order>8</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMzM5ODM1ZWMtZjcyYy00MzgzLWJmMGQtZWY5OGQyNTRiODIxXkEyXkFqcGdeQXVyOTE0NjgwMjY@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Connie Nielsen</name>
        <role>Queen Hippolyta</role>
        <order>9</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BYzZiYTQ4YTAtMzRkMi00ZDZlLWFkZWItNGI2ZTIyODRiYTc4XkEyXkFqcGdeQXVyMjUzMjc2MjE@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>J.K. Simmons</name>
        <role>Commissioner Gordon</role>
        <order>10</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMzg2NTI5NzQ1MV5BMl5BanBnXkFtZTgwNjI1NDEwMDI@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Ciarán Hinds</name>
        <role>Steppenwolf</role>
        <order>11</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMTIyNjM0MzU0NF5BMl5BanBnXkFtZTcwOTIxMzg1MQ@@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Amber Heard</name>
        <role>Mera</role>
        <order>12</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMjA4NDkyODA3M15BMl5BanBnXkFtZTgwMzUzMjYzNzM@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Joe Morton</name>
        <role>Silas Stone</role>
        <order>13</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BMTQ1MjYwMTQ2MF5BMl5BanBnXkFtZTgwNzI4MTA0NDE@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <actor>
        <name>Lisa Loven Kongsli</name>
        <role>Menalippe</role>
        <order>14</order>
        <thumb>https://m.media-amazon.com/images/M/MV5BOTFjOTFhNTgtZjk3Ny00MTNjLWE3MWUtMWI3ZWM5NDljZjQwXkEyXkFqcGdeQXVyMjQwMDg0Ng@@._V1_SX1024_SY1024_.jpg</thumb>
    </actor>
    <resume>
        <position>0.000000</position>
        <total>0.000000</total>
    </resume>
<showlink>Justice League</showlink>
    <dateadded>2019-08-06 09:01:18</dateadded>
</movie>
</syntaxhighlight>
{{collapse bottom}}




Line 504: Line 210:




{{Top}}




{{updated|18}}
{{top}}
{{updated|19}}


[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:Karellen]]
[[Category:Video library]]
[[Category:Video library]]
[[Category:Advanced topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]

Revision as of 00:07, 23 April 2021

NFO Contents

NFO Main Page


See also:


Return to:

Home icon grey.png   ▶ NFO files ▶ Movies


Introduction

NFO files to be scraped into the movie library are relatively simple and require only a single nfo file per title.


nfo Name and Location

Regardless of what settings you have set for the source and scraper, Kodi will always search for and scan the nfo file first where available.

There are two naming schemes for movie nfo files. Both are explained and Kodi recommends using the <VideoFileName>.nfo format.

<VideoFileName>.nfo
  • NFO Files are named the same as the video file except with the .nfo extension.
  • We recommend using this filename format to name nfo files.
movie.nfo
Kodi may also scan nfo files named movie.nfo. To use this name, the setting Movies are in separate folders that match the movie title must be Enabled in the Set Content Screen
  • If the above setting is not enabled, Kodi will ignore the movie.nfo. If the <VideoFileName>.nfo file is available, Kodi will scan this one instead, otherwise an online scrape will be performed if a valid scraper is set for the Source.
  • If you use movie.nfo and later Export your library to Separate Files, Kodi will still create the nfo file in the <VideoFileName>.nfo format and two nfo files will exist. If a Refresh or rescan is run in future, and the above setting is still enabled, the <VideoFileName>.nfo file will be ignored in favour of movie.nfo, which means any changes you may have made to the library entry (play counts, watched status etc) will not be re-scanned back into the library.
  • We recommend using the <VideoFileName>.nfo format for nfo files to avoid the above traps.

The below image details naming and location for Single File, DVD and Bluray movies:


nfo Tags

The following table lists available XML tags. [1]

The "Required" column indicates whether a tag can be optionally added or ommitted when creating the nfo to suit your purpose. The less tags used, the less information added to the library.

NFO (xml) Tag Required Multiple Notes
<movie></movie> Yes No The top level parent tag for the nfo file. All other tags must be contained within these two tags
<title></title> Yes No The title for the movie
<originaltitle></originaltitle> No No Displays the original title of the movie.

For example, if the scraper is set to german language and the scraped movie in german is "Der mit dem Wolf tanzt" the original title will be "Dances with Wolves"

<sorttitle></sorttitle> No No Allows alternate title sort without modifying movie title. Not displayed in any library listing. See: Sort Title
 <ratings>
   <rating name="" max="10" default="">
      <value></value>
      <votes></votes>
   </rating>
 </ratings>
No No default="true" default="false"
Only one rating can be set as default="true", additional ratings must be set as default="false" or omit the default attribute

name="identifier". Do not use "default". Examples of identifier include...

<rating name="imdb" max="10">
<rating name="trakt" max="10">
<rating name="themoviedb" max="10">
<rating name="metacritic" max="10">
<rating name="tomatometerallcritics" max="10">
<rating name="tomatometerallaudience" max="10">

Example of complete entry...

<rating name="themoviedb" max="10" default="true">
<rating name="imdb" max="10" default="false"> or <rating name="themoviedb" max="10">
<userrating></userrating> No No Personal rating set by the user
<top250></top250> No No Ranking in IMDB Top 250 movies
<outline></outline> Should be short, will be displayed on a single line (scraped from IMDB only)
<plot></plot> Can contain more information on multiple lines, will be wrapped
<tagline></tagline> No No Short movie slogan. "The true story of a real fake" is the tagline for "Catch me if you can"
<runtime></runtime> No No Minutes only. If ommitted, Kodi will add runtime upon scanning
<thumb aspect="" preview=""></thumb> No Yes Path to available Movie Posters. Not needed when using local artwork

Example use of aspect=""

<thumb aspect="banner"
<thumb aspect="clearart"
<thumb aspect="clearlogo"
<thumb aspect="discart"
<thumb aspect="keyart"
<thumb aspect="landscape"
<thumb aspect="poster"
<fanart>
    <thumb preview=""></thumb>
</fanart>
No Yes^ Path to available movie fanart.
^ Multiple <thumb> entries allowed between the <fanart></fanart> tags
<mpaa></mpaa> No No Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country certification flags
<playcount></playcount> No No Number of times movie has been played.
See... Import-Export
<lastplayed></lastplayed> No No Date last played as yyyy-mm-dd
<id></id> No No The default ID.

Do not use. This is a Kodi generated tag. See next item.

<uniqueid type="" default=""></uniqueid> Yes Yes The ID from the scraper site.

type="" Identifier of the ID. Do not use "default". Examples of identifier include...

<uniqueid type="imdb"
<uniqueid type="tvdb"
<uniqueid type="tmdb"
For non-scraped items, use simple values like "home", "sport", "doco" etc
The value can be alpha-numeric eg tt3480556 for imdb, 286668 for tmdb, home001 for home movies, etc

default="true" default="false"

Only one uniqueID can be set as default="true", additional uniqueID's must be set as default="false" or ommit the default attribute

Example of complete entry...

<uniqueid type="tmdb" default="true">
<uniqueid type="imdb" default="false"> or <uniqueid type="imdb">
<genre></genre> No Yes Movie genre.
<tag></tag> No Yes Library Tags. See...Video library tags
<set>
   <name></name>
   <overview></overview>
</set>
No No Movie set tags

The <overview> tag allows a short summary of the movie set. It can be displayed by some skins.
See... Movie sets

<country></country> No Yes Country of origin
<credits></credits> No Yes Field for writers.
<director></director> No Yes Movie Director
<premiered></premiered> No No Release date of movie. Format as yyyy-mm-dd
<year></year> No No Release Year.

Do not use. Use <premiered> instead

<status></status> No No Not used
No No Not used
<aired></aired> No No Not used
<studio></studio> No Yes Production studio
<trailer></trailer> No No Local or online path to movie trailer
Do not add local path to trailer. Kodi will automatically scan for local trailers.
See... Trailers
<fileinfo>
   <streamdetails>
     <video>
       <codec></codec>
       <aspect></aspect>
       <width></width>
       <height></height>
       <durationinseconds></durationinseconds>
       <stereomode></stereomode>
     </video>
     <audio>
       <codec></codec>
       <language></language>
       <channels></channels>
     </audio>
     <subtitle>
       <language></language>
     </subtitle>
   </streamdetails>
</fileinfo>
No Yes Multiple entries of <audio> and <subtitles> accepted

In v17 and prior, Kodi would overwrite these values on first play of the file.
In v18 that process was removed and values in these tags will remain.[2]

<actor>
  <name></name>
  <role></role>
  <order></order>
  <thumb></thumb>
</actor>
No Yes The <order> tag determines where in the list the actor will appear. 0 = first in the list
<showlink></showlink> No No Connect movie to TV Show. Use the TV Show <title></title> name.
<resume>
  <position></position>
  <total></total>
</resume>
No No Movie resume point in Seconds
See... Import-Export
<dateadded></dateadded> No No mTime of the playable video file. Can be altered in advancedsettings.xml
See... Advancedsettings.xml#videolibrary


References



Return to top