NFO files/TV shows: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(Update ratings and uniqueid)
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{|class="infobox" style="width:200px"
{{NFO_content}}
! NFO Contents
 
|-
{{mininav|[[NFO files]]}}
|
* '''[[NFO_files|NFO Files]]'''
** '''[[NFO_files/Movies|Movies]]'''
** '''[[NFO files/TV shows|TV Shows]]'''
** '''[[NFO files/Music|Music]]'''
** '''[[NFO files/Music videos|Music Videos]]'''
|}
{{mininav|[[NFO_files]]}}






= Requirements =
= Requirements =
TV Shows require the following nfo files
'''TV Shows and Episodes must abide by the standard naming conventions even if you are using nfo files. The scanner still determines the TV Show name from the folder name and Season and Episode numbering from the episode filename, not from the NFO file.'''
 
If you choose to use NFO Files, TV Shows require the following:
#One nfo file for the TV Show. This file holds the overall show information
#One nfo file for the TV Show. This file holds the overall show information
#One nfo file for '''each''' Episode. This file holds information specific to that episode
#One nfo file for '''each''' Episode. This file holds information specific to that episode
For one TV Show with 10 episodes, you will require 11 nfo files.
For one TV Show with 10 episodes, you will require 11 nfo files.


<!--If you choose not to use nfo files for each episode, but only for the main TV Show, then the tvshow.nfo file must contain a valid ''<episodeguideurl>'' to allow online updates. If not, only episodes with .nfo files will be added. -->
TV Shows and Episodes '''must''' abide by the standard naming conventions even if you are using nfo files.


The order of importing metadata is as follows:
The order of importing metadata is as follows:
Line 29: Line 20:
##Nothing- if Local Info Only is set
##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.
#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.


== episodeguide URL ==
The ''<episodeguide>'' URL is saved in the '''tvshow.nfo''' file.
'''When using the scrapers''', the ''<episodeguide>'' URL is a critical component of the scraping process that ensures episodes are correctly scraped. The ''<episodeguide>'' URL is provided by the information provider in a format that they have designed. The URL is not interchangeable between information providers. i.e. you cannot use the TVDB URL while using TheMovieDB scraper.
When scraping, once a TV Show has been identified via the folder name, the scraper asks the site to provide the link to all the episodes for the show. This is provided in the format of the ''<episodeguide>'' URL from which all the metadata for the individual episodes is downloaded.
Without the ''<episodeguide>'' no episodes will be scraped.
'''When using NFO Files''' knowing whether to include the ''<episodeguide>'' can be tricky. Some points that hopefully will explain how and when to use it for your own scenario:
* If you are using nfo files exclusively, then the ''<episodeguide>'' is not required in the tvshow.nfo file. Be aware that any episodes missing nfo files will not be scanned or scraped
* If you have a mix of nfo files and no nfo files for episodes, then the ''<episodeguide>'' is required.
* If your tvshow.nfo file does not have the ''<episodeguide>'', and you require it, the scraper will not download it. Delete your tvshow.nfo file and [[Updating_or_removing_videos#Individual_Refresh|Refresh]] the TV Show and the scraper will download the ''<episodeguide>'' URL.
* You can have episode nfo files without the tvshow.nfo file.
* Creating your own ''<episodeguide>'' URL is tricky but you can attempt it by reading the ''What if I'm using NFO files?'' section in this thread... ''[https://forum.kodi.tv/showthread.php?tid=323588 Forum Thread]''
* If you include the ''<episodeguide>'', then you need to have the correct scraper active. Remember that the ''<episodeguide>'' URL is not interchangeable between scrapers. Using Local Information Only will not change this requirement.
* TheTVDB ''<episodeguide>'' used by {{Kodi}} is v2 from the v2 API. v1 is not recognised by {{kodi}}.




== Known Issues ==
== Known Issues ==
No 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]




= nfo Placement =
Correct placement of the nfo file is essential. '''Regardless of what settings you have set for the source and scraper, Kodi will always search for and scrape a nfo file if it is available.''' Failing to save the file in the correct location, as detailed below, will force Kodi to either:
#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.


= TV Show =
This section deals with the requirement for the '''tvshow.nfo''' file. Episode nfo files are discussed in Section 3 below.




== TV Show ==
One TV Show nfo is required. Be aware the nfo filename is actually '''tvshow.nfo'''. This is not meant to indicate that it is replaced with the name of the show.


<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
== nfo Name and Location ==
'''''Naming & Saving conventions for your TV Show *.nfo files:'''''
'''{{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.}}'''
{|
|- valign="top"
| width=200px |'''''Saved TV Show as'''''
| width=300px |'''''File Name'''''
| width=600px |'''''Save Location'''''
|- valign="top"
| width=200px |All formats
| width=300px |tvshow.nfo
| width=600px |f:\MyTVShows\iZombie\tvshow.nfo
|}
</div>


The tvshow.nfo file is placed inside the TV Show folder. The nfo filename is actually '''tvshow.nfo'''. Do not rename it with the title of the tv show. See image for example


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:
#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.


== TV Episode ==
One nfo file for every episode is required.


<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
<gallery mode="packed" widths="1000px" heights="562px">
'''''Naming & Saving conventions for your TV Episode *.nfo files:'''''
File:LocalTVShowArtwork01.jpg|'''''Location of tvshow.nfo along with artwork'''''
{|
</gallery>
|- valign="top"
| width=200px |'''''Saved Episodes as'''''
| width=300px |'''''File Name'''''
| width=600px |'''''Save Location'''''
|- valign="top"
| width=200px |BluRay Structure:
| width=300px |index.nfo
| width=600px |f:\MyTVShows\iZombie\iZombie S01E01\BDMV\index.nfo
|- valign="top"
| width=200px |DVD Structure:
| width=300px |VIDEO_TS.nfo
| width=600px |f:\MyTVShows\iZombie\iZombie S01E01\VIDEO_TS\VIDEO_TS.nfo
|- valign="top"
| width=200px |Single Episode file in directory:
| width=300px |<EpisodeFileName>.nfo
| width=600px |f:\MyTVShows\iZombie\iZombie S01E01\<EpisodeFileName>.nfo
|- valign="top"
| width=200px |All episodes in TV Show directory:
| width=300px |<EpisodeFileName>.nfo
| width=600px |f:\MyTVShows\iZombie\<EpisodeFileName>.nfo
|}
</div>






= TV nfo Tags =
== nfo Tags ==
The only required tags are indicated below in the tables. All other tags are optional. Of course, the less tags used, the less information that will be scraped into the library unless you are using a parsing or combination nfo.
The following table lists most available XML tags. <ref>https://github.com/xbmc/xbmc/blob/master/xbmc/video/VideoInfoTag.cpp</ref>
:'''''See also: [[Databases]]


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.


== TV Show Tags ==
The following table lists the XML tags available for the TV Show in Kodi. Children tags are displayed correctly with parent tags.


{|class="prettytable"
{|class="prettytable"
! NFO (xml) Tag || Required || Multiple || Notes
! NFO (xml) Tag || Required || Multiple || Notes
|-
|-
|<tvshow></tvshow> || Yes || No || The top level parent tag for the nfo file. All other tags must be contained within these two tags
|<tvshow></tvshow> || 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
|-
|-
|<title></title> || No || No ||
|<title></title> || No || No || The title of the TV Show
|-
|-
|<originaltitle></originaltitle> || No || No ||
|<originaltitle></originaltitle> || No || No || The original title, usually in the language of the country of origin.
|-
|-
|<showtitle></showtitle> || No || No ||
|<showtitle></showtitle> || No || No || Not in common use, but some skins may display an alternate title
|-
|-
|<sorttitle></sorttitle> || No || No || Allows alternate title sort without modifying show title in library.
|<sorttitle></sorttitle> || No || No || Allows alternate title sort without modifying the TV Show title. Not displayed in any library listing.
|-
|-
|
|
   <ratings>
   <ratings>
     <rating name="default" max="10" default="true">
     <rating name="" max="10" default="">
       <value></value>
       <value></value>
       <votes></votes>
       <votes></votes>
     </rating>
     </rating>
   </ratings>
   </ratings>
|| No || No ||  
|| 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>
 
''name="identifier"''. Do not use "default". Examples of identifier include...<br>
::''<rating name="imdb" max="10">''<br>
::''<rating name="trakt" max="10">''<br>
::''<rating name="tvmaze" max="10">''<br>
::''<rating name="metacritic" max="10">''<br>
::''<rating name="tomatometerallcritics" max="10">''<br>
::''<rating name="tomatometerallaudience" max="10">''<br>
 
Example of complete entry...
::''<rating name="themoviedb" max="10" default="true">''<br>
::''<rating name="imdb" max="10" default="false"> or <rating name="themoviedb" max="10">''<br>
|-
|-
|<userrating></userrating> || No || No ||
|<userrating></userrating> || No || No || Personal rating set by the user
|-
|-
|<top250></top250> || No || No ||
|<top250></top250> || No || No || Ranking in IMDB Top 250
|-
|-
|<season></season> || No || No ||
|<season></season> || No || No ||Number of seasons of this TV Show in the library
|-
|-
|<episode></episode> || No || No || Number of episodes in TV Show
|<episode></episode> || No || No || Number of episodes of this TV Show in the library
|-
|-
|<displayepisode></displayepisode> || No || No || Not used in TV Shows
|<displayepisode></displayepisode> || No || No || Not used  
|-
|-
|<displayseason></displayseason> || No || No || Not used in TV Shows
|<displayseason></displayseason> || No || No || Not used  
|-
|-
|<outline></outline> || || || Not Used
|<namedseason number="1"></namedseason> || No || No || Not Used
|-
|-
|<plot></plot> || || || Can contain more information on multiple lines, will be wrapped
|<outline></outline> || No || No || Not Used
|-
|-
|<tagline></tagline> || No || No ||
|<plot></plot> || No || No || Can contain more information on multiple lines, will be wrapped
|-
|-
|<runtime></runtime> || No || No || Minutes only
|<tagline></tagline> || No || No || Short TV Show slogan
|-
|-
|<thumb aspect="" type="" season=""></thumb> || No || Yes || Path to TV Show and Season artwork
|<runtime></runtime> || No || No || Not used
|-
|-
|<thumb aspect="" preview=""></thumb>
<thumb aspect="poster" type="season" season="" preview=""></thumb>
|| No || Yes || Path to available TV Show Posters<br>
Example use of ''aspect=""''
:<thumb aspect="banner"
:<thumb aspect="clearart"
:<thumb aspect="clearlogo"
:<thumb aspect="landscape"
:<thumb aspect="poster"<br>
''type="season"'' used for season specific artwork<br>
''season="2"'' nominates season number eg. season 2
|-
|-
|
|
  <fanart url="">
  <fanart>
     <thumb dim="" colors="" preview=""></thumb>
     <thumb preview=""></thumb>
  </fanart>
  </fanart>
|| No || No || Path to available TV Show fanart. Multible <thumb> entries allowed. dim=Dimensions
|| No || Yes^ || Path to available TV Show fanart.<br>
|-
:^ Multiple <thumb> entries allowed between the <fanart></fanart> tags
|<mpaa></mpaa> || No || No ||
|-
|<playcount></playcount> ||  ||  || Setting this to 1, or greater, will mark the TV Show as watched if the ''importwatchedstate'' flag is set in advancedsettings.xml
|-
|<lastplayed></lastplayed> || No || No ||
|-
|<file></file> || No || No || Not Used. Exported in Single File Export only
|-
|-
|<path></path> || Yes || No || Exported in Single File Export only
|<mpaa></mpaa> || No || No || Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country local rating system
|-
|-
|<filenameandpath></filenameandpath> || Yes || No || Exported in Single File Export only
|<playcount></playcount> || No || No || Number of times TV show has been played. Will only ever show 0 or 1. Episodes track playcounts<br>
Setting this to 1 will mark the TV Show as watched if the ''importwatchedstate'' flag is set in advancedsettings.xml
|-
|-
|<basepath></basepath> || Yes || No || Exported in Single File Export only
|<lastplayed></lastplayed> || No || No || Date TV Show was last played
|-
|-
|
|
Line 175: Line 163:
   <url cache=""></url>
   <url cache=""></url>
  </episodeguide>
  </episodeguide>
|| Yes/No || No || Required if no or missing episode nfo's
| scope="cell" ! style="background-color:#ff9c95;" | Yes/No || No || Read section ''1.1 episodeguide URL'' above<br>
When using TVDB scraper, Kodi will only read the URL created by the TVDB v2 API <ref>https://forum.kodi.tv/showthread.php?tid=323588</ref><br>
When a URL is used, the corresponding scraper must be set.
|-
|-
|<id></id> || No || No || Scraper site ID
|<id></id> || No || No || The default ID. <br>
Do not use as this is a Kodi generated tag. See next item.
|-
|-
|<uniqueid type="unknown" default="true"></uniqueid> || No || No || Scraper site ID  
|<uniqueid type="xxxx" default="true"></uniqueid> || scope="cell" ! style="background-color:#ff9c95;" | Yes || Yes || The ID from the scraper site.<br>
''type="xxxx"'' = Identifier of the ID. Do not use "default". Examples of identifier include...<br>
::''<uniqueid type="imdb">''<br>
::''<uniqueid type="tvdb">''<br>
::''<uniqueid type="tvmaze">''<br>
::''<uniqueid type="tmdb">''<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>
''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>
Example of complete entry...
::''<uniqueid type="tmdb" default="true">''<br>
::''<uniqueid type="imdb" default="false"> or <uniqueid type="imdb">''<br>
|-
|-
|<genre></genre> || No || Yes || Supports "clear" attribute
|<genre></genre> || No || Yes || Genre
|-
|-
|<tag></tag> || No || Yes || TV Show tags
|<tag></tag> || No || Yes || Tags. See: ''[[Video library tags]]''
|-
|-
|<premiered></premiered> || No || No ||
|<premiered></premiered> || No || No || Release date of TV Show. Comes from Aired Date of the first episode.<br>
Format as ''2019-01-31''
|-
|-
|<year></year> || No || No ||
|<year></year> || No || No || Release Year.<br>
Do not use. Use <premiered> instead
|-
|-
|<status></status> || No || No || Continuing or Ended show
|<status></status> || No || No || Continuing or Ended show
|-
|-
|<aired></aired> || No || No || Used for TV Episodes
| <code><code></code></code> || No || No || Not used
|-
|-
|<code></code> || || || Unknown
|<aired></aired> || No || No || Not used
|-
|-
|<studio></studio> || No || Yes || Supports "clear" attribute
|<studio></studio> || No || Yes || Production studio
|-
|-
|<trailer></trailer> || No || No || Path to TV Show trailer  
|<trailer></trailer> || No || No || Local or online path to TV Show trailer  
|-
|-
|
|
Line 208: Line 213:
|| No || Yes || The <order> tag determines where in the list the actor will appear. 0 = first in the list  
|| No || Yes || The <order> tag determines where in the list the actor will appear. 0 = first in the list  
Supports "clear" attribute
Supports "clear" attribute
|-
| <namedseason number=""></namedseason> || No || Yes || Allows naming of Seasons- eg Game of Thrones named seasons<br>
''number=""'' = Season number to be renamed
|-
|-
|
|
Line 216: Line 224:
|| No || No || Not used for TV Show  
|| No || No || Not used for TV Show  
|-
|-
|<dateadded></dateadded> || No || No || Date the file was added to library. Can be altered in advancedsettings.xml
|<dateadded></dateadded> || No || No || mTime of the playable video file. Can be altered in advancedsettings.xml
|}
|}






== TV Episode Tags ==
== Template nfo ==
The following table lists the XML tags available for TV Episodes in Kodi. Children tags are displayed correctly with parent tags.
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">
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<tvshow>
    <title></title>
    <plot></plot>
    <userrating></userrating>
    <mpaa></mpaa>
    <uniqueid type="" default="true"></uniqueid>
    <genre></genre>
    <premiered></premiered>
    <status></status>
    <studio></studio>
    <actor>
        <name></name>
        <role></role>
        <order></order>
        <thumb></thumb>
    </actor>
    <namedseason number="1"></namedseason>
</tvshow>
</syntaxhighlight>
 
 
 
== Sample nfo ==
Below is a sample nfo file that was exported from Kodi after scraping into the library using the default TheMovieDB-TV Shows scraper.
 
'''Press Expand at right edge of the green bar to view'''
 
{{collapse top| TV Show nfo file  (click 'expand' to view)}}
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<tvshow>
    <title>American Gods</title>
    <originaltitle>American Gods</originaltitle>
    <showtitle>American Gods</showtitle>
    <sorttitle>American Gods</sorttitle>
    <ratings>
        <rating name="themoviedb" max="10" default="true">
            <value>6.800000</value>
            <votes>581</votes>
        </rating>
        <rating name="imdb" max="10" default="true">
            <value>5.500000</value>
            <votes>86352</votes>
        </rating>
        <rating name="metacritic" max="10">
            <value>6.0</value>
            <votes>22</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>
    <season>2</season>
    <episode>16</episode>
    <displayseason>-1</displayseason>
    <displayepisode>-1</displayepisode>
    <outline></outline>
    <plot>An ex-con becomes the traveling partner of a conman who turns out to be one of the older gods trying to recruit troops to battle the upstart deities. Based on Neil Gaiman&apos;s fantasy novel.</plot>
    <tagline></tagline>
    <runtime>0</runtime>
    <thumb aspect="poster" preview="https://assets.fanart.tv/preview/tv/253573/tvposter/american-gods-58b18cd8d667a.jpg">https://assets.fanart.tv/fanart/tv/253573/tvposter/american-gods-58b18cd8d667a.jpg</thumb>
    <thumb aspect="poster" preview="https://assets.fanart.tv/preview/tv/253573/tvposter/american-gods-5c896dbee9d21.jpg">https://assets.fanart.tv/fanart/tv/253573/tvposter/american-gods-5c896dbee9d21.jpg</thumb>
    <thumb aspect="poster" preview="https://assets.fanart.tv/preview/tv/253573/tvposter/american-gods-57dda913a44e0.jpg">https://assets.fanart.tv/fanart/tv/253573/tvposter/american-gods-57dda913a44e0.jpg</thumb>
    <thumb aspect="poster" preview="https://assets.fanart.tv/preview/tv/253573/tvposter/american-gods-590c159dcbf3a.jpg">https://assets.fanart.tv/fanart/tv/253573/tvposter/american-gods-590c159dcbf3a.jpg</thumb>
    <thumb aspect="banner" preview="https://assets.fanart.tv/preview/tv/253573/tvbanner/american-gods-5cbbdaa84298d.jpg">https://assets.fanart.tv/fanart/tv/253573/tvbanner/american-gods-5cbbdaa84298d.jpg</thumb>
    <thumb aspect="banner" preview="https://assets.fanart.tv/preview/tv/253573/tvbanner/american-gods-5932b1ffb3522.jpg">https://assets.fanart.tv/fanart/tv/253573/tvbanner/american-gods-5932b1ffb3522.jpg</thumb>
    <thumb aspect="banner" preview="https://assets.fanart.tv/preview/tv/253573/tvbanner/american-gods-5932b1ffb43e4.jpg">https://assets.fanart.tv/fanart/tv/253573/tvbanner/american-gods-5932b1ffb43e4.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/tv/253573/tvthumb/american-gods-58db45dc886f5.jpg">https://assets.fanart.tv/fanart/tv/253573/tvthumb/american-gods-58db45dc886f5.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/tv/253573/tvthumb/american-gods-5932aee79947a.jpg">https://assets.fanart.tv/fanart/tv/253573/tvthumb/american-gods-5932aee79947a.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/tv/253573/tvthumb/american-gods-5932aee799e5a.jpg">https://assets.fanart.tv/fanart/tv/253573/tvthumb/american-gods-5932aee799e5a.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/tv/253573/tvthumb/american-gods-5932aee79a2f2.jpg">https://assets.fanart.tv/fanart/tv/253573/tvthumb/american-gods-5932aee79a2f2.jpg</thumb>
    <thumb aspect="landscape" preview="https://assets.fanart.tv/preview/tv/253573/tvthumb/american-gods-5932aee79a7c9.jpg">https://assets.fanart.tv/fanart/tv/253573/tvthumb/american-gods-5932aee79a7c9.jpg</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/tv/253573/hdtvlogo/american-gods-58b04bdcecefd.png">https://assets.fanart.tv/fanart/tv/253573/hdtvlogo/american-gods-58b04bdcecefd.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/tv/253573/hdtvlogo/american-gods-58b04d78a7ffc.png">https://assets.fanart.tv/fanart/tv/253573/hdtvlogo/american-gods-58b04d78a7ffc.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/tv/253573/hdtvlogo/american-gods-59e6660cb7dbc.png">https://assets.fanart.tv/fanart/tv/253573/hdtvlogo/american-gods-59e6660cb7dbc.png</thumb>
    <thumb aspect="clearlogo" preview="https://assets.fanart.tv/preview/tv/253573/hdtvlogo/american-gods-59e6660cc0716.png">https://assets.fanart.tv/fanart/tv/253573/hdtvlogo/american-gods-59e6660cc0716.png</thumb>
    <thumb aspect="clearart" preview="https://assets.fanart.tv/preview/tv/253573/hdclearart/american-gods-59177740ba6cd.png">https://assets.fanart.tv/fanart/tv/253573/hdclearart/american-gods-59177740ba6cd.png</thumb>
    <thumb aspect="clearart" preview="https://assets.fanart.tv/preview/tv/253573/hdclearart/american-gods-5913b6b2ce91d.png">https://assets.fanart.tv/fanart/tv/253573/hdclearart/american-gods-5913b6b2ce91d.png</thumb>
    <thumb aspect="clearart" preview="https://assets.fanart.tv/preview/tv/253573/hdclearart/american-gods-5913b6b2cfa64.png">https://assets.fanart.tv/fanart/tv/253573/hdclearart/american-gods-5913b6b2cfa64.png</thumb>
    <thumb aspect="clearart" preview="https://assets.fanart.tv/preview/tv/253573/hdclearart/american-gods-5913b6b2cf502.png">https://assets.fanart.tv/fanart/tv/253573/hdclearart/american-gods-5913b6b2cf502.png</thumb>
    <thumb aspect="clearart" preview="https://assets.fanart.tv/preview/tv/253573/hdclearart/american-gods-5a4805be0619f.png">https://assets.fanart.tv/fanart/tv/253573/hdclearart/american-gods-5a4805be0619f.png</thumb>
    <thumb aspect="characterart" preview="https://assets.fanart.tv/preview/tv/253573/characterart/american-gods-5a4805af07a04.png">https://assets.fanart.tv/fanart/tv/253573/characterart/american-gods-5a4805af07a04.png</thumb>
    <thumb aspect="characterart" preview="https://assets.fanart.tv/preview/tv/253573/characterart/american-gods-59e6b1c71b65a.png">https://assets.fanart.tv/fanart/tv/253573/characterart/american-gods-59e6b1c71b65a.png</thumb>
    <thumb aspect="poster" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-5d1274a8c31cb.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-5d1274a8c31cb.jpg</thumb>
    <thumb aspect="poster" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-59fea294b565f.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-59fea294b565f.jpg</thumb>
    <thumb aspect="poster" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-5cacdf37068db.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-5cacdf37068db.jpg</thumb>
    <thumb aspect="poster" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-5cacdf7783e04.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-5cacdf7783e04.jpg</thumb>
    <thumb aspect="poster" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-5d1274a8c31cb.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-5d1274a8c31cb.jpg</thumb>
    <thumb aspect="poster" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-59fea294b565f.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-59fea294b565f.jpg</thumb>
    <thumb aspect="poster" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-5cacdf37068db.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-5cacdf37068db.jpg</thumb>
    <thumb aspect="poster" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonposter/american-gods-5cacdf7783e04.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonposter/american-gods-5cacdf7783e04.jpg</thumb>
    <thumb aspect="banner" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonbanner/american-gods-5cc6b35699d26.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonbanner/american-gods-5cc6b35699d26.jpg</thumb>
    <thumb aspect="banner" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonbanner/american-gods-5cc6b36965b54.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonbanner/american-gods-5cc6b36965b54.jpg</thumb>
    <thumb aspect="banner" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonbanner/american-gods-5cc6b35699d26.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonbanner/american-gods-5cc6b35699d26.jpg</thumb>
    <thumb aspect="banner" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonbanner/american-gods-5cc6b36965b54.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonbanner/american-gods-5cc6b36965b54.jpg</thumb>
    <thumb aspect="landscape" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonthumb/american-gods-5cc6b380d6c56.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonthumb/american-gods-5cc6b380d6c56.jpg</thumb>
    <thumb aspect="landscape" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonthumb/american-gods-59e6b5a03e7aa.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonthumb/american-gods-59e6b5a03e7aa.jpg</thumb>
    <thumb aspect="landscape" type="season" season="2" preview="https://assets.fanart.tv/preview/tv/253573/seasonthumb/american-gods-5cc6b380d6c56.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonthumb/american-gods-5cc6b380d6c56.jpg</thumb>
    <thumb aspect="landscape" type="season" season="1" preview="https://assets.fanart.tv/preview/tv/253573/seasonthumb/american-gods-59e6b5a03e7aa.jpg">https://assets.fanart.tv/fanart/tv/253573/seasonthumb/american-gods-59e6b5a03e7aa.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/m6qf6lq3yARgbZwspvDLbUFtASh.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/gevw5nZRYz2kWj1PqW9pz4sgeeZ.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/btwTe5cQbGWGOErBiRqnjNP9cJl.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/loJ4sfr4zp995qMoeCHiIIGaOg8.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/dHo8Lw7ruIaQTdTTDZPCMyZxwy5.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/zfAXP4bG2G17VuLNU9cqRcVU0xj.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/oxYUbNpG2st2zXWzYRvewehmvuj.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/mwoQ6zynu2DBxKCBYi30qoM236N.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/8XEoXAMzgcf7m1KiUDZ9N1UGh4o.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/rWsayJB1grML2LdPjjKDC3g0Brr.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/8qRsj8uJ4zPARQmQ9FvejTY1lnV.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/acjnZP0GrwWDxCxV6QejKizbzOy.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/hN1sI57QILGfdrEOqpUfo0NtHjW.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/hz2jNy3DfseYzRSybGRlUtz4pTi.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/hLDgNDdrkB0oWiuClpxN4E3XadJ.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/4FiqawHsVz1mYCRudPtXKbfmP4M.jpg</thumb>
    <thumb aspect="poster">http://image.tmdb.org/t/p/original/sKR8Q36YBtyRc19y4yGYuD1xBgA.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/4l8Vnbb7e5QA6bAItMqQIHXLRgc.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/ni0thXw5Zi5dQKBY6Oj0vcfIS2n.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/v17HfCzWKQKOBrww9RxZmN5R9tF.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/2ffvlgYsxbXGiWkc3V6Q8tgpiBo.jpg</thumb>
    <thumb aspect="poster" type="season" season="1">http://image.tmdb.org/t/p/original/rASj7OUjWDhfhAeO2MaFOA3lJpQ.jpg</thumb>
    <thumb aspect="poster" type="season" season="1">http://image.tmdb.org/t/p/original/67exRijfvN5RRmBCqFtk1bhJ7Uh.jpg</thumb>
    <thumb aspect="poster" type="season" season="1">http://image.tmdb.org/t/p/original/59iE3xxP7H8rAiXW6TDR2HSoUUm.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/4l8Vnbb7e5QA6bAItMqQIHXLRgc.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/ni0thXw5Zi5dQKBY6Oj0vcfIS2n.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/v17HfCzWKQKOBrww9RxZmN5R9tF.jpg</thumb>
    <thumb aspect="poster" type="season" season="2">http://image.tmdb.org/t/p/original/2ffvlgYsxbXGiWkc3V6Q8tgpiBo.jpg</thumb>
    <thumb aspect="banner">https://thetvdb.com/banners/graphical/253573-g3.jpg</thumb>
    <thumb aspect="banner">https://thetvdb.com/banners/graphical/253573-g4.jpg</thumb>
    <thumb aspect="banner">https://thetvdb.com/banners/graphical/253573-g2.jpg</thumb>
    <thumb aspect="banner">https://thetvdb.com/banners/graphical/253573-g.jpg</thumb>
    <thumb aspect="banner">https://thetvdb.com/banners/graphical/253573-g5.jpg</thumb>
    <fanart>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5c8965c58e778.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5c8965c58e778.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-59e6a8a495c2a.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-59e6a8a495c2a.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-59e6b13827ba2.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-59e6b13827ba2.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5932b089e07ad.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5932b089e07ad.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5932b089e2913.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5932b089e2913.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5932b089e0000.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5932b089e0000.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5932b089e0d3a.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5932b089e0d3a.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5932b089e1395.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5932b089e1395.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5932b089e1952.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5932b089e1952.jpg</thumb>
        <thumb preview="https://assets.fanart.tv/preview/tv/253573/showbackground/american-gods-5932b089e23ca.jpg">https://assets.fanart.tv/fanart/tv/253573/showbackground/american-gods-5932b089e23ca.jpg</thumb>
    </fanart>
    <mpaa>Australia:MA</mpaa>
    <playcount>0</playcount>
    <lastplayed></lastplayed>
    <episodeguide>
        <url cache="tmdb-46639-en.json">http://api.themoviedb.org/3/tv/46639?api_key=6a5be4999abf74eba1f9a8311294c267&amp;language=en</url>
    </episodeguide>
    <id>46639</id>
    <uniqueid type="tmdb" default="true">46639</uniqueid>
    <uniqueid type="tvdb">253573</uniqueid>
    <genre>Drama</genre>
    <genre>Mystery</genre>
    <genre>Sci-Fi &amp; Fantasy</genre>
    <premiered>2017-04-30</premiered>
    <year>2017</year>
    <status></status>
    <code></code>
    <aired></aired>
    <studio>Starz</studio>
    <trailer></trailer>
    <actor>
        <name>Ricky Whittle</name>
        <role>Shadow Moon</role>
        <order>0</order>
        <thumb>http://image.tmdb.org/t/p/original/cjeDbVfBp6Qvb3C74Dfy7BKDTQN.jpg</thumb>
    </actor>
    <actor>
        <name>Ian McShane</name>
        <role>Mr. Wednesday</role>
        <order>1</order>
        <thumb>http://image.tmdb.org/t/p/original/pY9ud4BJwHekNiO4MMItPbgkdAy.jpg</thumb>
    </actor>
    <actor>
        <name>Emily Browning</name>
        <role>Laura Moon</role>
        <order>2</order>
        <thumb>http://image.tmdb.org/t/p/original/fa1Kyj02wxwcdS6EHb2i27TNXvU.jpg</thumb>
    </actor>
    <actor>
        <name>Pablo Schreiber</name>
        <role>Mad Sweeney</role>
        <order>3</order>
        <thumb>http://image.tmdb.org/t/p/original/uo8YljeePz3pbj7gvWXdB4gOOW4.jpg</thumb>
    </actor>
    <actor>
        <name>Bruce Langley</name>
        <role>Technical Boy</role>
        <order>4</order>
        <thumb>http://image.tmdb.org/t/p/original/f4EOWUmznLqboq8Ce7jnlkHVK3Y.jpg</thumb>
    </actor>
    <actor>
        <name>Yetide Badaki</name>
        <role>Bilquis</role>
        <order>5</order>
        <thumb>http://image.tmdb.org/t/p/original/qfzkREHuI1JvMxBteIAjKX8qMEr.jpg</thumb>
    </actor>
    <namedseason number="1">Season 1</namedseason>
    <namedseason number="2">Season 2</namedseason>
    <resume>
        <position>0.000000</position>
        <total>0.000000</total>
    </resume>
    <dateadded>2017-10-07 14:25:47</dateadded>
</tvshow>
</syntaxhighlight>
{{collapse bottom}}
 
 
 
= Episodes =
This section deals with the requirement for the '''episode nfo''' file.
 
 
 
== nfo Name and Location ==
'''{{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.}}'''
 
The episode nfo file is placed alongside each episode video file. The episode nfo filename is the same as the video filename but with the ''.nfo'' extension. See image below for examples.
 
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:
#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.
 
 
<gallery mode="packed" widths="1000px" heights="562px">
File:LocalEpisodeArtwork01.jpg|'''''Episode Artwork and nfo files'''''
</gallery>
 
 
 
== nfo Tags ==
The following table lists most available XML tags. <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.
 
For multi-part episodes, add multiple <episodedetails> XML blocks in succession in the same nfo file


For multi-part episodes, simply add multiple <episodedetails> XML blocks in succession.


{|class="prettytable"
{|class="prettytable"
! NFO (xml) Tag || Required || Multiple || Notes
! NFO (xml) Tag || Required || Multiple || Notes
|-
|-
|<episodedetails></episodedetails> || Yes || No || The top level parent tag for the nfo file. All other tags must be contained within these two tags
|<episodedetails></episodedetails> || 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
|-
|-
|<title></title> || No || No ||
|<title></title> || No || No || The title for the episode
|-
|-
|<originaltitle></originaltitle> || No || No ||
|<originaltitle></originaltitle> || No || No || The original title, usually in the language of the country of origin.
|-
|-
|<showtitle></showtitle> || No || No ||
|<showtitle></showtitle> || No || No || Name of the tv show this episode belongs to
|-
|-
|
|
   <ratings>
   <ratings>
     <rating name="default" max="10" default="true">
     <rating name="" max="10" default="">
       <value></value>
       <value></value>
       <votes></votes>
       <votes></votes>
     </rating>
     </rating>
   </ratings>
   </ratings>
|| No || No ||  
|| 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>
 
''name="identifier"''. Do not use "default". Examples of identifier include...<br>
::''<rating name="imdb" max="10">''<br>
::''<rating name="trakt" max="10">''<br>
::''<rating name="tvmaze" max="10">''<br>
::''<rating name="metacritic" max="10">''<br>
::''<rating name="tomatometerallcritics" max="10">''<br>
::''<rating name="tomatometerallaudience" max="10">''<br>
 
Example of complete entry...
::''<rating name="themoviedb" max="10" default="true">''<br>
::''<rating name="imdb" max="10" default="false"> or <rating name="themoviedb" max="10">''<br>
|-
|-
|<userrating></userrating> || No || No ||
|<userrating></userrating> || No || No || Personal rating set by the user
|-
|-
|<top250></top250> || No || No ||
|<top250></top250> || No || No || Not used
|-
|-
|<season></season> || No || No || Season the episode belongs to
|<season></season> || No || No || Ignored on Import. Season is read from filename
|-
|-
|<episode></episode> || No || No || Episode numbering
|<episode></episode> || No || No || Ignored on Import. Episode is read from filename
|-
|-
|<displayepisode></displayepisode> || No || No || Used to place Special Episodes in the correct viewing order
|<displayepisode></displayepisode> || No || No || Used to place Specials episodes in the correct episode order
|-
|-
|<displayseason></displayseason> || No || No || Used to place Special Episodes in the correct viewing order
|<displayseason></displayseason> || No || No || Used to place Specials episodes in the correct season
|-
|-
|<outline></outline> || || ||  
|<outline></outline> || No || No || Not used
|-
|-
|<plot></plot> || || || Can contain more information on multiple lines, will be wrapped
|<plot></plot> || No || No || Can contain more information on multiple lines, will be wrapped
|-
|-
|<tagline></tagline> || No || No ||
|<tagline></tagline> || No || No || Short slogan of the episode. No skins use this.
|-
|-
|<runtime></runtime> || No || No || Minutes only
|<runtime></runtime> || No || No || Minutes only. Overwritten when episode played
|-
|-
|<thumb></thumb> || No || Yes || Path to episode artwork
|<thumb></thumb> || No || Yes || Path to episode artwork
|-
|-
|<mpaa></mpaa> || No || No ||
|<mpaa></mpaa> || No || No || Inherited from TV Show nfo file. Ignored on import.
|-
|<playcount></playcount> ||  ||  || Setting this to 1, or greater, will mark the TV Show as watched if the ''importwatchedstate'' flag is set in advancedsettings.xml
|-
|<lastplayed></lastplayed> || No || No ||
|-
|-
|<file></file> || No || No || Not Used. Exported in Single File Export only
|<playcount></playcount> || No || No || Number of times episode has been played.<br>
Setting this to 1 or greater will mark the episode as watched if the ''importwatchedstate'' flag is set in advancedsettings.xml
|-
|-
|<path></path> || Yes || No || Exported in Single File Export only
|<lastplayed></lastplayed> || No || No || Date episode was last played
|-
|-
|<filenameandpath></filenameandpath> || Yes || No || Exported in Single File Export only
|<id></id> || No || No || The default ID. <br>
Do not use as this is a Kodi generated tag. See next item.
|-
|-
|<basepath></basepath> || Yes || No || Exported in Single File Export only
|<uniqueid type="xxxx" default="true"></uniqueid> || scope="cell" ! style="background-color:#ff9c95;" | Yes || Yes || The ID from the scraper site.<br>
''type="xxxx"'' = Identifier of the ID. Do not use "default". Examples of identifier include...<br>
::''<uniqueid type="imdb">''<br>
::''<uniqueid type="tvdb">''<br>
::''<uniqueid type="tvmaze">''<br>
::''<uniqueid type="tmdb">''<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>
''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>
Example of complete entry...
::''<uniqueid type="tmdb" default="true">''<br>
::''<uniqueid type="imdb" default="false"> or <uniqueid type="imdb">''<br>
|-
|-
|<id></id> || No || No || Scraper site ID
|<genre></genre> || No || Yes || Inherited from TV Show. Ignored on import.
|-
|-
|<uniqueid type="unknown" default="true"></uniqueid> || No || No || Scraper site ID
|<credits></credits> || No || Yes || Field for writers.
|-
|-
|<genre></genre> || No || Yes || Supports "clear" attribute
|<director></director> || No || Yes || Director
|-
|-
|<credits></credits> || No || Yes || Writers
|<premiered></premiered> || No || No || Release date of TV Show. Format as ''2019-01-31''<br>
Use the <aired> field below to add the aired date of the episode.
|-
|-
|<director></director> || No || No ||
|<year></year> || No || No || Release Year.<br>
Do not use. Use <aired> instead
|-
|-
|<premiered></premiered> || No || No ||
|<status></status> || No || No || Not used
|-
|-
|<year></year> || No || No ||
|<code><code></code></code> || No || No || Not used
|-
|<status></status> || No || No || Not used in Episodes
|-
|<code></code> ||  ||  || Unknown
|-
|-
|<aired></aired> || No || No || Original air date of the episode  
|<aired></aired> || No || No || Original air date of the episode  
|-
|-
|<studio></studio> || No || Yes || Supports "clear" attribute
|<studio></studio> || No || Yes || Production studio. Inherited from TV Show
|-
|-
|<trailer></trailer> || No || No || Path to TV Show trailer
|<trailer></trailer> || No || No || Not used
|-
|-
|
|
    <episodebookmark>
        <position></position>
    </episodebookmark>
|| No || No || Episode Bookmark in seconds. ''See: [[Episode_bookmark|Episode Bookmarks]]''<br>
Not used for Import
|-
|<syntaxhighlight lang="xml">
  <fileinfo>
  <fileinfo>
  <streamdetails>
    <streamdetails>
    <video>
      <video>
      <codec>h264</codec>
        <codec></codec>
      <aspect>1.777778</aspect>
        <aspect></aspect>
      <width>1920</width>
        <width></width>
      <height>1080</height>
        <height></height>
      <durationinseconds>2626</durationinseconds>
        <durationinseconds></durationinseconds>
      <stereomode></stereomode>
        <stereomode></stereomode>
    </video>
      </video>
    <audio>
      <audio>
      <codec>mp2</codec>
        <codec></codec>
      <language>eng</language>
        <language></language>
      <channels>2</channels>
        <channels></channels>
    </audio>
      </audio>
  </streamdetails>
      <subtitle>
        <language></language>
      </subtitle>
    </streamdetails>
  </fileinfo>
  </fileinfo>
|| No || No || While it is possible to manually set the information contained within the <streamdetails> tag, there is little point in doing so.
</syntaxhighlight>
Kodi will always overwrite this data when it plays back the video file.<br />  
|| No || Yes || Multiple entries of <audio> and <subtitles> accepted<br>
In other words, no matter how many times you try to manually set it, it will be overwritten the moment the video is played
In v17 and prior, {{kodi}} would overwrite these values on first play of the file.<br>
In v18 that process was removed and values in these tags will remain.<ref>https://github.com/xbmc/xbmc/pull/16342</ref>
|-
|-
|
|
Line 345: Line 640:
|| No || No ||   
|| No || No ||   
|-
|-
|<dateadded></dateadded> || No || No || Date the file was added to library. Can be altered in advancedsettings.xml
|<dateadded></dateadded> || No || No || mTime of the playable video file. Can be altered in advancedsettings.xml
|-
|
<art>
  <fanart></fanart>
  <poster></poster>
</art>
|| Yes || No || Art in use. Exported in Single File Export only
|}
|}






== 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.


= Sample nfo Files =
<syntaxhighlight lang="xml">
Provided below is a sample nfo file for the TV Show and for Episodes to assist with the manual creation process.
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<episodedetails>
    <title></title>
    <showtitle></showtitle>
    <userrating></userrating>
    <plot></plot>
    <runtime></runtime>
    <uniqueid type="" default="true"></uniqueid>
    <credits></credits>
    <director></director>
    <aired></aired>
    <actor>
        <name></name>
        <role></role>
        <order></order>
        <thumb></thumb>
    </actor>
</episodedetails>
</syntaxhighlight>


'''Press Expand at right edge of the green bar to view'''




== TV Show nfo ==
== Sample nfo ==
Sample TV Show nfo.  
Below is a sample nfo file that was exported from Kodi after scraping into the library using the default TheMovieDB-TV Shows scraper.


{{collapse top| TV Show nfo file  (click 'expand' to view)}}
'''Press Expand at right edge of the green bar to view'''
  <tvshow>
        <title>Angels</title>
        <originaltitle>TtvshowC09</originaltitle>
        <showtitle>Angels</showtitle>
        <sorttitle>TtvshowC15</sorttitle>
        <ratings>
            <rating name="default" max="10" default="true">
                <value>8.600000</value>
                <votes>88</votes>
            </rating>
        </ratings>
        <userrating>3</userrating>
        <top250>0</top250>
        <season>5</season>
        <episode>110</episode>
        <displayseason>-1</displayseason>
        <displayepisode>-1</displayepisode>
        <outline></outline>
        <plot>Angel is an American television series, a spin-off from the television series Buffy the Vampire Slayer. Angel (David Boreanaz), a 240-year old vampire cursed with a conscience, haunts the dark streets of Los Angeles alone</plot>
        <tagline></tagline>
        <runtime>45</runtime>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g7.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g2.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/12-g.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g8.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g6.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g3.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g4.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g10.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g9.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/graphical/71035-g5.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/text/71035.jpg</thumb>
        <thumb aspect="banner">http://thetvdb.com/banners/text/12.jpg</thumb>
        <thumb aspect="poster" type="season" season="0">http://thetvdb.com/banners/seasons/71035-0-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="5">http://thetvdb.com/banners/seasons/71035-5-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="3">http://thetvdb.com/banners/seasons/71035-3-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="4">http://thetvdb.com/banners/seasons/71035-4-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="2">http://thetvdb.com/banners/seasons/71035-2-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="2">http://thetvdb.com/banners/seasons/12-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="3">http://thetvdb.com/banners/seasons/71035-3-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="4">http://thetvdb.com/banners/seasons/12-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="4">http://thetvdb.com/banners/seasons/71035-4-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="5">http://thetvdb.com/banners/seasons/71035-5-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="3">http://thetvdb.com/banners/seasons/71035-3-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="2">http://thetvdb.com/banners/seasons/71035-2-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="5">http://thetvdb.com/banners/seasons/12-5.jpg</thumb>
        <thumb aspect="poster" type="season" season="1">http://thetvdb.com/banners/seasons/71035-1-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="1">http://thetvdb.com/banners/seasons/12-1.jpg</thumb>
        <thumb aspect="poster" type="season" season="1">http://thetvdb.com/banners/seasons/71035-1.jpg</thumb>
        <thumb aspect="poster" type="season" season="3">http://thetvdb.com/banners/seasons/12-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="4">http://thetvdb.com/banners/seasons/71035-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="2">http://thetvdb.com/banners/seasons/71035-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="3">http://thetvdb.com/banners/seasons/71035-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="0">http://thetvdb.com/banners/seasons/71035-0.jpg</thumb>
        <thumb aspect="poster" type="season" season="5">http://thetvdb.com/banners/seasons/71035-5.jpg</thumb>
        <thumb aspect="poster" type="season" season="1">http://thetvdb.com/banners/seasons/71035-1-5.jpg</thumb>
        <thumb aspect="poster" type="season" season="1">http://thetvdb.com/banners/seasons/71035-1-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="1">http://thetvdb.com/banners/seasons/71035-1-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="4">http://thetvdb.com/banners/seasons/71035-4-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="5">http://thetvdb.com/banners/seasons/71035-5-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="2">http://thetvdb.com/banners/seasons/71035-2-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="3">http://thetvdb.com/banners/seasons/71035-3-5.jpg</thumb>
        <thumb aspect="banner" type="season" season="5">http://thetvdb.com/banners/seasonswide/71035-5.jpg</thumb>
        <thumb aspect="banner" type="season" season="3">http://thetvdb.com/banners/seasonswide/71035-3.jpg</thumb>
        <thumb aspect="banner" type="season" season="4">http://thetvdb.com/banners/seasonswide/71035-4.jpg</thumb>
        <thumb aspect="banner" type="season" season="1">http://thetvdb.com/banners/seasonswide/71035-1.jpg</thumb>
        <thumb aspect="banner" type="season" season="2">http://thetvdb.com/banners/seasonswide/71035-2.jpg</thumb>
        <thumb aspect="poster">http://thetvdb.com/banners/posters/71035-1.jpg</thumb>
        <thumb aspect="poster">http://thetvdb.com/banners/posters/71035-2.jpg</thumb>
        <thumb aspect="poster">http://thetvdb.com/banners/posters/71035-5.jpg</thumb>
        <thumb aspect="poster">http://thetvdb.com/banners/posters/71035-8.jpg</thumb>
        <thumb aspect="poster">http://thetvdb.com/banners/posters/71035-3.jpg</thumb>
        <thumb aspect="poster">http://thetvdb.com/banners/posters/71035-4.jpg</thumb>
        <thumb aspect="poster" type="season" season="-1">http://thetvdb.com/banners/posters/71035-1.jpg</thumb>
        <thumb aspect="poster" type="season" season="-1">http://thetvdb.com/banners/posters/71035-2.jpg</thumb>
        <thumb aspect="poster" type="season" season="-1">http://thetvdb.com/banners/posters/71035-5.jpg</thumb>
        <thumb aspect="poster" type="season" season="-1">http://thetvdb.com/banners/posters/71035-8.jpg</thumb>
        <thumb aspect="poster" type="season" season="-1">http://thetvdb.com/banners/posters/71035-3.jpg</thumb>
        <thumb aspect="poster" type="season" season="-1">http://thetvdb.com/banners/posters/71035-4.jpg</thumb>
        <fanart url="http://thetvdb.com/banners/">
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-6.jpg">fanart/original/71035-6.jpg</thumb>
            <thumb dim="1920x1080" colors="|182,161,96|51,49,50|154,46,33|" preview="_cache/fanart/original/71035-3.jpg">fanart/original/71035-3.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-5.jpg">fanart/original/71035-5.jpg</thumb>
            <thumb dim="1280x720" colors="|87,86,55|6,1,7|118,106,84|" preview="_cache/fanart/original/71035-12.jpg">fanart/original/71035-12.jpg</thumb>
            <thumb dim="1920x1080" colors="|45,29,30|126,67,49|179,127,116|" preview="_cache/fanart/original/71035-4.jpg">fanart/original/71035-4.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-15.jpg">fanart/original/71035-15.jpg</thumb>
            <thumb dim="1280x720" colors="" preview="_cache/fanart/original/71035-2.jpg">fanart/original/71035-2.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-10.jpg">fanart/original/71035-10.jpg</thumb>
            <thumb dim="1920x1080" colors="|251,223,201|65,52,78|36,29,36|" preview="_cache/fanart/original/71035-1.jpg">fanart/original/71035-1.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-17.jpg">fanart/original/71035-17.jpg</thumb>
            <thumb dim="1280x720" colors="|253,251,254|0,0,8|219,153,119|" preview="_cache/fanart/original/71035-11.jpg">fanart/original/71035-11.jpg</thumb>
            <thumb dim="1280x720" colors="" preview="_cache/fanart/original/71035-9.jpg">fanart/original/71035-9.jpg</thumb>
            <thumb dim="1280x720" colors="" preview="_cache/fanart/original/71035-8.jpg">fanart/original/71035-8.jpg</thumb>
            <thumb dim="1280x720" colors="" preview="_cache/fanart/original/71035-13.jpg">fanart/original/71035-13.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-7.jpg">fanart/original/71035-7.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-14.jpg">fanart/original/71035-14.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-16.jpg">fanart/original/71035-16.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-19.jpg">fanart/original/71035-19.jpg</thumb>
            <thumb dim="1920x1080" colors="" preview="_cache/fanart/original/71035-18.jpg">fanart/original/71035-18.jpg</thumb>
        </fanart>
        <mpaa>TV-PG</mpaa>
        <playcount>0</playcount>
        <lastplayed></lastplayed>
        <file></file>
        <path>E:\TV Shows-Test - Copy\Angel\</path>
        <filenameandpath></filenameandpath>
        <basepath>E:\TV Shows-Test - Copy\Angel\</basepath>
        <episodeguide>
            <url cache="71035-en.xml">http://thetvdb.com/api/439DFEBA9D3059C6/series/71035/all/en.zip</url>
        </episodeguide>
        <id>71035</id>
        <uniqueid type="unknown" default="true">71035</uniqueid>
        <genre>Action</genre>
        <genre>Adventure</genre>
        <genre>Comedy</genre>
        <genre>Drama</genre>
        <genre>Fantasy</genre>
        <genre>Horror</genre>
        <tag>BestTag</tag>
        <premiered>1999-10-05</premiered>
        <year>1999</year>
        <status>Ended</status>
        <code></code>
        <aired></aired>
        <studio>The WB</studio>
        <trailer></trailer>
        <actor>
            <name>David Boreanaz</name>
            <role>Angel</role>
            <order>0</order>
            <thumb>http://thetvdb.com/banners/actors/6309.jpg</thumb>
        </actor>
        <actor>
            <name>J. August Richards</name>
            <role>Charles Gunn</role>
            <order>1</order>
            <thumb>http://thetvdb.com/banners/actors/6304.jpg</thumb>
        </actor>
        <actor>
            <name>Charisma Carpenter</name>
            <role>Cordelia Chase</role>
            <order>2</order>
            <thumb>http://thetvdb.com/banners/actors/6311.jpg</thumb>
        </actor>
        <actor>
            <name>Alexis Denisof</name>
            <role>Wesley Wyndam-Pryce</role>
            <order>3</order>
            <thumb>http://thetvdb.com/banners/actors/6307.jpg</thumb>
        </actor>
        <actor>
            <name>Glenn Quinn</name>
            <role>Alan Francis Doyle</role>
            <order>4</order>
            <thumb>http://thetvdb.com/banners/actors/6313.jpg</thumb>
        </actor>
        <actor>
            <name>Amy Acker</name>
            <role>Winifred &quot;Fred&quot; Burkle|Illyria</role>
            <order>5</order>
            <thumb>http://thetvdb.com/banners/actors/6312.jpg</thumb>
        </actor>
        <actor>
            <name>Mercedes McNab</name>
            <role>Harmony &quot;Harm&quot; Kendall</role>
            <order>6</order>
            <thumb>http://thetvdb.com/banners/actors/6310.jpg</thumb>
        </actor>
        <actor>
            <name>James Marsters</name>
            <role>Spike</role>
            <order>7</order>
            <thumb>http://thetvdb.com/banners/actors/6308.jpg</thumb>
        </actor>
        <actor>
            <name>Vincent Kartheiser</name>
            <role>Connor</role>
            <order>8</order>
            <thumb>http://thetvdb.com/banners/actors/6306.jpg</thumb>
        </actor>
        <actor>
            <name>Andy Hallett</name>
            <role>Lorne</role>
            <order>9</order>
            <thumb>http://thetvdb.com/banners/actors/6305.jpg</thumb>
        </actor>
        <actor>
            <name>Elisabeth Rohm</name>
            <role>Kate Lockley</role>
            <order>10</order>
            <thumb>http://thetvdb.com/banners/actors/109231.jpg</thumb>
        </actor>
        <actor>
            <name>Stephanie Romanov</name>
            <role>Lilah Morgan</role>
            <order>22</order>
            <thumb></thumb>
        </actor>
        <resume>
            <position>0.000000</position>
            <total>0.000000</total>
        </resume>
        <dateadded>2017-05-10 08:44:24</dateadded>
        <art>
            <banner>E:\TV Shows-Test - Copy\Angel\banner.jpg</banner>
            <fanart>E:\TV Shows-Test - Copy\Angel\fanart.jpg</fanart>
            <poster>E:\TV Shows-Test - Copy\Angel\poster.jpg</poster>
            <season num="-1">
                <poster>E:\TV Shows-Test - Copy\Angel\season-all-poster.jpg</poster>
            </season>
            <season num="0">
                <poster>http://thetvdb.com/banners/seasons/71035-0-2.jpg</poster>
            </season>
            <season num="1">
                <banner>http://thetvdb.com/banners/seasonswide/71035-1.jpg</banner>
                <poster>E:\TV Shows-Test - Copy\Angel\season01-poster.jpg</poster>
            </season>
            <season num="2">
                <banner>http://thetvdb.com/banners/seasonswide/71035-2.jpg</banner>
                <poster>E:\TV Shows-Test - Copy\Angel\season02-poster.jpg</poster>
            </season>
            <season num="3">
                <banner>http://thetvdb.com/banners/seasonswide/71035-3.jpg</banner>
                <poster>E:\TV Shows-Test - Copy\Angel\season03-poster.jpg</poster>
            </season>
            <season num="4">
                <banner>http://thetvdb.com/banners/seasonswide/71035-4.jpg</banner>
                <poster>E:\TV Shows-Test - Copy\Angel\season04-poster.jpg</poster>
            </season>
            <season num="5">
                <banner>http://thetvdb.com/banners/seasonswide/71035-5.jpg</banner>
                <poster>E:\TV Shows-Test - Copy\Angel\season05-poster.jpg</poster>
            </season>
        </art>
</tvshow>
{{collapse bottom}}
 
 
 
 
== TV Episode nfo ==
Sample TV Episode nfo.


{{collapse top| TV Episode nfo file  (click 'expand' to view)}}
{{collapse top| TV Episode nfo file  (click 'expand' to view)}}
  <episodedetails>
<syntaxhighlight lang="xml">
            <title>City of</title>
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
            <originaltitle>TepisodeC14</originaltitle>
<episodedetails>
            <showtitle>Angels</showtitle>
    <title>The Bone Orchard</title>
            <ratings>
    <showtitle>American Gods</showtitle>
                <rating name="default" max="10" default="true">
    <ratings>
                    <value>7.500000</value>
        <rating name="tmdb" max="10" default="true">
                    <votes>29</votes>
            <value>7.532000</value>
                </rating>
            <votes>31</votes>
            </ratings>
        </rating>
            <userrating>10</userrating>
    </ratings>
            <top250>0</top250>
    <userrating>0</userrating>
            <season>1</season>
    <top250>0</top250>
            <episode>1</episode>
    <season>1</season>
            <displayseason>-1</displayseason>
    <episode>1</episode>
            <displayepisode>-1</displayepisode>
    <displayseason>-1</displayseason>
            <outline></outline>
    <displayepisode>-1</displayepisode>
            <plot>Newly arrived in Los Angeles, Angel is befriended by  a half-demon named Doyle whose visions lead him to a powerful vampire whose next victim just may be Cordelia Chase.</plot>
    <outline></outline>
            <tagline></tagline>
    <plot>When Shadow Moon is released from prison early after the death of his wife, he meets Mr. Wednesday and is recruited as his bodyguard. Shadow discovers that this may be more than he bargained for.</plot>
            <runtime>43</runtime>
    <tagline></tagline>
            <thumb>http://thetvdb.com/banners/episodes/71035/31099.jpg</thumb>
    <runtime>0</runtime>
            <mpaa>TV-PG</mpaa>
    <thumb>http://image.tmdb.org/t/p/original/uvry4weK00pFLn7fxQ9M4m3Da2A.jpg</thumb>
            <playcount>0</playcount>
    <mpaa>16</mpaa>
            <lastplayed></lastplayed>
    <playcount>0</playcount>
            <file></file>
    <lastplayed></lastplayed>
            <path>E:\TV Shows-Test - Copy\Angel\</path>
    <id>1276153</id>
            <filenameandpath>E:\TV Shows-Test - Copy\Angel\Angel S01E01.mkv</filenameandpath>
    <uniqueid type="tmdb" default="true">1276153</uniqueid>
            <basepath>E:\TV Shows-Test - Copy\Angel\Angel S01E01.mkv</basepath>
    <genre>Drama</genre>
            <id>31099</id>
    <genre>Mystery</genre>
            <uniqueid type="unknown" default="true">31099</uniqueid>
    <genre>Sci-Fi &amp; Fantasy</genre>
            <genre>Action</genre>
    <credits>Bryan Fuller</credits>
            <genre>Adventure</genre>
    <credits>Michael Green</credits>
            <genre>Comedy</genre>
    <director>David Slade</director>
            <genre>Drama</genre>
    <premiered>2017-04-30</premiered>
            <genre>Fantasy</genre>
    <year>2017</year>
            <genre>Horror</genre>
    <status></status>
            <credits>Joss Whedon</credits>
    <code></code>
            <credits>David Greenwalt</credits>
    <aired>2017-04-30</aired>
            <director>Joss Whedon</director>
    <studio>Starz</studio>
            <premiered>1999-10-05</premiered>
    <trailer></trailer>
            <year>1999</year>
    <actor>
            <status></status>
        <name>Jonathan Tucker</name>
            <code>TepisodeC11</code>
        <role>&apos;Low Key&apos; Lyesmith</role>
            <aired>1999-10-05</aired>
        <order>10</order>
            <studio>The WB</studio>
        <thumb>http://image.tmdb.org/t/p/original/jvJpYDbwmUTACw7Yn7PKOP6CdlJ.jpg</thumb>
            <trailer></trailer>
    </actor>
            <fileinfo>
    <actor>
                <streamdetails>
        <name>Demore Barnes</name>
                    <video>
        <role>Mr. Ibis</role>
                        <codec>h264</codec>
        <order>11</order>
                        <aspect>1.777778</aspect>
        <thumb>http://image.tmdb.org/t/p/original/4rEVzSIFPgiN14xYQnjKcKQ7tYE.jpg</thumb>
                        <width>1920</width>
    </actor>
                        <height>1080</height>
    <actor>
                        <durationinseconds>2626</durationinseconds>
        <name>Betty Gilpin</name>
                        <stereomode></stereomode>
        <role>Audrey</role>
                    </video>
        <order>12</order>
                    <audio>
        <thumb>http://image.tmdb.org/t/p/original/xFeqyem5i4Kf0nFjBZ4Oi9NM26k.jpg</thumb>
                        <codec>mp2</codec>
    </actor>
                        <language>eng</language>
    <actor>
                        <channels>2</channels>
        <name>Beth Grant</name>
                    </audio>
        <role>Jack</role>
                </streamdetails>
        <order>13</order>
            </fileinfo>
        <thumb>http://image.tmdb.org/t/p/original/zAT9GvzJE0ytL3C36L461cgKI9p.jpg</thumb>
            <actor>
    </actor>
                <name>David Boreanaz</name>
    <actor>
                <role>Angel</role>
        <name>Joel Murray</name>
                <order>0</order>
        <role>Paunch</role>
                <thumb>http://thetvdb.com/banners/actors/6309.jpg</thumb>
        <order>14</order>
            </actor>
        <thumb>http://image.tmdb.org/t/p/original/t5syYfCgxbTC7XPrNeXhhhQULUf.jpg</thumb>
            <actor>
    </actor>
                <name>Gina McClain</name>
    <actor>
                <role></role>
        <name>Ricky Whittle</name>
                <order>0</order>
        <role>Shadow Moon</role>
                <thumb></thumb>
        <order>0</order>
            </actor>
        <thumb>http://image.tmdb.org/t/p/original/cjeDbVfBp6Qvb3C74Dfy7BKDTQN.jpg</thumb>
            <actor>
    </actor>
                <name>J. August Richards</name>
    <actor>
                <role>Charles Gunn</role>
        <name>Ian McShane</name>
                <order>1</order>
        <role>Mr. Wednesday</role>
                <thumb>http://thetvdb.com/banners/actors/6304.jpg</thumb>
        <order>1</order>
            </actor>
        <thumb>http://image.tmdb.org/t/p/original/pY9ud4BJwHekNiO4MMItPbgkdAy.jpg</thumb>
            <actor>
    </actor>
                <name>Sam Pancake</name>
    <actor>
                <role></role>
        <name>Emily Browning</name>
                <order>1</order>
        <role>Laura Moon</role>
                <thumb></thumb>
        <order>2</order>
            </actor>
        <thumb>http://image.tmdb.org/t/p/original/fa1Kyj02wxwcdS6EHb2i27TNXvU.jpg</thumb>
            <actor>
    </actor>
                <name>Charisma Carpenter</name>
    <actor>
                <role>Cordelia Chase</role>
        <name>Pablo Schreiber</name>
                <order>2</order>
        <role>Mad Sweeney</role>
                <thumb>http://thetvdb.com/banners/actors/6311.jpg</thumb>
        <order>3</order>
            </actor>
        <thumb>http://image.tmdb.org/t/p/original/uo8YljeePz3pbj7gvWXdB4gOOW4.jpg</thumb>
            <actor>
    </actor>
                <name>Renee Ridgeley</name>
    <actor>
                <role></role>
        <name>Bruce Langley</name>
                <order>2</order>
        <role>Technical Boy</role>
                <thumb></thumb>
        <order>4</order>
            </actor>
        <thumb>http://image.tmdb.org/t/p/original/f4EOWUmznLqboq8Ce7jnlkHVK3Y.jpg</thumb>
            <actor>
    </actor>
                <name>Alexis Denisof</name>
    <actor>
                <role>Wesley Wyndam-Pryce</role>
        <name>Yetide Badaki</name>
                <order>3</order>
        <role>Bilquis</role>
                <thumb>http://thetvdb.com/banners/actors/6307.jpg</thumb>
        <order>5</order>
            </actor>
        <thumb>http://image.tmdb.org/t/p/original/qfzkREHuI1JvMxBteIAjKX8qMEr.jpg</thumb>
            <actor>
    </actor>
                <name>Jon Ingrassia</name>
    <resume>
                <role></role>
        <position>0.000000</position>
                <order>3</order>
        <total>0.000000</total>
                <thumb></thumb>
    </resume>
            </actor>
    <dateadded>2017-10-07 14:25:47</dateadded>
            <actor>
</episodedetails>
                <name>Glenn Quinn</name>
</syntaxhighlight>
                <role>Alan Francis Doyle</role>
                <order>4</order>
                <thumb>http://thetvdb.com/banners/actors/6313.jpg</thumb>
            </actor>
            <actor>
                <name>Christian Kane</name>
                <role></role>
                <order>4</order>
                <thumb></thumb>
            </actor>
            <actor>
                <name>Amy Acker</name>
                <role>Winifred &quot;Fred&quot; Burkle|Illyria</role>
                <order>5</order>
                <thumb>http://thetvdb.com/banners/actors/6312.jpg</thumb>
            </actor>
            <actor>
                <name>Vyto Ruginis</name>
                <role></role>
                <order>5</order>
                <thumb></thumb>
            </actor>
            <actor>
                <name>Mercedes McNab</name>
                <role>Harmony &quot;Harm&quot; Kendall</role>
                <order>6</order>
                <thumb>http://thetvdb.com/banners/actors/6310.jpg</thumb>
            </actor>
            <actor>
                <name>Josh Holloway</name>
                <role></role>
                <order>6</order>
                <thumb></thumb>
            </actor>
            <actor>
                <name>James Marsters</name>
                <role>Spike</role>
                <order>7</order>
                <thumb>http://thetvdb.com/banners/actors/6308.jpg</thumb>
            </actor>
            <actor>
                <name>Tracy Middendorf</name>
                <role></role>
                <order>7</order>
                <thumb></thumb>
            </actor>
            <actor>
                <name>Vincent Kartheiser</name>
                <role>Connor</role>
                <order>8</order>
                <thumb>http://thetvdb.com/banners/actors/6306.jpg</thumb>
            </actor>
            <actor>
                <name>Michael Mantell</name>
                <role></role>
                <order>8</order>
                <thumb></thumb>
            </actor>
            <actor>
                <name>Andy Hallett</name>
                <role>Lorne</role>
                <order>9</order>
                <thumb>http://thetvdb.com/banners/actors/6305.jpg</thumb>
            </actor>
            <actor>
                <name>Ron Rifkin</name>
                <role></role>
                <order>9</order>
                <thumb></thumb>
            </actor>
            <actor>
                <name>Elisabeth Rohm</name>
                <role>Kate Lockley</role>
                <order>10</order>
                <thumb>http://thetvdb.com/banners/actors/109231.jpg</thumb>
            </actor>
            <actor>
                <name>Stephanie Romanov</name>
                <role>Lilah Morgan</role>
                <order>22</order>
                <thumb></thumb>
            </actor>
            <resume>
                <position>0.000000</position>
                <total>0.000000</total>
            </resume>
            <dateadded>2017-05-01 09:08:24</dateadded>
            <art>
                <thumb>E:\TV Shows-Test - Copy\Angel\Angel S01E01-thumb.jpg</thumb>
            </art>
  </episodedetails>
{{collapse bottom}}
{{collapse bottom}}






= Technical Notes =
= References =
There are differences in tags used by Single File Export and Separate File Export. Though testing reveals that transposing tages between the two has no detrimental affect on the scrape.
<references />
 
{|class="prettytable"
! colspan="23" style="background-color:#E6E6E6;" | '''TV Show<br/>'''
|-
! XML Tag
! Exported in
Single File
! Exported in
Separate File
! Notes
|-
|<file></file> || Yes || No ||
|-
|<path></path> || Yes || No ||
|-
|<filenameandpath></filenameandpath> || Yes || No ||
|-
|<basepath></basepath> || Yes || No ||
|-
|
<art>
  <banner></banner>
  <fanart></fanart>
  <poster></poster>
  <season num=""></season>
</art>
|| Yes || No ||
|-
! colspan="23" style="background-color:#E6E6E6;" | '''TV Episode<br/>'''
|-
|<file></file> || Yes || No ||
|-
|<path></path> || Yes || No ||
|-
|<filenameandpath></filenameandpath> || Yes || No ||
|-
|<basepath></basepath> || Yes || No ||
|-
|<actor></actor> || Yes || Yes || Separate File saves in seemingly random order.
|-
|
<art>
  <thumb></thumb>
</art>
|| Yes || No ||
|}
 
 
 




Line 878: Line 807:




{{updated|17}}
{{updated|18}}
[[Category:Guides]]
[[Category:Guides]]
[[Category:First time user]]
[[Category:First time user]]
[[Category:FAQ]]
[[Category:FAQ]]
[[Category:Karellen]]
[[Category:Manual]]
[[Category:Manual]]
[[Category:Index]]
[[Category:Index]]

Revision as of 23:00, 14 January 2020

NFO Contents

NFO Main Page


See also:


Return to:

Home icon grey.png   ▶ NFO files ▶ TV shows


Requirements

TV Shows and Episodes must abide by the standard naming conventions even if you are using nfo files. The scanner still determines the TV Show name from the folder name and Season and Episode numbering from the episode filename, not from the NFO file.

If you choose to use NFO Files, TV Shows require the following:

  1. One nfo file for the TV Show. This file holds the overall show information
  2. One nfo file for each Episode. This file holds information specific to that episode

For one TV Show with 10 episodes, you will require 11 nfo files.


The order of importing metadata is as follows:

  1. nfo file. If no nfo file exists, then
  2. Depending on your scraper settings for your source, either
    1. Online scraper sites- if a scraper is set in your source settings
    2. Nothing- if Local Info Only is set


episodeguide URL

The <episodeguide> URL is saved in the tvshow.nfo file.

When using the scrapers, the <episodeguide> URL is a critical component of the scraping process that ensures episodes are correctly scraped. The <episodeguide> URL is provided by the information provider in a format that they have designed. The URL is not interchangeable between information providers. i.e. you cannot use the TVDB URL while using TheMovieDB scraper.

When scraping, once a TV Show has been identified via the folder name, the scraper asks the site to provide the link to all the episodes for the show. This is provided in the format of the <episodeguide> URL from which all the metadata for the individual episodes is downloaded.

Without the <episodeguide> no episodes will be scraped.


When using NFO Files knowing whether to include the <episodeguide> can be tricky. Some points that hopefully will explain how and when to use it for your own scenario:

  • If you are using nfo files exclusively, then the <episodeguide> is not required in the tvshow.nfo file. Be aware that any episodes missing nfo files will not be scanned or scraped
  • If you have a mix of nfo files and no nfo files for episodes, then the <episodeguide> is required.
  • If your tvshow.nfo file does not have the <episodeguide>, and you require it, the scraper will not download it. Delete your tvshow.nfo file and Refresh the TV Show and the scraper will download the <episodeguide> URL.
  • You can have episode nfo files without the tvshow.nfo file.
  • Creating your own <episodeguide> URL is tricky but you can attempt it by reading the What if I'm using NFO files? section in this thread... Forum Thread
  • If you include the <episodeguide>, then you need to have the correct scraper active. Remember that the <episodeguide> URL is not interchangeable between scrapers. Using Local Information Only will not change this requirement.
  • TheTVDB <episodeguide> used by Kodi is v2 from the v2 API. v1 is not recognised by Kodi.


Known Issues

  • v18 introduced a bug where any class of nfo file can be scanned into any part of the video library. See Issue 16112


TV Show

This section deals with the requirement for the tvshow.nfo file. Episode nfo files are discussed in Section 3 below.


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.

The tvshow.nfo file is placed inside the TV Show folder. The nfo filename is actually tvshow.nfo. Do not rename it with the title of the tv show. See image for example

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:

  1. Scrape the metadata from the online source set in your scraper or,
  2. If you have Local Info Only set as your scraper, then no entry will be made into the library.



nfo Tags

The following table lists most available XML tags. [1]

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 (xml) Tag Required Multiple Notes
<tvshow></tvshow> 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 of the TV Show
<originaltitle></originaltitle> No No The original title, usually in the language of the country of origin.
<showtitle></showtitle> No No Not in common use, but some skins may display an alternate title
<sorttitle></sorttitle> No No Allows alternate title sort without modifying the TV Show title. Not displayed in any library listing.
 <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 ommitted

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

<rating name="imdb" max="10">
<rating name="trakt" max="10">
<rating name="tvmaze" 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
<season></season> No No Number of seasons of this TV Show in the library
<episode></episode> No No Number of episodes of this TV Show in the library
<displayepisode></displayepisode> No No Not used
<displayseason></displayseason> No No Not used
<namedseason number="1"></namedseason> No No Not Used
<outline></outline> No No Not Used
<plot></plot> No No Can contain more information on multiple lines, will be wrapped
<tagline></tagline> No No Short TV Show slogan
<runtime></runtime> No No Not used
<thumb aspect="" preview=""></thumb>

<thumb aspect="poster" type="season" season="" preview=""></thumb>

No Yes Path to available TV Show Posters

Example use of aspect=""

<thumb aspect="banner"
<thumb aspect="clearart"
<thumb aspect="clearlogo"
<thumb aspect="landscape"
<thumb aspect="poster"

type="season" used for season specific artwork
season="2" nominates season number eg. season 2

<fanart>
    <thumb preview=""></thumb>
</fanart>
No Yes^ Path to available TV Show 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 local rating system
<playcount></playcount> No No Number of times TV show has been played. Will only ever show 0 or 1. Episodes track playcounts

Setting this to 1 will mark the TV Show as watched if the importwatchedstate flag is set in advancedsettings.xml

<lastplayed></lastplayed> No No Date TV Show was last played
<episodeguide>
  <url cache=""></url>
</episodeguide>
Yes/No No Read section 1.1 episodeguide URL above

When using TVDB scraper, Kodi will only read the URL created by the TVDB v2 API [2]
When a URL is used, the corresponding scraper must be set.

<id></id> No No The default ID.

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

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

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

<uniqueid type="imdb">
<uniqueid type="tvdb">
<uniqueid type="tvmaze">
<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 ommitted

Example of complete entry...

<uniqueid type="tmdb" default="true">
<uniqueid type="imdb" default="false"> or <uniqueid type="imdb">
<genre></genre> No Yes Genre
<tag></tag> No Yes Tags. See: Video library tags
<premiered></premiered> No No Release date of TV Show. Comes from Aired Date of the first episode.

Format as 2019-01-31

<year></year> No No Release Year.

Do not use. Use <premiered> instead

<status></status> No No Continuing or Ended show
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 TV Show trailer
<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

Supports "clear" attribute

<namedseason number=""></namedseason> No Yes Allows naming of Seasons- eg Game of Thrones named seasons

number="" = Season number to be renamed

<resume>
  <position></position>
  <total></total>
</resume>
No No Not used for TV Show
<dateadded></dateadded> No No mTime of the playable video file. Can be altered in advancedsettings.xml


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.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<tvshow>
    <title></title>
    <plot></plot>
    <userrating></userrating>
    <mpaa></mpaa>
    <uniqueid type="" default="true"></uniqueid>
    <genre></genre>
    <premiered></premiered>
    <status></status>
    <studio></studio>
    <actor>
        <name></name>
        <role></role>
        <order></order>
        <thumb></thumb>
    </actor>
    <namedseason number="1"></namedseason>
</tvshow>


Sample nfo

Below is a sample nfo file that was exported from Kodi after scraping into the library using the default TheMovieDB-TV Shows scraper.

Press Expand at right edge of the green bar to view


Episodes

This section deals with the requirement for the episode nfo file.


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.

The episode nfo file is placed alongside each episode video file. The episode nfo filename is the same as the video filename but with the .nfo extension. See image below for examples.

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:

  1. Scrape the metadata from the online source set in your scraper or,
  2. If you have Local Info Only set as your scraper, then no entry will be made into the library.



nfo Tags

The following table lists most available XML tags. [3]

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.

For multi-part episodes, add multiple <episodedetails> XML blocks in succession in the same nfo file


NFO (xml) Tag Required Multiple Notes
<episodedetails></episodedetails> 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 episode
<originaltitle></originaltitle> No No The original title, usually in the language of the country of origin.
<showtitle></showtitle> No No Name of the tv show this episode belongs to
 <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 ommitted

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

<rating name="imdb" max="10">
<rating name="trakt" max="10">
<rating name="tvmaze" 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 Not used
<season></season> No No Ignored on Import. Season is read from filename
<episode></episode> No No Ignored on Import. Episode is read from filename
<displayepisode></displayepisode> No No Used to place Specials episodes in the correct episode order
<displayseason></displayseason> No No Used to place Specials episodes in the correct season
<outline></outline> No No Not used
<plot></plot> No No Can contain more information on multiple lines, will be wrapped
<tagline></tagline> No No Short slogan of the episode. No skins use this.
<runtime></runtime> No No Minutes only. Overwritten when episode played
<thumb></thumb> No Yes Path to episode artwork
<mpaa></mpaa> No No Inherited from TV Show nfo file. Ignored on import.
<playcount></playcount> No No Number of times episode has been played.

Setting this to 1 or greater will mark the episode as watched if the importwatchedstate flag is set in advancedsettings.xml

<lastplayed></lastplayed> No No Date episode was last played
<id></id> No No The default ID.

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

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

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

<uniqueid type="imdb">
<uniqueid type="tvdb">
<uniqueid type="tvmaze">
<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 ommitted

Example of complete entry...

<uniqueid type="tmdb" default="true">
<uniqueid type="imdb" default="false"> or <uniqueid type="imdb">
<genre></genre> No Yes Inherited from TV Show. Ignored on import.
<credits></credits> No Yes Field for writers.
<director></director> No Yes Director
<premiered></premiered> No No Release date of TV Show. Format as 2019-01-31

Use the <aired> field below to add the aired date of the episode.

<year></year> No No Release Year.

Do not use. Use <aired> instead

<status></status> No No Not used
No No Not used
<aired></aired> No No Original air date of the episode
<studio></studio> No Yes Production studio. Inherited from TV Show
<trailer></trailer> No No Not used
   <episodebookmark>
       <position></position>
   </episodebookmark>
No No Episode Bookmark in seconds. See: Episode Bookmarks

Not used for Import

 <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.[4]

<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

Supports "clear" attribute

<resume>
  <position></position>
  <total></total>
</resume>
No No
<dateadded></dateadded> No No mTime of the playable video file. Can be altered in advancedsettings.xml


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.

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<episodedetails>
    <title></title>
    <showtitle></showtitle>
    <userrating></userrating>
    <plot></plot>
    <runtime></runtime>
    <uniqueid type="" default="true"></uniqueid>
    <credits></credits>
    <director></director>
    <aired></aired>
    <actor>
        <name></name>
        <role></role>
        <order></order>
        <thumb></thumb>
    </actor>
</episodedetails>


Sample nfo

Below is a sample nfo file that was exported from Kodi after scraping into the library using the default TheMovieDB-TV Shows scraper.

Press Expand at right edge of the green bar to view


References


Return to top