User:Karellen/scratchpad01: Difference between revisions
No edit summary |
No edit summary |
||
Line 1,055: | Line 1,055: | ||
<div style="{{linear-gradient|left|#ffdddd, #ddddff}}"> | <div style="{{linear-gradient|left|#ffdddd, #ddddff}}"> | ||
@DaveBlake- This is what I am trying to achieve, combining database fields with the Source of the Data (scraper, file tags etc) and nfo tags. | '''@DaveBlake- This is what I am trying to achieve, combining database fields with the Source of the Data (scraper, file tags etc) and nfo tags. | ||
At first I expected that all nfo tags would have a corresponding database field. I did not expect that some tags would have no database field. So not sure how to show that in this table yet. | At first I expected that all nfo tags would have a corresponding database field. I did not expect that some tags would have no database field. So not sure how to show that in this table yet. | ||
Line 1,076: | Line 1,076: | ||
<userrating max="10">7</userrating> | <userrating max="10">7</userrating> | ||
Do you have any other suggestions on how to document this? | #Some tags come from Music Files, some Tags come from online Scrapers. Makes sense when first building your library. But when you export your library, some of the Music File Tags are entered into the nfo file. Now we have the same Tag information in the music file and in the nfo. When rebuilding your library, which takes precedence? Does nfo files override the music tags? | ||
Do you have any other suggestions on how to document this?''' | |||
</div> | </div> |
Revision as of 04:22, 31 August 2017
Video library Music library |
Management |
scratchpad01 |
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.
What is nfo
nfo is a contraction of Info or Information. It is a Filename Extension - mymovie.nfo and the contents of the file are written in 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.
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
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 SQLite database.
There are two primary methods to load metadata into your library:
- Use the online scraper
- Create a nfo file, from which Kodi is able to import the metadata
For information on how to use the online scraper within Kodi:
- See: Adding_music_to_the_library
- See: Adding_video_sources
- See: Set_content_and_scan
The remainder of this wiki topic will provide the required information to create and use nfo files.
Types of nfo
Kodi can use the nfo file in one of two ways depending on the contents of the nfo file. This page primarily deals 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.
Parsing nfo
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. As an example, searching for The Mummy on 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. To create and use the parsing nfo, follow these steps:
- Locate the title at the appropriate scraper site
- Ensure you have named your files/folder the same as shown on the scraper site and in accordance with the Kodi naming conventions
- Open a text editor.
- Copy the entire address of the movie at the scraper site from the address bar and paste it into the text editor. No surrounding tags are required. see example after step 6
- Save the file in accordance with the naming convention in section 4 below. Ensure the extension is *.nfo and not *.nfo.txt or *.nfo.doc
- Run an Update Library. Kodi will parse the URL and locate the title and scrape the correct metadata.
https://www.themoviedb.org/movie/15849-the-mummy
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:
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 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
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:
Requirements of the nfo file are as follows:
- Each Tag must have an opening tag and a closing tag. eg <title>my movie title</title>. <title> = opening tag, my movie title = metadata, </title> = closing tag
- 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 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
- 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. This is optional. '
- The next line sets the nfo category - <movie>, <tvshow>, <episodedetails>, <artist>, <album> or <musicvideo>
- Between the opening and closing category tags are the tags for the media metadata.
- Available tags are listed in Section 8
Once created, the file is saved with the nfo extension and placed in the folder as directed in Section 4.
See example nfo files in Section 7
nfo Placement
Correct placement of the nfo file is essential. Failing to save the file in the correct location, as detailed below, will force Kodi to scrape the information from online sources or, if you have Local Info Only set as your scraper, then no entry will be made into the library.
The order of importing metadata is as follows:
- nfo file. If no nfo file exists then
- online scraper sites
When Kodi locates the nfo file it will load the *.nfo file and attempt to either,
- If the nfo file contains XML data (tags), Kodi will import the meta-data directly into the library from the .nfo file or
- Will parse the nfo file for a direct URL to the scraper info page.
Movies
Movies require one nfo file 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)\<MovieFileName>.nfo |
All movies in single directory: | <MovieFileName>.nfo | f:\MyMovies\Big Buck Bunny (2008)\<MovieFileName>.nfo |
TV Shows
TV Shows require the following nfo files
- One nfo file for the TV Show. See the first table below
- One nfo file for each Episode. See the second table below
For one TV Show with 10 episodes, you will require 11 nfo files.
Naming & Saving conventions for your TV Show *.nfo files:
Saved TV Show as | File Name | Save Location |
All formats | tvshow.nfo | f:\MyTVShows\iZombie\tvshow.nfo |
Naming & Saving conventions for your TV Episode *.nfo files:
Saved Episodes as | File Name | Save Location |
BluRay Structure: | index.nfo | f:\MyTVShows\iZombie\iZombie S01E01\BDMV\index.nfo |
DVD Structure: | VIDEO_TS.nfo | f:\MyTVShows\iZombie\iZombie S01E01\VIDEO_TS\VIDEO_TS.nfo |
Single Episode file in directory: | <EpisodeFileName>.nfo | f:\MyTVShows\iZombie\iZombie S01E01\<EpisodeFileName>.nfo |
All episodes in TV Show directory: | <MovieFileName>.nfo | f:\MyTVShows\iZombie\<EpisodeFileName>.nfo |
Music
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 |
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 |
Scraping nfo files
There is no special procedure to scrape nfo files. Performing the usual Library Update will scrape the nfo files into the library. Be aware that nfo files are not easily interchangeable between Movies, TV Shows, 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.
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.
Advancedsettings.xml
Sample nfo Files
Provided below are sample nfo files to assist with the manual creation process
Movie nfo
Sample Movie nfo file
Movie nfo file (click 'expand' to view) |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <movie> <title>Ghost in the Shell</title> <originaltitle>Ghost in the Shell</originaltitle> <sorttitle></sorttitle> <rating>5.9</rating> <year>2017</year> <top250></top250> <votes>1936</votes> <outline>In the near future, Major is the first of her kind: a human saved from a terrible crash, then cyber-enhanced to be a perfect soldier devoted to stopping the world's most dangerous criminals.</outline> <plot>In the near future, Major is the first of her kind: a human saved from a terrible crash, then cyber-enhanced to be a perfect soldier devoted to stopping the world's most dangerous criminals.</plot> <tagline>There's nothing sadder than a puppet without a ghost.</tagline> <runtime>107</runtime> <thumb>https://assets.fanart.tv/fanart/movies/315837/movieposter/ghost-in-the-shell-5951b7c0843b0.jpg</thumb> <fanart>http://image.tmdb.org/t/p/original/dXJh6bXF3WI1gpNuM3tNbnIiW2z.jpg</fanart> <mpaa>AU:M</mpaa> <certification>AU:M</certification> <id>tt1219827</id> <ids> <entry> <key>tmdb</key> <value xsi:type="xs:int" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">315837</value> </entry> <entry> <key>imdb</key> <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">tt1219827</value> </entry> </ids> <tmdbId>315837</tmdbId> <country>Australia, New Zealand, United States, United Kingdom, India, China, Canada, Japan, Hong Kong</country> <premiered>2017-03-29</premiered> <fileinfo> <streamdetails> <video> <codec>h264</codec> <aspect>1.78</aspect> <width>1920</width> <height>1080</height> <durationinseconds>6417</durationinseconds> </video> <audio> <codec>TrueHD AC3</codec> <language>eng</language> <channels>8</channels> </audio> <subtitle> <language>eng</language> </subtitle> <subtitle> <language>eng</language> </subtitle> </streamdetails> </fileinfo> <watched>false</watched> <playcount>0</playcount> <genre>Action</genre> <genre>Crime</genre> <genre>Drama</genre> <genre>Mystery</genre> <genre>Science Fiction</genre> <genre>Thriller</genre> <studio>Paramount Pictures</studio> <studio>DreamWorks SKG</studio> <studio>Shanghai Film Group</studio> <studio>Reliance Entertainment</studio> <studio>Arad Productions</studio> <studio>Grosvenor Park Productions</studio> <studio>Steven Paul Production</studio> <studio>Huahua Media</studio> <studio>Seaside Entertainment</studio> <studio>Amblin Partners</studio> <studio>Weying Galaxy Entertainment</studio> <credits>Ehren Kruger</credits> <credits>Jamie Moss</credits> <credits>Masamune Shirow</credits> <credits>William Wheeler</credits> <director>Rupert Sanders</director> <tag>BluRay</tag> <actor> <name>Scarlett Johansson</name> <role>Major Motoko Kusanagi</role> <thumb>http://image.tmdb.org/t/p/w185/8EueDe6rPF0jQU4LSpsH2Rmrqac.jpg</thumb> </actor> <actor> <name>Pilou Asbæk</name> <role>Batou</role> <thumb>http://image.tmdb.org/t/p/w185/wcQRF5ZOBY8NX7xrjXE2pOBmwyZ.jpg</thumb> </actor> <actor> <name>Takeshi Kitano</name> <role>Daisuke Aramaki</role> <thumb>http://image.tmdb.org/t/p/w185/xkXZ7HC8uyhu5MtNnbdP8mhdiFN.jpg</thumb> </actor> <actor> <name>Juliette Binoche</name> <role>Dr. Ouélet</role> <thumb>http://image.tmdb.org/t/p/w185/rkW6eE75Tt1i3J1s2fsIDZBW0kd.jpg</thumb> </actor> <actor> <name>Michael Pitt</name> <role>Hideo Kuze</role> <thumb>http://image.tmdb.org/t/p/w185/fWR4Z1xk1ZMUMMnMeRADVh1s3DW.jpg</thumb> </actor> <actor> <name>Chin Han</name> <role>Togusa</role> <thumb>http://image.tmdb.org/t/p/w185/xvMCVDvrQ2WlAB2LmkG6HAzlYag.jpg</thumb> </actor> <actor> <name>Lasarus Ratuere</name> <role>Ishikawa</role> <thumb>http://image.tmdb.org/t/p/w185/tATw6bSySFmqunfBXmyy0ppbsXi.jpg</thumb> </actor> <actor> <name>Yutaka Izumihara</name> <role>Saito</role> <thumb>http://image.tmdb.org/t/p/w185/rGPYp0jWNplBEv1vWDbmpysaGte.jpg</thumb> </actor> <actor> <name>Tawanda Manyimo</name> <role>Borma</role> <thumb>http://image.tmdb.org/t/p/w185/vUpTeHW9Yokx2R2sipMZdiTfiIk.jpg</thumb> </actor> <actor> <name>Rila Fukushima</name> <role>Red Robed Geisha</role> <thumb>http://image.tmdb.org/t/p/w185/AsxUTMScQetJ1Iommki98w3rHPH.jpg</thumb> </actor> <actor> <name>Michael Wincott</name> <role>Dr. Osmund</role> <thumb>http://image.tmdb.org/t/p/w185/pvKUzexxZT4sRTT1BczzrwX8ghz.jpg</thumb> </actor> <actor> <name>Anamaria Marinca</name> <role>Dr. Dahlin</role> <thumb>http://image.tmdb.org/t/p/w185/ajLN2RMuYHgTEFAzs8x8vZH0Rlu.jpg</thumb> </actor> <actor> <name>Daniel Henshall</name> <role>Skinny Man</role> <thumb>http://image.tmdb.org/t/p/w185/4LYeThK5O9EUy1OllvdsD5bTRbb.jpg</thumb> </actor> <actor> <name>Kaori Momoi</name> <role>Hairi</role> <thumb>http://image.tmdb.org/t/p/w185/aHPQaKWk1foxvieDZubUJE8olaO.jpg</thumb> </actor> <actor> <name>Peter Ferdinando</name> <role>Cutter</role> <thumb>http://image.tmdb.org/t/p/w185/eSxMkW04VuOkQqxG2HIPw0FMJKe.jpg</thumb> </actor> <actor> <name>Christopher Obi</name> <role>Ambassador Kiyoshi</role> <thumb>http://image.tmdb.org/t/p/w185/9mkVa3qKba8S7UcyzUYZPkeRG37.jpg</thumb> </actor> <actor> <name>Danusia Samal</name> <role>Ladriya</role> <thumb>http://image.tmdb.org/t/p/w185/8FqUG5hRe9MskGzXzx8ktS7b20y.jpg</thumb> </actor> <actor> <name>Mana Hira Davis</name> <role>Bearded Man</role> <thumb>http://image.tmdb.org/t/p/w185/fBDzK8Vd7XBx97nsH9sXXGf4nMD.jpg</thumb> </actor> <actor> <name>Adwoa Aboah</name> <role>Lia</role> <thumb>http://image.tmdb.org/t/p/w185/jD8FV3TcLNJe64udKygGLnHkP6K.jpg</thumb> </actor> <actor> <name>Kai Fung Rieck</name> <role>Diamond Face</role> <thumb>http://image.tmdb.org/t/p/w185/mqS7nagL7Dp1QK1152eyfT1RjOI.jpg</thumb> </actor> <actor> <name>Andrew Stehlin</name> <role>No Pupils</role> <thumb>http://image.tmdb.org/t/p/w185/kcDr96zRyuM3IiR5RWPV14D5dMK.jpg</thumb> </actor> <actor> <name>Matthias Luafutu</name> <role>Thick Built Yakuza</role> <thumb>http://image.tmdb.org/t/p/w185/65KBlRWu561lTVPHlhgHskprLOh.jpg</thumb> </actor> <actor> <name>John Luafutu</name> <role>Barkeep</role> <thumb>http://image.tmdb.org/t/p/w185/ryhkaAVyAxAfCUj6P12EkYO8Rk4.jpg</thumb> </actor> <actor> <name>Kaori Yamamoto</name> <role>Motoko</role> <thumb>http://image.tmdb.org/t/p/w185/iJFsfqfmUy14kU2VNrxE3JGVBAY.jpg</thumb> </actor> <actor> <name>Pete Teo</name> <role>Tony</role> <thumb>http://image.tmdb.org/t/p/w185/7bJutZz5qd2rYBHHC2gyMQWNQbu.jpg</thumb> </actor> <actor> <name>Tanya Drewery</name> <role>Geisha</role> <thumb>http://image.tmdb.org/t/p/w185/7Q4eMvFKcmYSUfLSlNMHtlSkoKh.jpg</thumb> </actor> <actor> <name>Jacqueline Lee Geurts</name> <role>Geisha</role> <thumb>http://image.tmdb.org/t/p/w185/9YcJF1avZliG3Mu01mUQxuiUuu4.jpg</thumb> </actor> <actor> <name>Hannah Tasker-Poland</name> <role>Geisha</role> <thumb>http://image.tmdb.org/t/p/w185/fpXCLG1HbNlPl6nEDnqQTvohMEm.jpg</thumb> </actor> <actor> <name>Emma Coppersmith</name> <role>Geisha</role> <thumb>http://image.tmdb.org/t/p/w185/aAHgg8eO7kaHw0Mmn1jatBxmRYv.jpg</thumb> </actor> <actor> <name>Shinji Ikefuji</name> <role>Kinsana</role> <thumb>http://image.tmdb.org/t/p/w185/6m1scLGa91uDDYBftdEcEOuXrAm.jpg</thumb> </actor> <actor> <name>Xavier Horan</name> <role>Section Six Soldier</role> <thumb>http://image.tmdb.org/t/p/w185/yNdHNB90SXulSRLqbYeZ5JXppqO.jpg</thumb> </actor> <actor> <name>Allan Henry</name> <role>Section Six Soldier</role> <thumb>http://image.tmdb.org/t/p/w185/ma3ZFzGiF4ANlEym3ACFOG0n7qV.jpg</thumb> </actor> <actor> <name>Joseph Naufahu</name> <role>Police Commander Johns</role> <thumb>http://image.tmdb.org/t/p/w185/9N4UmM1runLmdhzIhZ5Xfk4Qo21.jpg</thumb> </actor> <actor> <name>Makoto Murata</name> <role>Yakuza Gunman</role> <thumb>http://image.tmdb.org/t/p/w185/f32b7dh8dg5s5LWXyiSYZacDQAG.jpg</thumb> </actor> <producer> <name>Avi Arad</name> <role>Producer</role> <thumb>http://image.tmdb.org/t/p/w185/kIG4HF5LSywU0ZdDheDaEsxxohu.jpg</thumb> </producer> <producer> <name>Leslee Feldman</name> <role>Casting</role> </producer> <producer> <name>Mitsuhisa Ishikawa</name> <role>Executive Producer</role> </producer> <producer> <name>Steven Paul</name> <role>Producer</role> </producer> <producer> <name>Jeffrey Silver</name> <role>Executive Producer</role> </producer> <producer> <name>Lucy Bevan</name> <role>Casting</role> </producer> <producer> <name>Mark Sourian</name> <role>Executive Producer</role> </producer> <producer> <name>Michael Costigan</name> <role>Executive Producer</role> </producer> <producer> <name>Mark Sussman</name> <role>ADR Voice Casting</role> </producer> <producer> <name>Ari Arad</name> <role>Producer</role> </producer> <producer> <name>Miranda Rivers</name> <role>Casting</role> </producer> <producer> <name>Maguy R. Cohen</name> <role>Producer</role> </producer> <producer> <name>Patty Majorczak-Connolly</name> <role>ADR Voice Casting</role> </producer> <producer> <name>Cécile Bouquet</name> <role>Researcher</role> </producer> <producer> <name>Tetsuya Fujimura</name> <role>Executive Producer</role> </producer> <producer> <name>Nanw Rowlands</name> <role>Casting Associate</role> </producer> <languages>Japanese, English</languages> </movie>
|
TV Show nfo
Sample TV Show nfo
TV Show nfo file (click 'expand' to view) |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <tvshow> <title>iZombie</title> <sorttitle></sorttitle> <year>2015</year> <rating>8.3</rating> <votes>66</votes> <plot>When over-achieving medical resident Liv Moore attends a party that turns into a zombie feeding frenzy, she ends up joining the ranks of the living dead.</plot> <mpaa>E</mpaa> <episodeguide> <url cache="281470.xml">http://www.thetvdb.com/api/1D62F2F90030C444/series/281470/all/en.xml</url> </episodeguide> <id>281470</id> <imdbid>tt3501584</imdbid> <genre>Action</genre> <genre>Comedy</genre> <genre>Crime</genre> <genre>Drama</genre> <genre>Horror</genre> <premiered>2015-03-17</premiered> <status>Continuing</status> <studio>The CW</studio> <actor> <name>Rose McIver</name> <role>Olivia "Liv" Moore</role> <thumb>http://thetvdb.com/banners/actors/346010.jpg</thumb> </actor> <actor> <name>Rahul Kohli</name> <role>Dr. Ravi Chakrabarti</role> <thumb>http://thetvdb.com/banners/actors/346008.jpg</thumb> </actor> <actor> <name>Robert Buckley</name> <role>Major Lilywhite</role> <thumb>http://thetvdb.com/banners/actors/329726.jpg</thumb> </actor> <actor> <name>Aly Michalka</name> <role>Peyton Charles</role> <thumb>http://thetvdb.com/banners/actors/437907.jpg</thumb> </actor> <actor> <name>Malcolm Goodwin</name> <role>Clive Babineaux</role> <thumb>http://thetvdb.com/banners/actors/346009.jpg</thumb> </actor> <actor> <name>David Anders</name> <role>Blaine</role> <thumb>http://thetvdb.com/banners/actors/329728.jpg</thumb> </actor> <actor> <name>Tongayi Chirisa</name> <role>Justin Bell</role> <thumb>http://thetvdb.com/banners/actors/437906.jpg</thumb> </actor> <actor> <name>Andrea Savage</name> <role>Vivian Stoll</role> <thumb>http://thetvdb.com/banners/actors/437905.jpg</thumb> </actor> <actor> <name>Jason Dohring</name> <role>Chase Graves</role> <thumb>http://thetvdb.com/banners/actors/437903.jpg</thumb> </actor> <actor> <name>Nick Purcha</name> <role>Evan Moore</role> <thumb>http://thetvdb.com/banners/actors/436318.jpg</thumb> </actor> <actor> <name>Leanne Lapp</name> <role>Rita/Gilda</role> <thumb>http://thetvdb.com/banners/actors/436317.jpg</thumb> </actor> <actor> <name>Greg Finley</name> <role>Drake Holloway</role> <thumb>http://thetvdb.com/banners/actors/436315.jpg</thumb> </actor> <actor> <name>Jessica Harmon</name> <role>Dale Bozzio</role> <thumb>http://thetvdb.com/banners/actors/436314.jpg</thumb> </actor> <actor> <name>Bryce Hodgson</name> <role>Don Everhart</role> <thumb>http://thetvdb.com/banners/actors/430151.jpg</thumb> </actor> <actor> <name>Bradley James</name> <role>Lowell Tracey</role> <thumb>http://thetvdb.com/banners/actors/417361.jpg</thumb> </actor> </tvshow> |
TV Show Episode nfo
Sample TV Episode nfo
TV Episode nfo file (click 'expand' to view) |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<episodedetails>
<title>The Bone Orchard</title>
<showtitle>American Gods</showtitle>
<ratings>
<rating name="default" max="10" default="true">
<value>7.400000</value>
<votes>14</votes>
</rating>
</ratings>
<userrating>0</userrating>
<top250>0</top250>
<season>1</season>
<episode>1</episode>
<displayseason>-1</displayseason>
<displayepisode>-1</displayepisode>
<outline></outline>
<plot>When Shadow Moon is released from prison early after the death of his wife, he meets Mr. Wednesday and is recruited as his bodyguard. Shadow discovers that this may be more than he bargained for.</plot>
<tagline></tagline>
<runtime>62</runtime>
<mpaa>E</mpaa>
<playcount>1</playcount>
<lastplayed>2017-07-26</lastplayed>
<id>5088686</id>
<uniqueid type="unknown" default="true">5088686</uniqueid>
<genre>Action</genre>
<genre>Adventure</genre>
<genre>Fantasy</genre>
<genre>Mystery</genre>
<credits>Bryan Fuller</credits>
<credits>Michael Green</credits>
<director>David Slade</director>
<premiered>2017-04-30</premiered>
<year>2017</year>
<status></status>
|
Music Artist nfo
Sample Music Artist nfo
Music Album nfo
Sample Music Album nfo
Music Album nfo file (click 'expand' to view) |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <album> <title>The Annie Lennox Collection</title> <musicBrainzAlbumID>957cda28-5e1e-4507-9de7-1d5049415cea</musicBrainzAlbumID> <artistdesc>Annie Lennox</artistdesc> <genre>Pop</genre> <style>TalbumFstrstyles</style> <mood>TalbumFstrmoods</mood> <theme>TalbumFstrthemes</theme> <compilation>false</compilation> <review>TalbumFstrReview</review> <type>album/compilation</type> <releasedate></releasedate> <label>RCA/19 Recordings</label> <thumb preview="http://www.theaudiodb.com/images/media/album/thumb/the-annie-lennox-collection-50b9f63c63338.jpg/preview">http://www.theaudiodb.com/images/media/album/thumb/the-annie-lennox-collection-50b9f63c63338.jpg</thumb> <path>E:\Music Test Test\Annie Lennox\The Annie Lennox Collection\</path> <rating max="10">0.000000</rating> <userrating max="10">5</userrating> <votes>1500</votes> <year>2003</year> <albumArtistCredits> <artist>Annie Lennox</artist> <musicBrainzArtistID>3e30aebd-0557-4cfd-8fb9-3945afa5d72b</musicBrainzArtistID> </albumArtistCredits> <releasetype>album</releasetype> </album> |
Music Video nfo
Sample Music Video nfo
Music Video nfo file (click 'expand' to view) |
---|
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<musicvideo>
<title>Dancing Queen</title>
<userrating>0</userrating>
<top250>0</top250>
<track>-1</track>
<album>Arrival</album>
<outline></outline>
<plot>"Dancing Queen" is a Europop song by the Swedish group ABBA, and the lead single from their fourth studio album, Arrival.</plot>
<tagline></tagline>
<runtime>0</runtime>
<thumb preview="http://www.theaudiodb.com/images/media/album/thumb/arrival-4ee244732bbde.jpg/preview">http://www.theaudiodb.com/images/media/album/thumb/arrival-4ee244732bbde.jpg</thumb>
<mpaa></mpaa>
<playcount>0</playcount>
<lastplayed></lastplayed>
<id></id>
<genre>Pop</genre>
<year>1976</year>
<status></status>
|
nfo Tags
A list of all available tags that Kodi recognises follows in this section. As mentioned previously, there are many common tags, but there are also specific tags for each part of the library. Ensure you use the correct tags.
Movie Tags
TV Show Tags
TV Show Episode Tags
Music Tags
@DaveBlake- This is what I am trying to achieve, combining database fields with the Source of the Data (scraper, file tags etc) and nfo tags.
At first I expected that all nfo tags would have a corresponding database field. I did not expect that some tags would have no database field. So not sure how to show that in this table yet.
I would like to keep the Music File Tag column, but that is inaccurate as it is only showing the Vorbis tags, and there are four other tagging styles that will need to be included which makes the table too complicated looking. Which is why I created the second table (exactly the same) except without the music file tag column. I have placed a reference to the appropriate table.
The tables will not be on this page. I will modify the Database Table wiki page, and simply place a link to it in this page.
More questions...
- How do you know when there is a hierarchy with tags and what will be the best way to document that? eg. You have...
<genre>
and then...
<album> <title>Blah</title> <year>2017</year> </album>
- Some tags have qualifiers. How do I know when a qualifier can be used...
<userrating max="10">7</userrating>
- Some tags come from Music Files, some Tags come from online Scrapers. Makes sense when first building your library. But when you export your library, some of the Music File Tags are entered into the nfo file. Now we have the same Tag information in the music file and in the nfo. When rebuilding your library, which takes precedence? Does nfo files override the music tags?
Do you have any other suggestions on how to document this?
Database Field | Data Type | Description | Source of Data | NFO Tag | Music File Tag | |
---|---|---|---|---|---|---|
idAlbum | integer | Primary Key | DB Internal | |||
strAlbum | varchar(256) | Album title | Music File Tag | <title> | ALBUM | |
strMusicBrainzAlbumID | text | MusicBrainz Album ID (release ID) | Music File Tag | <musicBrainzAlbumID> | MUSICBRAINZ_ALBUMID | |
strArtists | text | album artist(s) description (not always a concatenation of names) | Music File Tag | <artistdesc> | ARTISTS | |
strGenres | text | Album genres (denormalised concatenation of values in genre table) | Music File Tag | <genre> ^^ | GENRE | |
iYear | integer | Album release year | Music File Tag | <year> | Year | |
idThumb | integer | [Unused] | DB Internal | |||
bCompilation | integer | Compilation flag | Scraper | <compilation> | ||
strMoods | text | Album moods | Scraper | <mood> ^^ | ||
strStyles | text | Album styles | Scraper | <style> ^^ | ||
strThemes | text | Album themes | Scraper | <theme> ^^ | ||
strReview | text | Album review | Scraper | <review> | ||
strImage | text | URLs for available remote album images | Scraper ^^^ | |||
strLabel | text | Album recording label | Music File Tag | <label> | LABEL | |
strType | text | Album Type e.g. "Soundtrack / Live" | Music File Tag | <type> | RELEASETYPE | |
fRating | float | Album rating | Scraper | <rating max="10"> | ||
iUserrating | integer | Album user rating (out of 10) | User | <userrating max="10"> | ||
lastScraped | text | Date/time data scraped from online sources or NFO files | DB Internal | |||
strReleaseType | text | Internal type - "album" or "single" | Music File Tag | XXXX BUT Shouldn't?? | RELEASETYPE | |
iVotes | integer | Album votes (for rating) | Scraper | <votes> |
^^ Multiple entries allowed
^^^ Scraped online, but there is no NFO entry
To view a list of Music File Tags read by Kodi, See : Tags Kodi Reads
Database Field | Data Type | Description | Source of Data | NFO Tag | |
---|---|---|---|---|---|
idAlbum | integer | Primary Key | DB Internal | ||
strAlbum | varchar(256) | Album title | Music File Tag | <title> | |
strMusicBrainzAlbumID | text | MusicBrainz Album ID (release ID) | Music File Tag | <musicBrainzAlbumID> | |
strArtists | text | album artist(s) description (not always a concatenation of names) | Music File Tag | <artistdesc> | |
strGenres | text | Album genres (denormalised concatenation of values in genre table) | Music File Tag | <genre> ^^ | |
iYear | integer | Album release year | Music File Tag | <year> | |
idThumb | integer | [Unused] | DB Internal | ||
bCompilation | integer | Compilation flag | Scraper | <compilation> | |
strMoods | text | Album moods | Scraper | <mood> ^^ | |
strStyles | text | Album styles | Scraper | <style> ^^ | |
strThemes | text | Album themes | Scraper | <theme> ^^ | |
strReview | text | Album review | Scraper | <review> | |
strImage | text | URLs for available remote album images | Scraper ^^^ | ||
strLabel | text | Album recording label | Music File Tag | <label> | |
strType | text | Album Type e.g. "Soundtrack / Live" | Music File Tag | <type> | |
fRating | float | Album rating | Scraper | <rating max="10"> | |
iUserrating | integer | Album user rating (out of 10) | User | <userrating max="10"> | |
lastScraped | text | Date/time data scraped from online sources or NFO files | DB Internal | ||
strReleaseType | text | Internal type - "album" or "single" | Music File Tag | XXXX BUT Shouldn't?? | |
iVotes | integer | Album votes (for rating) | Scraper | <votes> |
^^ Multiple entries allowed
^^^ Scraped online, but there is no NFO entry
Music Video Tags
Return to top |
---|