NFO files/TV shows - Revision history

Crystalp: Add originallanguage

2026-01-11T03:21:47Z

Add originallanguage

← Older revision		Revision as of 03:21, 11 January 2026
Line 189:		Line 189:
	\|-		\|-
	\|<seasonplot number=""></seasonplot> \|\| No \|\| Yes \|\| Plot of a season. Can contain more information on multiple lines, will be wrapped. ex:<br>		\|<seasonplot number=""></seasonplot> \|\| No \|\| Yes \|\| Plot of a season. Can contain more information on multiple lines, will be wrapped. ex:<br>
	<seasonplot number="1">Plot of the season</seasonplot~~> <br~~>		<seasonplot number="1">Plot of the season</seasonplot>
	Added in Kodi v22.		Added in Kodi v22.
			\|-
			\|<originallanguage></originallanguage> \|\| No \|\| No \|\| Main spoken language of the show (import: ISO 639-1, 639-2, BCP 47 or English language name. export: BCP 47)<br>
			example uses:<br>
			:<originallanguage>fr</originallanguage>
			:<originallanguage>fr-CA</originallanguage>
			:<originallanguage>French</originallanguage>
			Added in Kodi v22
	\|}		\|}

Crystalp: Add seasonplot

2026-01-11T02:27:17Z

Add seasonplot

← Older revision		Revision as of 02:27, 11 January 2026
Line 187:		Line 187:
	\|-		\|-
	\|<dateadded></dateadded> \|\| No \|\| No \|\| mTime of the playable video file. Can be altered in advancedsettings.xml<br>See... '''[[Advancedsettings.xml#videolibrary]]'''		\|<dateadded></dateadded> \|\| No \|\| No \|\| mTime of the playable video file. Can be altered in advancedsettings.xml<br>See... '''[[Advancedsettings.xml#videolibrary]]'''
			\|-
			\|<seasonplot number=""></seasonplot> \|\| No \|\| Yes \|\| Plot of a season. Can contain more information on multiple lines, will be wrapped. ex:<br>
			<seasonplot number="1">Plot of the season</seasonplot> <br>
			Added in Kodi v22.
	\|}		\|}

Crystalp: clarify that tv show tagline is functional only from v22. For some reason the tag was already in the documentation but the tag was not functional yet.

2026-01-11T01:26:54Z

clarify that tv show tagline is functional only from v22. For some reason the tag was already in the documentation but the tag was not functional yet.

← Older revision		Revision as of 01:26, 11 January 2026
Line 90:		Line 90:
	\|<plot></plot> \|\| No \|\| No \|\| 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 \|\| Short TV Show slogan		\|<tagline></tagline> \|\| No \|\| No \|\| Short TV Show slogan (added in v22)
	\|-		\|-
	\|<runtime></runtime> \|\| No \|\| No \|\| Not used		\|<runtime></runtime> \|\| No \|\| No \|\| Not used

Karellen: Updated for v20

2023-02-13T03:02:32Z

Updated for v20

← Older revision		Revision as of 03:02, 13 February 2023
Line 199:		Line 199:

	{{top}}		{{top}}
	{{updated\|19}}		{{updated\|20}}

	[[Category:Karellen]]		[[Category:Karellen]]
	[[Category:Video library]]		[[Category:Video library]]

CastagnaIT: Fixed `tag`


2022-12-26T10:31:52Z
Fixed <code> tag

				
				
				
				
				
				← Older revision
				Revision as of 10:31, 26 December 2022
				
Line 158:
Line 158:
|<status></status> || No || No || Continuing or Ended show |<status></status> || No || No || Continuing or Ended show
|- |-
| <code><code></code></code> || No || No || Not used |<nowiki><code></code></nowiki> || No || No || Not used
|- |-
|<aired></aired> || No || No || Not used |<aired></aired> || No || No || Not used



CastagnaIT: Improved date format info
2022-12-25T10:13:25Z
Improved date format info

				
				
				
				
				
				← Older revision
				Revision as of 10:13, 25 December 2022
				
Line 150:
Line 150:
|- |-
|<premiered></premiered> || No || No || Release date of TV Show. Comes from Aired Date of the first episode.<br> |<premiered></premiered> || No || No || Release date of TV Show. Comes from Aired Date of the first episode.<br>
Format as ''2019-01-31'' Format as ''yyyy-mm-dd''
|- |-
|<year></year> || No || No || Release Year.<br> |<year></year> || No || No || Release Year.<br>



CastagnaIT: More details for deprecated  tag
2022-12-25T09:46:24Z
More details for deprecated <year> tag

				
				
				
				
				
				← Older revision
				Revision as of 09:46, 25 December 2022
				
Line 153:
Line 153:
|- |-
|<year></year> || No || No || Release Year.<br> |<year></year> || No || No || Release Year.<br>
Do not use. Use <premiered> instead {{note|Kodi v17: Tag deprecated, use <premiered> tag instead.}}
{{note|Kodi v20: Use <premiered> tag only.}}
|- |-
|<status></status> || No || No || Continuing or Ended show |<status></status> || No || No || Continuing or Ended show



Karellen: Update episode guide
2022-12-23T18:24:15Z
Update episode guide

				
				
				
				
				
				← Older revision
				Revision as of 18:24, 23 December 2022
				
Line 14:
Line 14:



= episodeguide URL = = episodeguide URL =
The <episodeguide> is the tag that allows the scrapers to find the episodes belonging to the TV Show at the site of the information provider. It is a complex item and its format depends on which information provider is being accessed, and whether a Python or XML based scraper is being used. The <episodeguide> is the tag that allows the scrapers to find the episodes belonging to the TV Show at the site of the information provider.



It is not normal to manually create a tvshow.nfo that require an <episodeguide>. If the TV show and episodes exist at the site of an information provider, then you should use the {{kodi}} scrapers to scrape the TV show and episodes Due to an issue where the UniqueID for TV shows and movies across TV Maze, TMDB and TheTVDB are '''not''' unique, the episode guide was converted to a JSON format which clearly identified which site the UniqueID belongs to.



If you find that you need to create nfo files, then it is assumed that the tv show does not exist at any of the information provider sites, so the <episodeguide> URL does not exist either and the tag is not needed. These changes have been incorporated into v19 and later releases of {{kodi}}. [https://forum.kodi.tv/showthread.php?tid=370489 Read more here]






Line 96:
Line 96:
|<thumb aspect="" preview=""></thumb> |<thumb aspect="" preview=""></thumb>
<thumb aspect="poster" type="season" season="" preview=""></thumb>   <thumb aspect="poster" type="season" season="" preview=""></thumb>  
|| No || Yes || Path to available TV Show Posters. Not needed when using local artwork<br> || No || Yes || Path to available TV Show Posters. Not used for locally saved artwork<br>
Example use of ''aspect=""'' Example use of ''aspect=""''
:<thumb aspect="banner" :<thumb aspect="banner"
Line 111:
Line 111:
  </fanart>   </fanart>
|| No || Yes^ || Path to available TV Show fanart.<br> || No || Yes^ || Path to available TV Show fanart.<br>
:^ Multiple <thumb> entries allowed between the <fanart></fanart> tags :^ Multiple <thumb> entries allowed between the <fanart></fanart> tags<br>
Not used for locally saved artwork
|- |-
|<mpaa></mpaa> || No || No || Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country local rating system |<mpaa></mpaa> || No || No || Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country local rating system
Line 121:
Line 122:
| |
  <episodeguide>   <episodeguide>
    <url cache=""></url>     {"tmdb": "76479", "imdb": "tt1190634", "tvdb": "355567"}
  </episodeguide>   </episodeguide>
|| Yes/No || No || Read section ''1.1 episodeguide URL'' above<br> || 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> For v19 and later, a JSON format is used. ''[https://forum.kodi.tv/showthread.php?tid=370489 Read more here]''<br>
When a URL is used, the corresponding scraper must be set. TVDB scraper uses TheTVDB v4 API<br>
Other providers: ''"tvmaze":'' and ''"tvrage":''
|- |-
|<id></id> || No || No || The default ID. <br> |<id></id> || No || No || The default ID. <br>
Line 173:
Line 175:
Supports "clear" attribute Supports "clear" attribute
|- |-
| <namedseason number=""></namedseason> || No || Yes || Allows naming of Seasons- eg Game of Thrones named seasons<br> | <namedseason number=""></namedseason> || No || Yes || Allows naming of Seasons. eg:<br>
''number=""'' = Season number to be renamed  <namedseason number="1">Season 1: The Maze</namedseason>
|- |-
| |



Karellen: Updated for v19
2021-04-23T00:12:37Z
Updated for v19
Show changes


Karellen at 00:01, 21 July 2020
2020-07-21T00:01:40Z


				
				
				
				
				
				← Older revision
				Revision as of 00:01, 21 July 2020
				
Line 594:
Line 594:
         <position></position>          <position></position>
     </episodebookmark>      </episodebookmark>
|| No || No || Episode Bookmark in seconds. ''See: [[Episode_bookmark|Episode Bookmarks]]''<br> || No || No || Episode Bookmark in seconds. ''See: [[Bookmarks_and_chapters|Episode Bookmarks]]''<br>
Not used for Import Not used for Import
|- |-

← Older revision		Revision as of 10:31, 26 December 2022
Line 158:		Line 158:
	\|<status></status> \|\| No \|\| No \|\| Continuing or Ended show		\|<status></status> \|\| No \|\| No \|\| Continuing or Ended show
	\|-		\|-
	\| <~~code~~><code></code></~~code~~> \|\| No \|\| No \|\| Not used		\|<nowiki><code></code></nowiki> \|\| No \|\| No \|\| Not used
	\|-		\|-
	\|<aired></aired> \|\| No \|\| No \|\| Not used		\|<aired></aired> \|\| No \|\| No \|\| Not used

← Older revision		Revision as of 10:13, 25 December 2022
Line 150:		Line 150:
	\|-		\|-
	\|<premiered></premiered> \|\| No \|\| No \|\| Release date of TV Show. Comes from Aired Date of the first episode.<br>		\|<premiered></premiered> \|\| No \|\| No \|\| Release date of TV Show. Comes from Aired Date of the first episode.<br>
	Format as ''~~2019~~-01-31''		Format as ''yyyy-mm-dd''
	\|-		\|-
	\|<year></year> \|\| No \|\| No \|\| Release Year.<br>		\|<year></year> \|\| No \|\| No \|\| Release Year.<br>

← Older revision		Revision as of 09:46, 25 December 2022
Line 153:		Line 153:
	\|-		\|-
	\|<year></year> \|\| No \|\| No \|\| Release Year.<br>		\|<year></year> \|\| No \|\| No \|\| Release Year.<br>
	~~Do not~~ use. Use <premiered> ~~instead~~		{{note\|Kodi v17: Tag deprecated, use <premiered> tag instead.}}
			{{note\|Kodi v20: Use <premiered> tag only.}}
	\|-		\|-
	\|<status></status> \|\| No \|\| No \|\| Continuing or Ended show		\|<status></status> \|\| No \|\| No \|\| Continuing or Ended show

← Older revision		Revision as of 18:24, 23 December 2022
Line 14:		Line 14:

	= episodeguide URL =		= episodeguide URL =
	The <episodeguide> is the tag that allows the scrapers to find the episodes belonging to the TV Show at the site of the information provider~~. It is a complex item and its format depends on which information provider is being accessed, and whether a Python or XML based scraper is being used~~.		The <episodeguide> is the tag that allows the scrapers to find the episodes belonging to the TV Show at the site of the information provider.

	~~It is not normal~~ to ~~manually create a tvshow.nfo that require~~ an ~~<episodeguide>. If~~ the TV ~~show~~ and ~~episodes exist at~~ the site ~~of an information provider, then you should use~~ the ~~{{kodi}} scrapers~~ to ~~scrape the TV show and episodes~~		Due to an issue where the UniqueID for TV shows and movies across TV Maze, TMDB and TheTVDB are '''not''' unique, the episode guide was converted to a JSON format which clearly identified which site the UniqueID belongs to.

	~~If you find that you need to create nfo files, then it is assumed that the~~ tv ~~show does not exist at any of the information provider sites, so the <episodeguide> URL does not exist either and the tag is not needed~~.		These changes have been incorporated into v19 and later releases of {{kodi}}. [https://forum.kodi.tv/showthread.php?tid=370489 Read more here]


Line 96:		Line 96:
	\|<thumb aspect="" preview=""></thumb>		\|<thumb aspect="" preview=""></thumb>
	<thumb aspect="poster" type="season" season="" preview=""></thumb>		<thumb aspect="poster" type="season" season="" preview=""></thumb>
	\|\| No \|\| Yes \|\| Path to available TV Show Posters. Not ~~needed when using local~~ artwork<br>		\|\| No \|\| Yes \|\| Path to available TV Show Posters. Not used for locally saved artwork<br>
	Example use of ''aspect=""''		Example use of ''aspect=""''
	:<thumb aspect="banner"		:<thumb aspect="banner"
Line 111:		Line 111:
	</fanart>		</fanart>
	\|\| No \|\| Yes^ \|\| Path to available TV Show fanart.<br>		\|\| No \|\| Yes^ \|\| Path to available TV Show fanart.<br>
	:^ Multiple <thumb> entries allowed between the <fanart></fanart> tags		:^ Multiple <thumb> entries allowed between the <fanart></fanart> tags<br>
			Not used for locally saved artwork
	\|-		\|-
	\|<mpaa></mpaa> \|\| No \|\| No \|\| Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country local rating system		\|<mpaa></mpaa> \|\| No \|\| No \|\| Country specific mpaa rating system. Check with skin author which prefix is required to diplay your country local rating system
Line 121:		Line 122:
	\|		\|
	<episodeguide>		<episodeguide>
	~~<url cache=~~""~~></url>~~		{"tmdb": "76479", "imdb": "tt1190634", "tvdb": "355567"}
	</episodeguide>		</episodeguide>
	\|\| Yes/No \|\| No \|\| Read section ''1.1 episodeguide URL'' above<br>		\|\| 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>		For v19 and later, a JSON format is used. ''[https://forum.kodi.tv/showthread.php?tid=370489 Read more here]''<br>
	~~When a URL is used, the corresponding scraper must be set.~~		TVDB scraper uses TheTVDB v4 API<br>
			Other providers: ''"tvmaze":'' and ''"tvrage":''
	\|-		\|-
	\|<id></id> \|\| No \|\| No \|\| The default ID. <br>		\|<id></id> \|\| No \|\| No \|\| The default ID. <br>
Line 173:		Line 175:
	Supports "clear" attribute		Supports "clear" attribute
	\|-		\|-
	\| <namedseason number=""></namedseason> \|\| No \|\| Yes \|\| Allows naming of Seasons- eg ~~Game of Thrones named seasons~~<br>		\| <namedseason number=""></namedseason> \|\| No \|\| Yes \|\| Allows naming of Seasons. eg:<br>
	''number=""~~'' =~~ Season ~~number to be renamed~~		<namedseason number="1">Season 1: The Maze</namedseason>
	\|-		\|-
	\|		\|

← Older revision		Revision as of 00:01, 21 July 2020
Line 594:		Line 594:
	<position></position>		<position></position>
	</episodebookmark>		</episodebookmark>
	\|\| No \|\| No \|\| Episode Bookmark in seconds. ''See: [[~~Episode_bookmark~~\|Episode Bookmarks]]''<br>		\|\| No \|\| No \|\| Episode Bookmark in seconds. ''See: [[Bookmarks_and_chapters\|Episode Bookmarks]]''<br>
	Not used for Import		Not used for Import
	\|-		\|-

NFO files/TV shows - Revision history

Crystalp: Add originallanguage

Crystalp: Add seasonplot

Crystalp: clarify that tv show tagline is functional only from v22. For some reason the tag was already in the documentation but the tag was not functional yet.

Karellen: Updated for v20

CastagnaIT: Fixed tag

CastagnaIT: Improved date format info

CastagnaIT: More details for deprecated tag

Karellen: Update episode guide

Karellen: Updated for v19

Karellen at 00:01, 21 July 2020

CastagnaIT: Fixed `tag`