NFO files: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Minor rewording)
m (Updated for v20)
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{|class="infobox" style="width:200px"
{{NFO_content}}
! NFO Contents
|-
|
* '''[[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|[[Video library]] {{l2| [[Music library]] }} }}
{{mininav|[[Video library]] {{l2| [[Music library]] }} }}
{{See also| database | Import-export library | Artwork}}
__NOTOC__


= Introduction =
<section begin="intro" />NFO files are used to populate the music and video library using locally stored information. They are helpful if data for your particular title does not exist, such as for home movies and sporting events. A Parsing and Combination NFO file can be used to control the search behaviour of scrapers when problematic and ambiguous titles prevent your preferred title from being scraped.<section end="intro" />


<section begin="intro" />NFO files can be used to provide metadata to the library for video and a music files. They are helpful if the metadata fetched from a web site does not match the video or music you have, or if data for that particular file does not exist, such as for home movies. It can also be used to control the search behaviour of scrapers.<section end="intro" />
'''nfo''' is a filename extension - ''mymovie.nfo'' and the contents of the file are written in [http://en.wikipedia.org/wiki/XML XML]. The file itself does nothing except hold information and is basically a text document with XML tags inserted around the information.


'''All NFO files are saved with UTF-8 encoding''' which is standard on most operating systems.


NFO files are also used as a method of exporting the library for various reasons, including backup.  '''''See: [[Import-export_library | Import & Export]]'''''


= What is nfo =
The order of importing metadata into the {{kodi}} library is:
'''nfo''' is a contraction of Info or Information. It is a Filename Extension - ''mymovie.nfo'' and the contents of the file are written in [http://en.wikipedia.org/wiki/XML XML]. The file itself does nothing except hold information. It is basically a text document with special tags inserted around the information. These tags are recognised by Kodi which enables data importing.  
#nfo file. If no nfo file exists then
#Depending on your Source scraper settings:
#* A scraper is set- Scraper will locate online metadata, or
#* Local Info Only is set- Nothing will be scanned or scraped.


Kodi uses nfo files as one way of importing metadata into the library. It may also be used as a method of exporting the library for various reasons, including backup.  '''''See: [[Import-Export_library | Import & Export]]'''''


One of the most considered features of Kodi is the way media is displayed. Gone are the days when choosing a movie to watch or album to listen to involved scrolling through lines of text. Kodi uses [[Artwork]], and Extended Information to display your media. This information includes Actors, Directors, Plots, Taglines, Ratings, Run Times  and more. All this data, known as metadata, is stored in the Kodi Library. The Library is a [http://www.sqlite.org/ SQLite database].


There are two primary methods to load metadata into your library:
; [[NFO files/Creating|Creating NFO files]]
#Use the online scraper
: {{#lst:NFO files/Creating|intro}}
#Create a nfo file, from which Kodi is able to import the metadata


For information on how to use the online scraper within Kodi:<br />
; [[NFO_files/Parsing|Parsing NFO]]
:'''''See: [[Adding_music_to_the_library]]'''''
: {{#lst:NFO_files/Parsing|intro}}
:'''''See: [[Adding_video_sources]]'''''
:'''''See: [[Set_content_and_scan]]'''''<br />


'''The remainder of this wiki topic will provide the required information to create and use nfo files.'''
; [[NFO_files/Combination|Combination NFO]]
: {{#lst:NFO_files/Combination|intro}}


; Metadata NFO
: These are the full metadata NFO files that are commonly used. The {{kodi}} '''[[Import-export_library|Export]]''' feature generates these files as well as 3rd party media managers.
: All available XML tags are listed here as well as a description on how and where the files are saved.


; [[NFO_files/Templates|Templates and Samples]]
: {{#lst:NFO_files/Templates|intro}}


= Types of nfo =
Kodi can use the nfo file in one of three ways depending on the contents of the nfo file. This page and sub-pages primarily deal with the Metadata nfo.




== Metadata nfo ==
This is the most common use of the nfo file. The Metadata nfo contains the metadata for the movie/tv show/music video/album/artist within the file. Kodi will read this file and scrape its contents into the library.




{{updated|20}}


== Parsing nfo ==
[[Category:Karellen]]
A Parsing nfo does not contain any metadata that Kodi can use to scrape into the library. Instead it contains the URL to the movie/tv show/album/artist that you want scraped.
[[Category:Music library]]
As an example, searching for ''The Mummy'' on [https://www.themoviedb.org/ TMDB] returns 65 titles. If you are attempting to add one of the more obscure versions to your library, chances are that Kodi will scrape the incorrect title, and trying to navigate to the 65th entry will be problematic. The parsing nfo offers an easy solution to this problem.
 
The parsing nfo will also override the scraper setting in Kodi. If you have TMDB set as your scraper, it is possible to use the IMDB URL for the movie. The only condition to this flexibility is that the site of the URL you are using must have a Kodi scraper.
 
To create and use the parsing nfo, follow these steps:
#Locate the title at the appropriate scraper site
#Ensure you have named your media files/folder the same as shown on the scraper site and in accordance with the [[Naming_video_files|Kodi naming conventions]]
#Open a text file and copy the entire address of the movie at the scraper site from the address bar and paste it into the text file. No surrounding tags are required. ''see examples after step 5''
#Save the file in accordance with the naming convention as detailed on the linked Movie/TV Show/Music Video pages. '''Ensure the extension is *.nfo and not *.nfo.txt or *.nfo.doc'''
#Run an ''Update Library'' or a ''Scan item to library''. Kodi will parse the URL and locate the title and scrape the correct metadata.
 
Examples of Parsing nfo :
;[[NFO_files/movies | Movie nfo]]
''https://www.themoviedb.org/movie/15849-the-mummy''
;[[NFO_files/tvshows | TV Show nfo]]
''https://www.thetvdb.com/?tab=series&id=73545&lid=7''
;[[NFO_files/music | Music nfo]]
''https://musicbrainz.org/release/8fe0fbdf-33fc-4d0a-81f1-e02c79f474c8''
;[[NFO_files/musicvideos | Music Videos nfo]]
''http://www.theaudiodb.com/track/32794741''
<!--- http://kodi.wiki/view/Scraper#.3CCustomFunction.3E --->
 
 
 
== Combination nfo ==
It is possible to combine the above two types of nfo files into one nfo file. An example use would be to override data from the scraper site such as the title, runtime, movieset etc. It will scrape the metadata located between the <movie></movie> XML tags and the omitted data will be scraped at the provided URL. An example:
 
<movie>
    <title>Star Wars (1977 Original Theatrical Release)</title>
    <runtime>121 min.</runtime>
    <set>Star Wars Saga</set>
    <sorttitle>Star Wars1</sorttitle>
</movie>
http://www.imdb.com/title/tt0076759/
<br />
 
By default the following listed xml tags will have their data '''added''' to the scraped entry in the database and may result in some duplicates. If the tag is not listed below, this paragraph does not apply. Does not apply to Music.
 
<genre clear="true"></genre>
<credits clear="true"></credits>
<director clear="true"></director>
<studio clear="true"></studio>
<actor clear="true"></actor>
<artist clear="true"></artist> (Music Video only)
 
If you want to completely override the scraped result you need to set a clear attribute for the relevant xml tag in the .nfo file as shown in the example below.
<movie>
    <genre clear="true">Action</genre>
    <genre>Horror</genre>
    <genre>Thriller</genre>
    <director clear="true">Frank Miller</director>
    <director>Robert Rodriguez</director>
    <director>Quentin Tarantino</director>
</movie>
http://www.imdb.com/title/tt0401792/
Tags that support the ''clear'' attribute are ''genre, director, studio, actor, credits'' and ''artist'' for Music Videos. There is no support in Music tags.
 
 
= Creating nfo =
The following are the three methods that may be used to create nfo files for Kodi. The simplest method is using a Media Manager.
 
 
== Media Managers ==
This is, by far, the simplest method for creating nfo files for your media. The Media Manager can create nfo files in one of three ways:
#Scraping- This is the same process as performed by the Kodi scraper. The Media Manager will fetch metadata from the online scraper site and will create the nfo file, unlike Kodi that imports the metadata directly into the library database.
#Manual- The Media Manager offers a simple interface that allows you to manually type in the data. This method does not require you to have knowledge of XML tags
#Combination- A combination of both methods can be used. If you are not satisfied with the scraped metadata, then simply modify it.
 
Once the program has been setup and pointed at your media, very little input is required by the user. Select a movie, tv show, album or artist and select scrape. Depending upon your settings, the media manager will scrape the media and create the nfo which is placed in the correct location with the media file. It can also download all artwork for the media.
There are a few media managers available. The following managers can be found in the Kodi forum:
*[https://forum.kodi.tv/forumdisplay.php?fid=195  Ember Media Manager]
*[https://forum.kodi.tv/showthread.php?tid=142723  Tiny Media Manager aka TMM]
*[https://forum.kodi.tv/showthread.php?tid=129134  Media Companion 3]
*[https://forum.kodi.tv/showthread.php?tid=136333  MediaElch]
 
Further information, screenshots and guides are available at the websites of the Media Managers.
 
 
 
== Kodi Created nfo ==
This option requires that your library has already been scraped with metadata. Using the built in [[Import-Export_library | Import & Export]] function of Kodi, you can export the library metadata into individual nfo files  which are correctly created and saved. This is useful if you have an existing library and would like to backup the library or to import the library into another Kodi installation.
:'''''See: [[Import-Export_library | Import & Export]]'''''
 
 
 
== Manual Creation ==
The more difficult of the three methods. It requires basic knowledge of XML Tags. They can be created using a simple text editor such as Notepad in Windows, or the equivelant in other operating systems. There are dedicated code editors that can also be used. They will not provide the required Kodi tags, but they will avoid glitches when saving the nfo file, which is commonly experienced with text editors.
Two common code editors that can be used:
*[https://notepad-plus-plus.org/ Notepad++]
*[https://code.visualstudio.com/ Visual Studio Code]
 
Requirements of the nfo file are as follows:
#The file must be in Unicode Transformation Format-8 (UTF-8). The file must be saved in this format. The first line of the file must contain the following... <syntaxhighlight lang="xml" enclose="div"><?xml version="1.0" encoding="UTF-8" standalone="yes"?></syntaxhighlight>
#The second line may contain a note detailing the creation time and date. It may also include the name of the media manager, if one was used to create it, or any information relevant to you. This is optional. <syntaxhighlight lang="xml" enclose="div"><!-- created on 2017-08-10 15:09:33 - by MediaManager --></syntaxhighlight>
#The next line sets the nfo category and the last line of the file contains the closing tag using the relevant following tags... <syntaxhighlight lang="xml" enclose="div"><movie></movie>, <tvshow></tvshow>, <episodedetails></episodedetails>, <artist></artist>, <album></album> or <musicvideo></musicvideo></syntaxhighlight>
#Between the opening and closing category tags are the tags for the media metadata. Each Tag must have an opening tag and a closing tag. eg <syntaxhighlight lang="xml" enclose="div"><title>my movie title</title>.  <title> = opening tag | my movie title = metadata | </title> = closing tag</syntaxhighlight>
#Available tags are listed in the relevant sub-pages listed in sections 5-8.
 
Once created, the file must be saved with the nfo extension in accordance with the details in the relevant sub-page listed in sections 5-8.
 
 
 
= Scraping nfo files =
There is no special procedure to scrape nfo files. Performing the usual Library Update, or selecting Refresh for individual items, will scrape the nfo files into the library. Be aware that nfo files are not easily interchangeable between Movies, TV Shows, Music Videos, Artists and Albums. Although they all share common tags, each also has its own specific tags that won't be recognised in other parts of the library.
 
'''After the NFO files are scanned into the library, the NFO file is no longer used and only serves as a backup. If you make changes to the NFO file you will need to '''[[refresh]]''' that library entry for the changes to be loaded into Kodi.''' An Update Library will not capture the change as this only looks for '''new''' items.
 
Kodi also contains a Local-NFO-only mode for when you add videos to the library, but this mode is only required if you want to prevent online lookups for videos that lack NFO files. See '''[[Set content and scan#Local NFO only options]]''' for more information on this Local-NFO-only mode.
 
 
 
= Movie nfo =
For specific details of nfo files for Movies
:'''''See: [[NFO_files/movies | Movie nfo]]'''''
 
 
 
= TV Show nfo =
For specific details of nfo files for TV Shows and Episodes
:'''''See: [[NFO_files/tvshows | TV Show nfo]]'''''
 
 
 
= Music nfo =
For specific details of nfo files for Music Artists and Albums
:'''''See: [[NFO_files/music | Music nfo]]'''''
 
 
 
 
= Music Video nfo =
For specific details of nfo files for Music Videos
:'''''See: [[NFO_files/musicvideos | Music Videos nfo]]'''''
 
 
 
 
 
{{top}}
 
 
{{updated|17}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Video library]]
[[Category:Video library]]
[[Category:Music library]]
[[Category:Advanced topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]

Latest revision as of 02:16, 13 February 2023

NFO Contents

NFO Main Page


See also:


Return to:

Home icon grey.png   ▶ Video library
▶ Music library
▶ NFO files


Introduction

NFO files are used to populate the music and video library using locally stored information. They are helpful if data for your particular title does not exist, such as for home movies and sporting events. A Parsing and Combination NFO file can be used to control the search behaviour of scrapers when problematic and ambiguous titles prevent your preferred title from being scraped.

nfo is a filename extension - mymovie.nfo and the contents of the file are written in XML. The file itself does nothing except hold information and is basically a text document with XML tags inserted around the information.

All NFO files are saved with UTF-8 encoding which is standard on most operating systems.

NFO files are also used as a method of exporting the library for various reasons, including backup. See: Import & Export

The order of importing metadata into the Kodi library is:

  1. nfo file. If no nfo file exists then
  2. Depending on your Source scraper settings:
    • A scraper is set- Scraper will locate online metadata, or
    • Local Info Only is set- Nothing will be scanned or scraped.


Creating NFO files
This page explains the various methods available to create NFO files.
Parsing NFO
A Parsing NFO file is used to point the scraper to the exact title to be matched and scraped.
Combination NFO
A Combination NFO file combines a Parsing NFO and Metadata NFO file. It allows you to scrape the title as normal, but override some of the scraped data with the data included in the file.
Metadata NFO
These are the full metadata NFO files that are commonly used. The Kodi Export feature generates these files as well as 3rd party media managers.
All available XML tags are listed here as well as a description on how and where the files are saved.
Templates and Samples
Basic templates as a starting point to create your own NFO files.