User:Karellen/scratchpad: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 74: Line 74:
|}
|}
</div>
</div>
= Available nfo Tags =
The following two tables list the available tags that can be used in each nfo file.
== Artist NFO ==
{|class="prettytable"
! NFO (xml) Tag || Required || Overwrites || Multiple || Notes
|-
|<name></name> || Yes || Yes || no || 1
|-
|<musicBrainzArtistID></musicBrainzArtistID> || No || No || No || 1
|-
|<genre></genre> || No || Yes || Yes || 1, 2
|-
|<style></style> || No || No || Yes || 2
|-
|<mood></mood> || No || No || Yes || 2
|-
|<yearsactive></yearsactive> || No || No || Yes || 2
|-
|<born></born> || No || No || No ||
|-
|<formed></formed> || No || No || No ||
|-
|<instruments></instruments> || No || No || No ||
|-
|<biography></biography> || No || No || No ||
|-
|<died></died> || No || No || No ||
|-
|<disbanded></disbanded> || No || No || No ||
|-
|<thumb preview="path"></thumb> || No || No || Yes ||
|-
|
<fanart>
  <thumb preview="path"></thumb>
</fanart>
|| No || No || Yes ||
|-
|
<album>
  <title></title>
  <year></year>
</album>
|| No || No || Yes ||
|}
{|class="prettytable"
!'''Notes'''
|-
|1 || Will overwrite when ''prefer online info'' is enabled in Kodi settings
|-
|2 || Where indicated, tags can accept an optional "clear" boolean (true/false) attribute which clears corresponding scraped data and all values of similar tags up to that point.
|}
== Album NFO ==
{|class="prettytable"
! NFO (xml) Tag || Required || Overwrites || Multiple || Notes
|-
|<title></title> || Yes || Yes || No || 1
|-
|<musicBrainzAlbumID></musicBrainzAlbumID> || No || Yes || No || 1
|-
|<artistdesc></artistdesc> || Yes || Yes || No || 1, 2
|-
|<genre></genre> || No || Yes || Yes || 1, 2
|-
|<style></style> || No || Yes || Yes || 1, 2
|-
|<mood></mood> || No || Yes || Yes || 1, 2
|-
|<theme></theme> || No || Yes || Yes || 1, 2
|-
|<compilation></compilation> || Yes || Yes || No || 1
|-
|<review></review> || No || Yes || No || 1
|-
|<type></type> || No || Yes || No || 1
|-
|<releasedate></releasedate> || No || Yes || No || 1
|-
|<label></label> || No || Yes || No || 1
|-
|<thumb preview="path"></thumb> || No || No || Yes ||
|-
|<path></path> || Yes || No || No ||
|-
|<rating max="10"></rating> || No || Yes || No || 1
|-
|<userrating max="10"></userrating> || No || No || No
|-
|<votes></votes> || No || Yes || No || 1
|-
|<year></year> || No || Yes || No || 1
|-
|
<albumArtistCredits>
  <artist></artist>
  <musicBrainzArtistID></musicBrainzArtistID>
</albumArtistCredits>
|| Yes || Yes || Yes || 1
|-
|<releasetype></releasetype> || No || Yes || No || 1
|-
|
<track>
    <position></position>
    <title></title>
    <duration></duration>
    <musicBrainzTrackID></musicBrainzTrackID>
</track>
|| Yes || Yes || Yes || 1
|}
{|class="prettytable"
!'''Notes'''
|-
|1 || Will overwrite when ''prefer online info'' is enabled in Kodi settings
|-
|2 || Where indicated, tags can accept an optional "clear" boolean (true/false) attribute which clears corresponding scraped data and all values of similar tags up to that point.
|}




= Sample nfo Files =
= Sample nfo Files =
An example of the ''artist.nfo'' and the ''album.nfo'' are provided. Use these as a guide to create  your own nfo files, or to determine errors in your own files.
== Music Artist nfo ==
== Music Artist nfo ==
Sample Music Artist nfo
Sample Music Artist nfo

Revision as of 04:34, 6 September 2017

NFO Contents

Report NFO corrections:
[https:// here in the forum]

Home icon grey.png   ▶ Video library
▶ Music library
▶ scratchpad



Requirements

As the Music section of Kodi has many differences to the Video section of Kodi, please read this section to ensure your music and artwork are correctly scraped and displayed.


Understanding the Music Library

Adding Music to Library

nfo Specific Requirements

nfo Placement

Music will fetch additional album and album artist information from nfo files.

For additional album information each album needs to be in its own unique folder, and have a separate album.nfo file located there. See the first table below.

For additional album artist information each artist needs a separate artist.nfo file located in what Kodi determines as the unique common folder for that artist. Kodi does not fetch additional artist data for artists that only feature on songs, either on compilation albums or as guest artists on songs in albums by others, and you do not have any albums by them in your collection.

Note: There are weaknesses in the way that Kodi determines the location of the artist folder. It looks for the folder that is common to all the songs with that album artist, the name of that folder is irrelevent. If you have multiple albums by an artist all under an artist folder then this works perfectly. However the algorithm does not work for collaboration albums, those that have more than one album artist e.g. "Riding with the King" by Eric Clapton and BB King, or classical music with composer, orchestra and conductor given as the album artist. Also if you have not kept all songs by an artist under a unique folder, then the artist directory will probably be mis-identified. The result is that Kodi can find the wrong artist.NFO file, and give the artist some other artist's information, or fail to fine the artist.nfo you created

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

Saved Artist as File Name Save Location
Artist\Album\Songs artist.nfo f:\MyMusic\Stevie Nicks\artist.nfo


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

Saved Album as File Name Save Location
Artist\Album\Songs album.nfo f:\MyMusic\Stevie Nicks\Crystal Visions\album.nfo


Available nfo Tags

The following two tables list the available tags that can be used in each nfo file.


Artist NFO

NFO (xml) Tag Required Overwrites Multiple Notes
<name></name> Yes Yes no 1
<musicBrainzArtistID></musicBrainzArtistID> No No No 1
<genre></genre> No Yes Yes 1, 2
<style></style> No No Yes 2
<mood></mood> No No Yes 2
<yearsactive></yearsactive> No No Yes 2
<born></born> No No No
<formed></formed> No No No
<instruments></instruments> No No No
<biography></biography> No No No
<died></died> No No No
<disbanded></disbanded> No No No
<thumb preview="path"></thumb> No No Yes
<fanart>
  <thumb preview="path"></thumb>
</fanart>
No No Yes
<album>
  <title></title>
  <year></year>
</album>
No No Yes
Notes
1 Will overwrite when prefer online info is enabled in Kodi settings
2 Where indicated, tags can accept an optional "clear" boolean (true/false) attribute which clears corresponding scraped data and all values of similar tags up to that point.


Album NFO

NFO (xml) Tag Required Overwrites Multiple Notes
<title></title> Yes Yes No 1
<musicBrainzAlbumID></musicBrainzAlbumID> No Yes No 1
<artistdesc></artistdesc> Yes Yes No 1, 2
<genre></genre> No Yes Yes 1, 2
<style></style> No Yes Yes 1, 2
<mood></mood> No Yes Yes 1, 2
<theme></theme> No Yes Yes 1, 2
<compilation></compilation> Yes Yes No 1
<review></review> No Yes No 1
<type></type> No Yes No 1
<releasedate></releasedate> No Yes No 1
<label></label> No Yes No 1
<thumb preview="path"></thumb> No No Yes
<path></path> Yes No No
<rating max="10"></rating> No Yes No 1
<userrating max="10"></userrating> No No No
<votes></votes> No Yes No 1
<year></year> No Yes No 1
<albumArtistCredits>
  <artist></artist>
  <musicBrainzArtistID></musicBrainzArtistID>
</albumArtistCredits>
Yes Yes Yes 1
<releasetype></releasetype> No Yes No 1
<track>
   <position></position>
   <title></title>
   <duration></duration>
   <musicBrainzTrackID></musicBrainzTrackID>
</track>
Yes Yes Yes 1
Notes
1 Will overwrite when prefer online info is enabled in Kodi settings
2 Where indicated, tags can accept an optional "clear" boolean (true/false) attribute which clears corresponding scraped data and all values of similar tags up to that point.



Sample nfo Files

An example of the artist.nfo and the album.nfo are provided. Use these as a guide to create your own nfo files, or to determine errors in your own files.


Music Artist nfo

Sample Music Artist nfo


Music Album nfo

Sample Music Album nfo