Import-export library: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Martijn
>Martijn
Line 45: Line 45:


XBMC has the ability to get the import movie library information from "[http://www.mymovies.dk/ My Movies]" via the mymovies.xml files that it generates, these mymovies.xml are checked after the movie.nfo file.
XBMC has the ability to get the import movie library information from "[http://www.mymovies.dk/ My Movies]" via the mymovies.xml files that it generates, these mymovies.xml are checked after the movie.nfo file.
==Music .nfo files==
===Music .nfo Files containing XML data===
====Artists====
Artist.nfo in the artist folder containing:
<source lang="xml">
<artist>
  <name>Artist/Band Name</name>
  <genre clear=true>First Genre</genre>
  <genre>Second Genre</genre>
  ...
  <genre>Nth Genre</genre>
  <style clear=true>First Style</style>
  <style>Second Style</style>
  ...
  <style>Nth Style<style>
  <mood clear=true>First Mood</mood>
  <mood>Second Mood</mood>
  ...
  <mood>Nth Mood</mood>
  <yearsactive clear=true>First year active (1993)</yearsactive>
  <yearsactive>Second year active (1995)</yearsactive>
  ...
  <yearsactive>Nth year active (2000)</yearsactive>
  <born>Birth date of artist</born>
  <formed>Date band formed</formed>
  <instruments>Musical instruments used by artist/band</instruments>
  <biography>Artist/Band biography text</biography>
  <died>Date artist died</died>
  <disbanded>Date band broke up<disbanded>
  <thumb>/path/to/unix/style/artist/thumb1.tbn</thumb>
  <thumb>C:\path\to\win32\style\artist\thumb2.png</thumb>
  <thumb>http://path.to/www/remote/artist/thumb3.jpg</thumb>
  <thumb>smb://path/to/smb/remote/artist/thumbN.tbn</thumb>
  <album>
    <title>First Album Title</title>
    <year>Release year of first album</year>
  </album>
  ...
  <album>
    <title>Nth Album Title</title>
    <year>Release year of Nth album</year>
  </album>
</artist>
</source>
{{note|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.}}
====Albums====
Album.nfo in the album folder containing:
<source lang="xml">
<album>
  <title>The Album Title</title>
  <artist clear=true>First Artist</artist>
  <artist>Second Artist</artist>
  ...
  <artist>Nth Artist</artist>
  <genre clear=true>First Genre</genre>
  <genre>Second Genre</genre>
  ...
  <genre>Nth Genre</genre>
  <style clear=true>First Style</style>
  <style>Second Style</style>
  ...
  <style>Nth Style<style>
  <mood clear=true>First Mood</mood>
  <mood>Second Mood</mood>
  ...
  <mood>Nth Mood</mood>
  <theme clear=true>First Theme</theme>
  <theme>Second Theme</theme>
  ...
  <theme>Nth Theme</theme>
  <review>Album review text</review>
  <releasedate>Album release date</releasedate>
  <label>Record label the album was released under</label>
  <type>Erm...EP/LP? CD,Vinyl,DVDA,etc? I dunno</type>
  <year>Year album was released</year>
  <rating>Rating out of 5?<rating>
  <thumb>/path/to/unix/style/album/thumb1.tbn</thumb>
  <thumb>C:\path\to\win32\style\album\thumb2.png</thumb>
  <thumb>http://path.to/www/remote/album/thumb3.jpg</thumb>
  ...
  <thumb>smb://path/to/smb/remote/thumbN.tbn</thumb>
  <track>
    <position>Track Number (1)</position>
    <title>Title of first track</title>
    <duration>Length of first track (XXX min, MM:SS)</duration>
  <track>
  ...
  <track>
    <position>Track Number (N)</position>
    <title>Title of Nth track</title>
    <duration>Length of Nth track</duration>
  <track>
</album>
</source>
{{note|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.}}
===Music .nfo files containing an URL===
====Artists====
Artist.nfo in the artist folder that points to the corresponding artist page on a supported scraper site, such as [http://www.allmusic.com Allmusic.com] or [http://www.discogs.com Discogs].
<nowiki>http://www.allmusic.com/cg/amg.dll?p=amg&sql=11:gifoxqwkldae</nowiki>
Artist.nfo assumes an artist/album directory layout
====Albums====
Album.nfo in the album folder that points to the corresponding album page on a supported scraper site, such as [http://www.allmusic.com Allmusic.com] or [http://www.discogs.com Discogs].
<nowiki>http://www.allmusic.com/cg/amg.dll?p=amg&sql=10:kifoxqualdde</nowiki>


==Additional information==
==Additional information==

Revision as of 07:39, 29 January 2013

Cleanup.png This page or section may require cleanup, updating, spellchecking, reformatting and/or updated images. Please improve this page if you can. The discussion page may contain suggestions.


Template:XBMC faq toc Inline XBMC offers the capability to import and export data manually into/from the Media Library, as well as importing media info automatically from .nfo files.

Import / Export options

The Import / Export options can be found in Relevant Music / Videos Settings.

Video Library:

Export Video Library
Exports the Library database to either one, or multiple XML files. When you initiate an export, XBMC will ask if you want to export to separate or a single file.
  1. When exporting to a single file XBMC will bring up a browser dialog where you select where you want it exported. XBMC will then create a subdirectory with the resulting xml file plus all thumbnails and fanart, watched status will be exported to the xml file.
  2. If you choose to export to separate files you will also be asked if you want to export thumbnails and fanart as well.
The resulting XML .nfo file and associated image files will then be exported to the location of the corresponding video files.
Import Video Library
Imports an XML file into the Library database. If the entry does not exist it is appended.
If it exists:
  1. It removes all current info for that entry from the database.
  2. Inserts the info for that entry from the XML file.

Note: If you wish to import a movie, TV show, music video or episode into the library, use the corresponding format in the exported xml file and enclose it with the <videodb></videodb> tags. Examples can be seen below, as .nfo files.

Music Library:

Export Music Library
Exports the Library database to either one, or multiple XML files. When you initiate an export, XBMC will ask if you want to export to separate or a single file.
If you choose to export to separate files you will also be asked if you want to export thumbnails and fanart as well.
The resulting XML .nfo files and associated image files will then be exported to the location of the corresponding music files.
Import Music / Video Library
Imports a XML file into the Library database. If the entry does not exist it is skipped.
If it exists:
  1. It removes all current info for that entry from the database.
  2. Inserts the info for that entry from the XML file.

Note: To import an exported music library you must scrape your music source prior to importing the library. The music library import will populate the extended meta-data such as artist or album info which is not contained in the music tags.

Video .nfo Files

Nfo files can be used to provide data for a video file in XBMC or influence the search behaviour of scrapers. In particular they are helpful if the information fetched from a web site does not match the video file, or data for that particular file does not exist.

By default at the time of scanning, if the media folder contains a correctly named *.nfo file, then XBMC will load the *.nfo file and attempt to either, in the case of it containing XML data get the meta-data directly from the .nfo file or will parse it for a direct URL to the scraper info page. This allows XBMC to skip its normal lookup and/or search procedures; this is useful if a file's information is not available on any of the scraper sites or if the file-matching criteria fail for the particular file.

See NFO_files

Importing library information from "My Movies" media management software

My Movies (www.mymovies.name) is an online database for profiling DVD-Video movies. My Movies saves an XML file and a poster cover image which with this patch will get scanned by XBMC in the same way as XBMC's own XML formatted NFO files are scanned/scraped.

XBMC has the ability to get the import movie library information from "My Movies" via the mymovies.xml files that it generates, these mymovies.xml are checked after the movie.nfo file.

Additional information

Additional information on how to add format-tags for text and labels (Eg. Bold, Italic) can be found under Label Formatting