NFO files/Movies
NFO Contents |
---|
Report NFO corrections: |
NFO_files | Movies |
Requirements
The order of importing metadata is as follows:
- nfo file. If no nfo file exists then
- Depending on your scraper settings for your source, either
- Online scraper sites- if a scraper is set in your source settings
- 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.
Known Issues
Bookmarks have no XML tags and cannot be exported or imported.
<year></year> is exported but not used on import
The following tags are available, but not used in Movies
- <status></status>
- <aired></aired>
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.
Movies require one nfo file saved as follows:
Naming & Saving conventions for your Movie *.nfo files:
Saved movies as | File Name | Save Location |
BluRay Structure:
|
index.nfo
|
f:\MyMovies\Big Buck Bunny (2008)\BDMV\index.nfo
|
DVD Structure:
|
VIDEO_TS.nfo
|
f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\VIDEO_TS.nfo
|
Single movie in directory: | <MovieFileName>.nfo | f:\MyMovies\Big Buck Bunny (2008)\Big Buck Bunny (2008).nfo |
or:
|
movie.nfo
|
f:\MyMovies\Big Buck Bunny (2008)\movie.nfo
|
All movies in single directory:
|
<MovieFileName>.nfo
|
f:\MyMovies\Big Buck Bunny (2008)\Big Buck Bunny (2008).nfo
|
Multi-part / file stacking: | <MovieFileName>.nfo | f:\MyMovies\Avatar (2009)\Avatar (2009).nfo |
or:
|
<MovieFileName> <StackExt>.nfo
|
f:\MyMovies\Avatar (2009)\Avatar (2009) cd1.nfo
|
Movie nfo Tags
The only required tag is indicated below in the table. 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 the XML tags available for movie nfo's in Kodi. Children tags are displayed correctly with parent tags. The list is ordered in the same manner as it should be ordered in the nfo file.
- See also: Databases
NFO (xml) Tag | Required | Multiple | Notes |
---|---|---|---|
<movie></movie> | Yes | No | The top level parent tag for the nfo file. All other tags must be contained within these two tags |
<title></title> | No | No | |
<originaltitle></originaltitle> | No | No | |
<sorttitle></sorttitle> | No | No | Allows alternate title sort without modifying movie title. Used for Canonical Ordering of movie sets |
<ratings> <rating name="default" max="10" default="true"> <value></value> <votes></votes> </rating> </ratings> |
No | No | |
<userrating></userrating> | No | No | |
<top250></top250> | No | No | |
<outline></outline> | Should be short, will be displayed on a single line | ||
<plot></plot> | Can contain more information on multiple lines, will be wrapped | ||
<tagline></tagline> | No | No | |
<runtime></runtime> | No | No | Minutes only. Overwritten when movie played |
<thumb aspect="poster" preview=""></thumb> | No | Yes | Path to Movie Posters |
<fanart> <thumb preview=""></thumb> </fanart> |
No | No | Path to available movie fanart. Multiple <thumb> entries allowed |
<mpaa></mpaa> | No | No | |
<playcount></playcount> | Setting this to 1, or greater, will mark the movie as watched if the importwatchedstate flag is set in advancedsettings.xml | ||
<lastplayed></lastplayed> | No | No | |
<file></file> | No | No | Not Used. Exported in Single File Export only |
<path></path> | No | No | Not used on Import. Exported in Single File Export only |
<filenameandpath></filenameandpath> | No | No | Not used on Import. Exported in Single File Export only |
<basepath></basepath> | No | No | Not used on Import. Exported in Single File Export only |
<id></id> | No | No | IMDB Id |
<uniqueid type="unknown" default="true"></uniqueid> | No | No | IMDB Id |
<genre></genre> | No | Yes | Supports "clear" attribute |
<country></country> | No | Yes | Country of origin |
<set> <name></name> <overview></overview> </set> |
No | No | Movie set tags |
<tag></tag> | No | Yes | Movie tags |
<credits></credits> | No | Yes | Library export uses this field for writers. Supports "clear" attribute |
<director></director> | No | Yes | Supports "clear" attribute |
<premiered></premiered> | No | No | |
<year></year> | No | No | |
<status></status> | No | No | Unknown |
|
Unknown | ||
<aired></aired> | No | No | Date aired. Normally used for TV Shows |
<studio></studio> | No | Yes | Supports "clear" attribute |
<trailer></trailer> | No | No | Path to movie trailer |
<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
While it is possible to manually set the information contained within the <streamdetails> tag, there is little point in doing so. Kodi will always overwrite this data when it plays back the video file. In other words, no matter how many times you try to manually set it, it will be overwritten the moment the video is played |
<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 |
<showlink></showlink> | No | No | Connect movie to TV Show |
<resume> <position></position> <total></total> </resume> |
No | No | Movie resume point in Seconds |
<dateadded></dateadded> | No | No | Date the file was added to library. Can be altered in advancedsettings.xml |
<art> <fanart></fanart> <poster></poster> </art> |
Yes | No | Art in use. Exported in Single File Export only |
Sample Movie nfo File
Provided below is a sample nfo file to assist with the manual creation process. It is extracted from the Single File nfo file. It includes MovieSet XML tags and TV Show links.
Press Expand at right edge of the green bar to view
Movie nfo file (click 'expand' to view) |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<movie>
<title>Allegiant</title>
<originaltitle>Allegiant</originaltitle>
<sorttitle>TmovieFc10</sorttitle>
<ratings>
<rating name="default" max="10" default="true">
<value>5.800000</value>
<votes>1641</votes>
</rating>
</ratings>
<userrating>9</userrating>
<top250>0</top250>
<outline>TmovieFc02</outline>
<plot>Beatrice Prior and Tobias Eaton venture into the world outside of the fence and are taken into protective custody by a mysterious agency known as the Bureau of Genetic Welfare.</plot>
<tagline>Break the boundaries of your world</tagline>
<runtime>88</runtime>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/tSFBh9Ayn5uiwbUK9HvD2lrRgaQ.jpg">http://image.tmdb.org/t/p/original/tSFBh9Ayn5uiwbUK9HvD2lrRgaQ.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/bFDF2v2nHMjuGiEAmSEk0gOWmED.jpg">http://image.tmdb.org/t/p/original/bFDF2v2nHMjuGiEAmSEk0gOWmED.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/gfkjqfpejEthVhY1nhgACP5tahT.jpg">http://image.tmdb.org/t/p/original/gfkjqfpejEthVhY1nhgACP5tahT.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/i9LuBG9cx9BW7fFepeCVrvJ8XRP.jpg">http://image.tmdb.org/t/p/original/i9LuBG9cx9BW7fFepeCVrvJ8XRP.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/tzo6bFhbzZGsK7lmBY4Rh3DIejx.jpg">http://image.tmdb.org/t/p/original/tzo6bFhbzZGsK7lmBY4Rh3DIejx.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/druHpfN5TrH7obwkZgzim9lagn8.jpg">http://image.tmdb.org/t/p/original/druHpfN5TrH7obwkZgzim9lagn8.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/sxtN4xfUmQeLdHmGwu51hAaZZ96.jpg">http://image.tmdb.org/t/p/original/sxtN4xfUmQeLdHmGwu51hAaZZ96.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/kx8DFfOqxJ05jjq4gddIwaM8PaP.jpg">http://image.tmdb.org/t/p/original/kx8DFfOqxJ05jjq4gddIwaM8PaP.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/AyRu1cFyhJZQ2dK3SyMiBqO4Cj.jpg">http://image.tmdb.org/t/p/original/AyRu1cFyhJZQ2dK3SyMiBqO4Cj.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/mtTFB4F5jIOEcZX8tVRVUkTeAwh.jpg">http://image.tmdb.org/t/p/original/mtTFB4F5jIOEcZX8tVRVUkTeAwh.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/7Puegpg8sCm8vAZ5nbj25EkBb36.jpg">http://image.tmdb.org/t/p/original/7Puegpg8sCm8vAZ5nbj25EkBb36.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/xTe4sPMGDSTplAEjnysfneEA1G1.jpg">http://image.tmdb.org/t/p/original/xTe4sPMGDSTplAEjnysfneEA1G1.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/afS2Prr0Rbzql8kuvjyLR8CkRNS.jpg">http://image.tmdb.org/t/p/original/afS2Prr0Rbzql8kuvjyLR8CkRNS.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/jcYhuAMcSH6myWQxGvxYSvYmwcn.jpg">http://image.tmdb.org/t/p/original/jcYhuAMcSH6myWQxGvxYSvYmwcn.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/EH0BBsXklLQelq3qtzSzXFKhYv.jpg">http://image.tmdb.org/t/p/original/EH0BBsXklLQelq3qtzSzXFKhYv.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/JVIkAxjJ4Qky13BiWFVJo0rFuV.jpg">http://image.tmdb.org/t/p/original/JVIkAxjJ4Qky13BiWFVJo0rFuV.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/yasmw8BQN6AZK73XGIiLVw1MLDF.jpg">http://image.tmdb.org/t/p/original/yasmw8BQN6AZK73XGIiLVw1MLDF.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/sg14CXGvREXKwAvknfDh4L9Jxd3.jpg">http://image.tmdb.org/t/p/original/sg14CXGvREXKwAvknfDh4L9Jxd3.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/focfTLC5yFynFhS2BFmt58s46fu.jpg">http://image.tmdb.org/t/p/original/focfTLC5yFynFhS2BFmt58s46fu.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/e37YQkMBCV0Alt7JhSG1wKTsOt1.jpg">http://image.tmdb.org/t/p/original/e37YQkMBCV0Alt7JhSG1wKTsOt1.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/8QqPdiEMQYg4x9xIMXxmWMSUcYj.jpg">http://image.tmdb.org/t/p/original/8QqPdiEMQYg4x9xIMXxmWMSUcYj.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/smw5aT9ypuq7Ub1QSXs3YxF5LTm.jpg">http://image.tmdb.org/t/p/original/smw5aT9ypuq7Ub1QSXs3YxF5LTm.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/por6QpWfgjt6qLe8A1C0vvSGe9q.jpg">http://image.tmdb.org/t/p/original/por6QpWfgjt6qLe8A1C0vvSGe9q.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/8LmLUOd8jpMNOZkf9uQQj7D43QQ.jpg">http://image.tmdb.org/t/p/original/8LmLUOd8jpMNOZkf9uQQj7D43QQ.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/7XWz4sR868AD9oAMVqpsFvIcGdk.jpg">http://image.tmdb.org/t/p/original/7XWz4sR868AD9oAMVqpsFvIcGdk.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/78KpRH6cBQEvcHYeux11b42qJRx.jpg">http://image.tmdb.org/t/p/original/78KpRH6cBQEvcHYeux11b42qJRx.jpg</thumb>
<thumb aspect="poster" preview="http://image.tmdb.org/t/p/w500/k6zNQwDr4JNB33Mo7RCMNrbFeNd.jpg">http://image.tmdb.org/t/p/original/k6zNQwDr4JNB33Mo7RCMNrbFeNd.jpg</thumb>
<fanart>
<thumb preview="http://image.tmdb.org/t/p/w780/sFthBeT0Y3WVfg6b3MkcJs9qfzq.jpg">http://image.tmdb.org/t/p/original/sFthBeT0Y3WVfg6b3MkcJs9qfzq.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/uAHZoVE4tkUHTVzm03raQYTsarx.jpg">http://image.tmdb.org/t/p/original/uAHZoVE4tkUHTVzm03raQYTsarx.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/p1dkPKpHJ32FvhKZSAUdA1JSYFi.jpg">http://image.tmdb.org/t/p/original/p1dkPKpHJ32FvhKZSAUdA1JSYFi.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/qN3gzc9NByIw3Yo2fa38IUFf47D.jpg">http://image.tmdb.org/t/p/original/qN3gzc9NByIw3Yo2fa38IUFf47D.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/74UuthnMEsY7X87fMhuLbPcHuen.jpg">http://image.tmdb.org/t/p/original/74UuthnMEsY7X87fMhuLbPcHuen.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/jaoDlr7XGGtHs1VpN9macrbXheO.jpg">http://image.tmdb.org/t/p/original/jaoDlr7XGGtHs1VpN9macrbXheO.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/nhPgHKSnDDNOYbNysPHUHxjYClj.jpg">http://image.tmdb.org/t/p/original/nhPgHKSnDDNOYbNysPHUHxjYClj.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/kj6oqsZo40hwzLBAQeKefGbp9aJ.jpg">http://image.tmdb.org/t/p/original/kj6oqsZo40hwzLBAQeKefGbp9aJ.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/hqh4cBYu3gtFJ8f8cO0MnYnk2bF.jpg">http://image.tmdb.org/t/p/original/hqh4cBYu3gtFJ8f8cO0MnYnk2bF.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/oOWOMv8aWUYalMyRE3DbsnQyNod.jpg">http://image.tmdb.org/t/p/original/oOWOMv8aWUYalMyRE3DbsnQyNod.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/jQsERPRmJ3bm6OSQvljSvPcRXQV.jpg">http://image.tmdb.org/t/p/original/jQsERPRmJ3bm6OSQvljSvPcRXQV.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/6rgatvYytkkI5sQdY300gw3cj1W.jpg">http://image.tmdb.org/t/p/original/6rgatvYytkkI5sQdY300gw3cj1W.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/6DI62qsY7kAYJhMBxnnZMduiS7y.jpg">http://image.tmdb.org/t/p/original/6DI62qsY7kAYJhMBxnnZMduiS7y.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/mKf1N4hvoKJXiM2Q0i1kAjerLvY.jpg">http://image.tmdb.org/t/p/original/mKf1N4hvoKJXiM2Q0i1kAjerLvY.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/b0VveMbxu2hVhaRQO203rtoTYOz.jpg">http://image.tmdb.org/t/p/original/b0VveMbxu2hVhaRQO203rtoTYOz.jpg</thumb>
<thumb preview="http://image.tmdb.org/t/p/w780/dJwlNja2UpCArLmWrVgC1Jcxcgi.jpg">http://image.tmdb.org/t/p/original/dJwlNja2UpCArLmWrVgC1Jcxcgi.jpg</thumb>
</fanart>
<mpaa>Rated M</mpaa>
<playcount>0</playcount>
<lastplayed>2017-09-16</lastplayed>
<file></file>
<path>F:\Movies- Test - Scraped\Allegiant (2016)\BDMV\</path>
<filenameandpath>F:\Movies- Test - Scraped\Allegiant (2016)\BDMV\index.bdmv</filenameandpath>
<basepath>F:\Movies- Test - Scraped\Allegiant (2016)\</basepath>
<id>tt3410834</id>
<uniqueid type="unknown" default="true">tt3410834</uniqueid>
<genre>Adventure</genre>
<genre>Science Fiction</genre>
<country>United States of America</country>
<set>
<name>Divergent Collection</name>
</set>
<tag>Best Tag</tag>
<credits>Noah Oppenheim</credits>
<credits>Adam Cooper</credits>
<credits>Bill Collage</credits>
<credits>Stephen Chbosky</credits>
<director>Robert Schwentke</director>
<premiered>2016-03-09</premiered>
<year>2016</year>
<status></status>
|
Technical Notes
There are differences in tags used by Single File Export and Separate File Export. Though testing reveals that transposing tags between the two has no detrimental affect on the scrape.
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> <fanart></fanart> <poster></poster> </art> |
Yes | No |
Return to top |
---|