NFO files/Music videos

From Official Kodi Wiki
Jump to: navigation, search
NFO Contents
Home icon grey.png   ▶ NFO_files ▶ Music videos

1 Requirements

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

When Kodi locates the nfo file it will load the *.nfo file and:

  1. If the file is a metadata nfo, Kodi will import the meta-data directly into the library from the .nfo file or
  2. 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.
  3. 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.

1.1 Known Issues

No known issues currently exist.

2 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:

  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.

2.1 Music Videos

Music Videos require one nfo for each music video in the folder. These nfo files need to be named exactly as the Music Video file is named, but with the nfo extension.

Naming & Saving conventions for your Music Videos *.nfo files:

Saved Music Videos as File Name Save Location
All formats <MusicVideoFileName>.nfo f:\MyMusicVideos\<MusicVideoFileName>.nfo

The below image shows an example of correct naming and placement of the artwork alongside the nfo file and the Music Video media file.

3 Music Video Tags

A list of all available tags that Kodi recognises follows in this section.

NFO (xml) Tag Required Multiple Notes
<musicvideo></musicvideo> 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 Name of music video
<userrating></userrating> No No Personal rating applied by the user
<top250></top250> No No Not Used
<track></track> No No Not Used
<album></album> No No Name of album the song appears on
<outline></outline> Not Used
<plot></plot> Can contain more information on multiple lines, will be wrapped
<tagline></tagline> No No Not Used
<runtime></runtime> No No Not Used
<thumb preview=""></thumb> No Yes Path to TV Show and Season artwork
<mpaa></mpaa> No No Not Used
<playcount></playcount> Setting this to 1, or greater, will mark the Music Video as watched on import if the importwatchedstate flag is set in advancedsettings.xml
<lastplayed></lastplayed> No No Date the music video was last played. Requires advancedsettings.xml entry for import
<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 Not Used
<genre clear="true"></genre> No Yes Supports "clear" attribute
<tag></tag> No Yes User created tags
<director clear="true"></director> No No Director of the music video
<year></year> No No Year released
<status></status> No No Not Used
<code></code> Not Used
<aired></aired> No No Not Used
<studio clear="true"></studio> No Yes Supports "clear" attribute
<trailer></trailer> No No Not used
No No 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

<artist clear="true"></artist> No No The artist of the song
No No Not Used
<dateadded></dateadded> No No Date the file was added to library. Can be altered in advancedsettings.xml
No No Currently selected artwork. Exported to single file only, not imported

4 Sample nfo Files

Sample Music Video nfo from Single File Export

5 Technical Notes

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.

XML Tag Exported in

Single File

Exported in

Separate File

<file></file> Yes No
<path></path> Yes No
<filenameandpath></filenameandpath> Yes No
<basepath></basepath> Yes No
Yes No

Return to top