>Martijn |
|
(66 intermediate revisions by 10 users not shown) |
Line 1: |
Line 1: |
| {{cleanup}} | | {|class="infobox" style="width:200px" |
| {{XBMC faq toc Inline}}
| | ! Import-Export Contents |
| XBMC offers the capability to import and export data manually into/from the [[Library|Media Library]], as well as importing media info automatically from .nfo files.
| | |- |
| | | |
| | * '''[[Import-export_library|Import-Export]]''' |
| | ** '''[[Import-export_library/Music|Music Library]]''' |
| | ** '''[[Import-export_library/Video|Video Library]]''' |
| | * '''[[HOW-TO:Create_Music_Library|Return to Music Guide]]''' |
| | * '''[[HOW-TO:Create_Video_Library|Return to Video Guide]]''' |
| | |} |
|
| |
|
| ==Import / Export options==
| | {{mininav|[[Video_library|Video Library]]{{l2|[[Music_library|Music Library]]}}}} |
| The Import / Export options can be found in Relevant [[Music Settings|Music]] / [[Videos Settings|Videos]] Settings.
| | {{see also|NFO files|Artwork|Backup}} |
|
| |
|
| '''Video Library:'''<br />
| |
| ;Export Video Library
| |
| :Exports the Library [[The XBMC Database|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.
| |
| # 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.
| |
| # 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:
| |
| # It removes all current info for that entry from the database.
| |
| # 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.}}
| | = Introduction = |
| | <section begin="intro" />Kodi has the option to Export and Import the library databases. These options may be used for a number of reasons including the following more popular ones: |
| | *Perform database backup and recovery |
| | *Reorganization of data or eliminate database fragmentation {{resize|0.8em|(export, clean/remove database, re-import)}} |
| | *Move data between Kodi databases on different platforms {{resize|0.8em|(eg Widows to Linux)}}<section end="intro" /> |
|
| |
|
| '''Music Library:'''<br />
| |
| ;Export Music Library
| |
| :Exports the Library [[The XBMC Database|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:
| |
| # It removes all current info for that entry from the database.
| |
| # 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== | | = Music Library = |
| 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.
| | This page details how to Import and Export the Music Library. |
|
| |
|
| 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: [[Import-export_library/Music| Import-Export Music lIbrary]]''''' |
|
| |
|
| See [[NFO_files]]
| |
|
| |
|
| ==Importing library information from "My Movies" media management software==
| |
| [http://www.mymovies.dk/ My Movies (www.mymovies.name)] is an online database for profiling DVD-Video movies. [http://www.mymovies.dk/ 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 "[http://www.mymovies.dk/ My Movies]" via the mymovies.xml files that it generates, these mymovies.xml are checked after the movie.nfo file.
| | = Video Library = |
| | This page details how to Import and Export the Video Library which consists of: |
| | *'''Movies'''- Metadata and artwork |
| | *'''TV Shows'''- Metadata and artwork |
| | *'''Music Videos'''- Metadata and artwork |
|
| |
|
| ==Music .nfo files==
| | '''''See: [[Import-export_library/Video| Import-Export Video lIbrary]]''''' |
|
| |
|
| ===Music .nfo Files containing XML data===
| |
|
| |
|
| ====Artists====
| | '''Note:''' You cannot selectively Import or Export parts of the database. |
| 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>
| |
|
| |
|
| | = A Note on Artwork = |
|
| |
|
| </source>
| | Cached artwork is an optimized version of the original image and this is what {{kodi}} exports, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible. |
|
| |
|
| {{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.}}
| | To download original artwork to save locally use one of the following addons... |
| ====Albums==== | | * '''[https://forum.kodi.tv/showthread.php?tid=360078 Artwork Dump]'''- for v19 and later |
| Album.nfo in the album folder containing:
| | * '''[https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]'''- for v18 and earlier |
| <source lang="xml">
| |
|
| |
|
| <album>
| | An explanation of the effects of these optimizations can be located in the [https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318 forum here]. |
| <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====
| | {{top}} |
| 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].
| | {{updated|20}} |
| <nowiki>http://www.allmusic.com/cg/amg.dll?p=amg&sql=10:kifoxqualdde</nowiki>
| |
|
| |
|
| ==Additional information==
| | [[Category:Karellen]] |
| Additional information on how to add format-tags for text and labels (Eg. '''Bold''', ''Italic'') can be found under [[Label Formatting]]
| | [[Category:Music library]] |
| | | [[Category:Video library]] |
| [[Category:Scraper]] | |
| [[Category:To-Do]] | |
| [[Category:Video Library]] | |
| [[Category:Music Library]]
| |