NFO files/Movies - Revision history

Karellen: default values

2026-04-13T07:09:27Z

default values

Crystalp: Add originallanguage

2026-01-11T03:21:55Z

Add originallanguage

← Older revision		Revision as of 03:21, 11 January 2026
Line 209:		Line 209:
	\|-		\|-
	\|<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]]'''
			\|-
			\|<originallanguage></originallanguage> \|\| No \|\| No \|\| Main spoken language of the movie (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
	\|}		\|}

Karellen at 09:57, 28 December 2023

2023-12-28T09:57:42Z

← Older revision		Revision as of 09:57, 28 December 2023
Line 168:		Line 168:
	<durationinseconds></durationinseconds>		<durationinseconds></durationinseconds>
	<stereomode></stereomode>		<stereomode></stereomode>
			<hdrtype></hdrtype>
	</video>		</video>
	<audio>		<audio>
Line 181:		Line 182:
	\|\| No \|\| Yes \|\| Multiple entries of <audio> and <subtitles> accepted<br>		\|\| No \|\| Yes \|\| Multiple entries of <audio> and <subtitles> accepted<br>
	In v17 and prior, {{kodi}} would overwrite these values on first play of the file.<br>		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>		In v18 that process was removed and values in these tags will remain.<ref>https://github.com/xbmc/xbmc/pull/16342</ref><br><br>

			Accepted values for <hdrtype></hdrtype> are:
			* empty = SDR;
			* hdr10;
			* dolbyvision;
			* hlg
	\|-		\|-
	\|		\|

Karellen: Updated for v20

2023-02-13T03:05:39Z

Updated for v20

← Older revision		Revision as of 03:05, 13 February 2023
Line 214:		Line 214:

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

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

CastagnaIT: Fixed `tag`


2022-12-26T10:33:10Z
Fixed <code> tag

				
				
				
				
				
				← Older revision
				Revision as of 10:33, 26 December 2022
				
Line 150:
Line 150:
|<status></status> || No || No || Not used |<status></status> || No || No || Not used
|- |-
|<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: More details for deprecated  tag
2022-12-25T09:47:51Z
More details for deprecated <year> tag

				
				
				
				
				
				← Older revision
				Revision as of 09:47, 25 December 2022
				
Line 145:
Line 145:
|- |-
|<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 || Not used |<status></status> || No || No || Not used



Karellen: Updated for v19
2021-04-23T00:07:57Z
Updated for v19
Show changes


Karellen: /* nfo Name and Location */
2021-04-20T00:45:08Z
nfo Name and Location

				
				
				
				
				
				← Older revision
				Revision as of 00:45, 20 April 2021
				
Line 32:
Line 32:






;<VideoFileName>.nfo <section begin="MovieNFONaming" />;<VideoFileName>.nfo
:*NFO Files are named the same as the video file except with the ''.nfo'' extension. See image below. :*NFO Files are named the same as the video file except with the ''.nfo'' extension. See image below.
:*We recommend using this format to name nfo files. :*We recommend using this format to name nfo files.
Line 40:
Line 40:
:*If the above setting is not enabled, {{kodi}} will ignore the ''movie.nfo''. If the ''<VideoFileName>.nfo'' formatted file is available, {{kodi}} will scan this one instead, otherwise an online scrape will be performed. :*If the above setting is not enabled, {{kodi}} will ignore the ''movie.nfo''. If the ''<VideoFileName>.nfo'' formatted file is available, {{kodi}} will scan this one instead, otherwise an online scrape will be performed.
:*If you use ''movie.nfo'' and later Export your library to Separate Files, {{kodi}} will still create the nfo file in the ''<VideoFileName>.nfo'' format and two nfo files will exist. If a Refresh or rescan is run in future, the ''<VideoFileName>.nfo'' file will be ignored in favour of ''movie.nfo'', which means any changes you may have made to the library entry (play counts, watched status etc) will not be re-scanned back into the library. :*If you use ''movie.nfo'' and later Export your library to Separate Files, {{kodi}} will still create the nfo file in the ''<VideoFileName>.nfo'' format and two nfo files will exist. If a Refresh or rescan is run in future, the ''<VideoFileName>.nfo'' file will be ignored in favour of ''movie.nfo'', which means any changes you may have made to the library entry (play counts, watched status etc) will not be re-scanned back into the library.
:*We recommend using the ''<VideoFileName>.nfo'' format name for nfo files to avoid the above traps. :*We recommend using the ''<VideoFileName>.nfo'' format name for nfo files to avoid the above traps.<section end="MovieNFONaming" />






Line 47:
Line 47:
File:LocalMovieArtwork01.jpg|'''''Example of correct use of Movie Folder with artwork, nfo file, trailer and theme.<br> Take note of file naming and location.''''' File:LocalMovieArtwork01.jpg|'''''Example of correct use of Movie Folder with artwork, nfo file, trailer and theme.<br> Take note of file naming and location.'''''
</gallery> </gallery>





= nfo Tags = = nfo Tags =



Karellen at 03:03, 7 October 2020
2020-10-07T03:03:19Z


				
				
				
				
				
				← Older revision
				Revision as of 03:03, 7 October 2020
				
Line 374:
Line 374:
     <studio>DC Comics</studio>      <studio>DC Comics</studio>
     <trailer></trailer>      <trailer></trailer>
    <fileinfo>
        <streamdetails>
            <video>
                <codec>h264</codec>
                <aspect>1.777778</aspect>
                <width>1920</width>
                <height>1080</height>
                <durationinseconds>6268</durationinseconds>
                <stereomode></stereomode>
            </video>
            <audio>
                <codec>truehd</codec>
                <language>eng</language>
                <channels>8</channels>
            </audio>
            <audio>
                <codec>ac3</codec>
                <language></language>
                <channels>6</channels>
            </audio>
            <subtitle>
                <language>eng</language>
            </subtitle>
        </streamdetails>
    </fileinfo>
     <actor>      <actor>
         <name>Ben Affleck</name>          <name>Ben Affleck</name>



Karellen: Update ratings and uniqueid
2020-01-14T23:02:48Z
Update ratings and uniqueid

				
				
				
				
				
				← Older revision
				Revision as of 23:02, 14 January 2020
				
Line 77:
Line 77:
     </rating>      </rating>
   </ratings>    </ratings>
|| No || No || Only one rating can be set as ''default="true"'', additional ratings can be set as "false" or ommitted<br> || No || No || ''default="true"''  ''default="false"''<br>
Examples...<br> ::Only one rating can be set as ''default="true"'', additional ratings must be set as ''default="false"'' or ommitted<br>
:<rating name="imdb" max="10"><br>  
:<rating name="metacritic" max="10"><br> ''name="identifier"''. Do not use "default". Examples of identifier include...<br>
:<rating name="tomatometerallcritics" max="10"><br> ::''<rating name="imdb" max="10">''<br>
:<rating name="tomatometerallaudience" max="10"><br> ::''<rating name="trakt" max="10">''<br>
:<rating name="themoviedb" max="10" default="true"><br> ::''<rating name="themoviedb" 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 || Personal rating set by the user |<userrating></userrating> || No || No || Personal rating set by the user
Line 123:
Line 130:
Do not use as this is a Kodi generated tag. See next item. Do not use as this is a Kodi generated tag. See next item.
|- |-
|<uniqueid type="xxxx" default="true"></uniqueid> || scope="cell" ! style="background-color:#ff9c95;" | Yes || Yes || Unique Id. The ID from the scraper site. |<uniqueid type="xxxx" default="true"></uniqueid> || scope="cell" ! style="background-color:#ff9c95;" | Yes || Yes ||The ID from the scraper site.<br>
''xxxx'' = Identifier of the ID eg imdb, tmdb. For non-scraped items, use simple values like ''"home", "sport", "doco"'' etc<br> ''type="xxxx"'' = Identifier of the ID. Do not use "default". Examples of identifier include...<br>
''true'' = This will be set as the default ID. Multiple ID's are allowed but only one can be marked ''"true"''<br> ::''<uniqueid type="imdb">''<br>
The value can be alpha-numeric. Typical entries ''tt3480556'' for imdb, ''286668'' for tmdb, ''home001'' for home movies etc ::''<uniqueid type="tvdb">''<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 || Movie genre.   |<genre></genre> || No || Yes || Movie genre.

← Older revision		Revision as of 10:33, 26 December 2022
Line 150:		Line 150:
	\|<status></status> \|\| No \|\| No \|\| Not used		\|<status></status> \|\| No \|\| No \|\| Not used
	\|-		\|-
	\|<~~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 09:47, 25 December 2022
Line 145:		Line 145:
	\|-		\|-
	\|<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 \|\| Not used		\|<status></status> \|\| No \|\| No \|\| Not used

← Older revision		Revision as of 00:45, 20 April 2021
Line 32:		Line 32:


	;<VideoFileName>.nfo		<section begin="MovieNFONaming" />;<VideoFileName>.nfo
	:*NFO Files are named the same as the video file except with the ''.nfo'' extension. See image below.		:*NFO Files are named the same as the video file except with the ''.nfo'' extension. See image below.
	:*We recommend using this format to name nfo files.		:*We recommend using this format to name nfo files.
Line 40:		Line 40:
	:*If the above setting is not enabled, {{kodi}} will ignore the ''movie.nfo''. If the ''<VideoFileName>.nfo'' formatted file is available, {{kodi}} will scan this one instead, otherwise an online scrape will be performed.		:*If the above setting is not enabled, {{kodi}} will ignore the ''movie.nfo''. If the ''<VideoFileName>.nfo'' formatted file is available, {{kodi}} will scan this one instead, otherwise an online scrape will be performed.
	:*If you use ''movie.nfo'' and later Export your library to Separate Files, {{kodi}} will still create the nfo file in the ''<VideoFileName>.nfo'' format and two nfo files will exist. If a Refresh or rescan is run in future, the ''<VideoFileName>.nfo'' file will be ignored in favour of ''movie.nfo'', which means any changes you may have made to the library entry (play counts, watched status etc) will not be re-scanned back into the library.		:*If you use ''movie.nfo'' and later Export your library to Separate Files, {{kodi}} will still create the nfo file in the ''<VideoFileName>.nfo'' format and two nfo files will exist. If a Refresh or rescan is run in future, the ''<VideoFileName>.nfo'' file will be ignored in favour of ''movie.nfo'', which means any changes you may have made to the library entry (play counts, watched status etc) will not be re-scanned back into the library.
	:*We recommend using the ''<VideoFileName>.nfo'' format name for nfo files to avoid the above traps.		:*We recommend using the ''<VideoFileName>.nfo'' format name for nfo files to avoid the above traps.<section end="MovieNFONaming" />


Line 47:		Line 47:
	File:LocalMovieArtwork01.jpg\|'''''Example of correct use of Movie Folder with artwork, nfo file, trailer and theme.<br> Take note of file naming and location.'''''		File:LocalMovieArtwork01.jpg\|'''''Example of correct use of Movie Folder with artwork, nfo file, trailer and theme.<br> Take note of file naming and location.'''''
	</gallery>		</gallery>



	= nfo Tags =		= nfo Tags =

← Older revision		Revision as of 23:02, 14 January 2020
Line 77:		Line 77:
	</rating>		</rating>
	</ratings>		</ratings>
	\|\| No \|\| No \|\| Only one rating can be set as ''default="true"'', additional ratings ~~can~~ be set as "false" or ommitted<br>		\|\| No \|\| No \|\| ''default="true"'' ''default="false"''<br>
	Examples...<br>		::Only one rating can be set as ''default="true"'', additional ratings must be set as ''default="false"'' or ommitted<br>
	:<rating name="imdb" max="10"><br>
	:<rating name="metacritic" max="10"><br>		''name="identifier"''. Do not use "default". Examples of identifier include...<br>
	:<rating name="tomatometerallcritics" max="10"><br>		::''<rating name="imdb" max="10">''<br>
	:<rating name="tomatometerallaudience" max="10"><br>		::''<rating name="trakt" max="10">''<br>
	:<rating name="themoviedb" max="10" default="true"><br>		::''<rating name="themoviedb" 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 \|\| Personal rating set by the user		\|<userrating></userrating> \|\| No \|\| No \|\| Personal rating set by the user
Line 123:		Line 130:
	Do not use as this is a Kodi generated tag. See next item.		Do not use as this is a Kodi generated tag. See next item.
	\|-		\|-
	\|<uniqueid type="xxxx" default="true"></uniqueid> \|\| scope="cell" ! style="background-color:#ff9c95;" \| Yes \|\| Yes \|\| ~~Unique Id.~~ The ID from the scraper site.		\|<uniqueid type="xxxx" default="true"></uniqueid> \|\| scope="cell" ! style="background-color:#ff9c95;" \| Yes \|\| Yes \|\|The ID from the scraper site.<br>
	''xxxx'' = Identifier of the ID eg imdb, tmdb. For non-scraped items, use simple values like ''"home", "sport", "doco"'' etc<br>		''type="xxxx"'' = Identifier of the ID. Do not use "default". Examples of identifier include...<br>
	''true'' = ~~This will~~ be set as ~~the~~ default ~~ID. Multiple ID~~'s ~~are allowed but only one can~~ be ~~marked~~ ''"~~true~~"''<br>		::''<uniqueid type="imdb">''<br>
	~~The value can be alpha-numeric~~. ~~Typical entries~~ ''~~tt3480556~~'' ~~for imdb,~~ ''~~286668~~'' ~~for tmdb, ''home001'' for home movies etc~~		::''<uniqueid type="tvdb">''<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 \|\| Movie genre.		\|<genre></genre> \|\| No \|\| Yes \|\| Movie genre.

NFO files/Movies - Revision history

Karellen: default values

Crystalp: Add originallanguage

Karellen at 09:57, 28 December 2023

Karellen: Updated for v20

CastagnaIT: Fixed tag

CastagnaIT: More details for deprecated tag

Karellen: Updated for v19

Karellen: /* nfo Name and Location */

Karellen at 03:03, 7 October 2020

Karellen: Update ratings and uniqueid

CastagnaIT: Fixed `tag`