Import-export library/Video - Revision history

Karellen at 07:26, 7 February 2025

2025-02-07T07:26:58Z

@@ Line 102: / Line 102: @@
 File:LibExp09.jpg|Image 4- A progress screen will display
 </gallery>
@@ Line 113: / Line 137: @@
 {{top}}
-{{updated|20}}
+{{updated|21}}
 [[Category:Karellen]]
 [[Category:Video library]]

Karellen: Updated for v20

2023-02-07T22:03:31Z

Updated for v20

@@ Line 11: / Line 11: @@
 {{mininav|[[Video_library|Video Library]]|[[Import-export_library|Import Export Library]]}}
 {{see also|NFO files|Artwork|Backup}}
@@ Line 44: / Line 22: @@
 In settings, select '''Export library''' as shown in the first image. You will be required to choose the Export method as depicted in the second image.
-{{warning|If you intend to export artwork from cache, be aware of the modifications that {{kodi}} makes to cached artwork. If you have local artwork, do not export artwork.}}
+{{warning|If you intend to export artwork from cache, be aware of the modifications that {{kodi}} makes to cached artwork. '''If you have local artwork, do not export artwork.'''}}
 '''''See: [[Artwork#Cache|Artwork Cache]]'''''
@@ Line 135: / Line 113: @@
 {{top}}
 [[Category:Karellen]]
 [[Category:Video library]]

LGoosens: Structured markup + changed flow for clarity

2022-12-15T21:04:46Z

Structured markup + changed flow for clarity

← Older revision		Revision as of 21:04, 15 December 2022
Line 44:		Line 44:
	In settings, select '''Export library''' as shown in the first image. You will be required to choose the Export method as depicted in the second image.		In settings, select '''Export library''' as shown in the first image. You will be required to choose the Export method as depicted in the second image.

	{{~~red~~\|If you intend to export artwork from cache, be aware of the modifications that {{kodi}} makes to cached artwork. If you have local artwork, do not export artwork.}}		{{warning\|If you intend to export artwork from cache, be aware of the modifications that {{kodi}} makes to cached artwork. If you have local artwork, do not export artwork.}}

	'''''See: [[Artwork#Cache\|Artwork Cache]]'''''		'''''See: [[Artwork#Cache\|Artwork Cache]]'''''

Line 59:		Line 58:
	This option will export the metadata stored in the database and save it as a '''nfo file'''. It will be saved to the same directory where that particular Movie/TV Show/Episode/Music Video is located.		This option will export the metadata stored in the database and save it as a '''nfo file'''. It will be saved to the same directory where that particular Movie/TV Show/Episode/Music Video is located.

	*After selecting '''Separate''', you will then be asked if you would like to '''Export thumbnails and fanart?'''. This will export all artwork that has been cached.		{{note\|Exported artwork will use the long name format of ''<videofilename>-<artworktype>.<ext>'' eg- ''Lucy (2014)-poster.jpg''}}
	**Choosing '''Yes''' will save a copy of the cached artwork into the Movie, TV Show, TV Show Episode and Music Video directory alongside the video file and the nfo file.		{{warning\|If you use local artwork, do not export artwork as your original artwork may be overwritten with an inferior copy or duplicated if you use the short name format.}}
	**Choosing '''No''' will not export artwork
	~~:'''Note 1:'''~~ Exported artwork will use the long name format of ''<videofilename>-<artworktype>.<ext>'' eg- ''Lucy (2014)-poster.jpg''
	~~:'''Note 2:'''~~ If you use local artwork, do not export artwork as your original artwork may be overwritten with an inferior copy or duplicated if you use the short name format.

	*If you selected ''Yes'' to the previous option you will be asked '''Export Actors Thumbs?'''.		#After selecting '''Separate''', you will then be asked if you would like to '''Export thumbnails and fanart?'''. This will export all artwork that has been cached.
	**Choosing '''Yes''' will export a copy of the Actors artwork in a directory named ''.actors''		#*Choosing '''Yes''' will save a copy of the cached artwork into the Movie, TV Show, TV Show Episode and Music Video directory alongside the video file and the nfo file.
	**Choosing '''No''' will not export a copy of the Actors artwork		#*Choosing '''No''' will not export artwork
			# If you selected ''Yes'' to the previous option you will be asked '''Export Actors Thumbs?'''.
	*The final option is '''Overwrite Old Files?'''.		#* Choosing '''Yes''' will export a copy of the Actors artwork in a directory named ''.actors''
	**Choosing '''Yes''' will overwrite the existing nfo files and artwork (if selected). This is useful if you have modified your metadata such as changed the artwork, created or modified movie sets, etc. Any movies/tv shows/music videos that were not present since the last Export will have the nfo and artwork exported to their directory.		#* Choosing '''No''' will not export a copy of the Actors artwork
	**Choosing '''No''' will add nfo files and artwork to those movies/tv shows/music videos that do not already have them. eg they are new and added after the last export. If you made changes to a movie/tv show/music video that already has an nfo created, these changes will '''not''' be exported.		# The final option is '''Overwrite Old Files?'''.
	**If this is the first time this option has been run and/or you have no nfo files and artwork saved in your movie/tv show/music video directories, both choices will have the same result.		#* Choosing '''Yes''' will overwrite the existing nfo files and artwork (if selected). This is useful if you have modified your metadata such as changed the artwork, created or modified movie sets, etc. Any movies/tv shows/music videos that were not present since the last Export will have the nfo and artwork exported to their directory.
			#* Choosing '''No''' will add nfo files and artwork to those movies/tv shows/music videos that do not already have them. eg they are new and added after the last export. If you made changes to a movie/tv show/music video that already has an nfo created, these changes will '''not''' be exported.
			#* If this is the first time this option has been run and/or you have no nfo files and artwork saved in your movie/tv show/music video directories, both choices will have the same result.

	The Export will commence immediately once the final option is selected. An onscreen progress bar will indicate progress.		The Export will commence immediately once the final option is selected. An onscreen progress bar will indicate progress.
Line 115:		Line 113:
	If you exported your library using the '''Export to Single File''' option, you will need to use this method to import the data as follows		If you exported your library using the '''Export to Single File''' option, you will need to use this method to import the data as follows

			{{note\|The media Sources must be set before attempting the Import. '''''See: [[Adding_video_sources]]'''''}}

	~~'''Note:''' The media Sources must be set before attempting the Import. '''''See: [[Adding_video_sources]]'''''~~		{{note\|If you have removed media from the library since the export, the media will be imported into the library. You will need to run a ''Clean Library'' to remove them.}}

	~~'''Note:'''~~ If you have removed media from the library since the export, the media will be imported into the library. You will need to run a ''Clean Library'' to remove them.

Karellen: v20 changes

2022-01-15T18:50:49Z

v20 changes

← Older revision		Revision as of 18:50, 15 January 2022
Line 15:		Line 15:

	= Watched, PlayCount, ResumePoints =		= Watched, PlayCount, ResumePoints =
			{{warning\|From v20 Nexus the <importwatchedstate> and <importresumepoint> settings have been reversed. It is no longer necessary to add these tags to allow import of that data. That data will be imported by default. The tags are only required to exclude the importing of that particular data.<ref>https://github.com/xbmc/xbmc/pull/20842</ref> If these tags are already present in your advancedsettings.xml file, there is no issue if they remain.}}

	By default {{kodi}} will export all data in the MyVideosxxx.db.		By default {{kodi}} will export all data in the MyVideosxxx.db.

Line 126:		Line 128:
	</gallery>		</gallery>



			= References =
			<references />

Karellen at 19:19, 12 January 2021

2021-01-12T19:19:21Z

← Older revision		Revision as of 19:19, 12 January 2021
Line 77:		Line 77:

	== Single File ==		== Single File ==
			{{warning\|'''This method is not the recommended export method'''. Do not use this method unless you have a specific need to do so '''and''' understand the following limitations:<br>
			* If you rearrange files and folders after the export, the export still contains the original paths which will be imported creating dead library entries<br>
			* Unless you are using Absolute file paths, you cannot build a new library on a different {{kodi}} installation<br>
			* URL's to remote artwork are rewritten to the location of the export folder. You will be unable to change artwork using the "Choose Art" option, and if the export folder is deleted (which contains the exported artwork) the artwork will slowly disappear from the library
			'''Use the Separate Files method detailed in the previous section'''}}

	<gallery mode="packed" widths="500px" heights="283px">		<gallery mode="packed" widths="500px" heights="283px">
	File:LibExp06.jpg		File:LibExp06.jpg
	</gallery>		</gallery>
	{{red\|'''Note''': Do not use this option if you have changed, or intend to change, the filenames or paths of your video files after running the Export. Doing so will leave you with a dead library. The data will be imported but Kodi will not be able to locate the moved files. Use the Separate files method instead.}}

	This option will export all metadata and all artwork to a single directory, to a location nominated by the user, as follows:		This option will export all metadata and all artwork to a single directory, to a location nominated by the user, as follows:
Line 90:		Line 95:
	*Subsequent exports are '''full''' exports. They are '''not''' incremental exports.		*Subsequent exports are '''full''' exports. They are '''not''' incremental exports.

	~~{{note\|The Single File Export process changes the artwork location URL to the folder location of the export, which causes an issue if you need to refresh the image.}}~~
	{{-}}		{{-}}

Line 129:		Line 133:
	{{top}}		{{top}}

	{{updated\|18}}		{{updated\|19}}
	~~[[Category:FAQ]]~~
	~~[[Category:Index]]~~
	~~[[Category:Guides]]~~
	~~[[Category:Manual]]~~
	[[Category:Karellen]]		[[Category:Karellen]]
	[[Category:Video library]]		[[Category:Video library]]
	~~[[Category:Advanced topics]]~~
	~~[[Category:First time user]]~~
	~~[[Category:Quick Start Guide]]~~

Karellen at 02:26, 16 February 2020

2020-02-16T02:26:20Z

← Older revision		Revision as of 02:26, 16 February 2020
Line 10:		Line 10:

	{{mininav\|[[Video_library\|Video Library]]\|[[Import-export_library\|Import Export Library]]}}		{{mininav\|[[Video_library\|Video Library]]\|[[Import-export_library\|Import Export Library]]}}
	{{see also\|NFO files\|Artwork\|~~HOW-TO:~~Backup ~~the video library~~}}		{{see also\|NFO files\|Artwork\|Backup}}

Karellen at 09:56, 27 April 2019

2019-04-27T09:56:29Z

← Older revision		Revision as of 09:56, 27 April 2019
Line 108:		Line 108:
	== Single File ==		== Single File ==
	If you exported your library using the '''Export to Single File''' option, you will need to use this method to import the data as follows		If you exported your library using the '''Export to Single File''' option, you will need to use this method to import the data as follows


			'''Note:''' The media Sources must be set before attempting the Import. '''''See: [[Adding_video_sources]]'''''

			'''Note:''' If you have removed media from the library since the export, the media will be imported into the library. You will need to run a ''Clean Library'' to remove them.


	<gallery mode="packed-overlay" widths="500px" heights="283px">		<gallery mode="packed-overlay" widths="500px" heights="283px">
Line 116:		Line 122:
	</gallery>		</gallery>

	~~'''{{red\|Note: If you have removed media from the library since the export, the media will be imported into the library. You will need to run a ''Clean Library'' to remove them.}}'''~~

Karellen: Remove ambiguity from Import section

2019-04-27T09:25:40Z

Remove ambiguity from Import section

← Older revision		Revision as of 09:25, 27 April 2019
Line 109:		Line 109:
	If you exported your library using the '''Export to Single File''' option, you will need to use this method to import the data as follows		If you exported your library using the '''Export to Single File''' option, you will need to use this method to import the data as follows

	*Select '''~~Import~~''' ~~to commence~~ the ~~import process~~		<gallery mode="packed-overlay" widths="500px" heights="283px">
	*Locate the the directory that holds the single file export		File:LibExp01.jpg\|Image 1- Select Import in the Video Library section
	*If you have multiple single file exports, ensure you have selected the correct one.		File:LibExp07.jpg\|Image 2- Navigate and locate the correct export folder
	*Select '''Ok'''. A progress ~~bar~~ will ~~be displayed to indicate progress~~		File:LibExp08.jpg\|Image 3- '''Enter''' the folder and select '''OK'''
	*Once complete, your library should be functional again		File:LibExp09.jpg\|Image 4- A progress screen will display
			</gallery>

	~~Be aware that if~~ you have removed ~~movies or tv shows or music videos~~ since the export, the ~~metadata for those movies, tv shows and music videos~~ will be ~~re-~~imported into the library. You will need to run a '''Clean Library''' to remove them.		'''{{red\|Note: If you have removed media from the library since the export, the media will be imported into the library. You will need to run a ''Clean Library'' to remove them.}}'''

Karellen: fix mininav

2019-04-14T03:35:18Z

fix mininav

← Older revision		Revision as of 03:35, 14 April 2019
Line 9:		Line 9:
	\|}		\|}

	{{mininav\|[[Video_library\|Video Library]]~~{{l2~~\|[[~~Music_library~~\|~~Music~~ Library]]}}}}		{{mininav\|[[Video_library\|Video Library]]\|[[Import-export_library\|Import Export Library]]}}
	{{see also\|NFO files\|Artwork\|HOW-TO:Backup the video library}}		{{see also\|NFO files\|Artwork\|HOW-TO:Backup the video library}}

Karellen: Page created for v18

2019-04-14T03:21:46Z

Page created for v18

New page

{|class="infobox" style="width:200px"
! Import-Export Contents
|-
|
* '''[[Import-export_library|Import-Export]]'''
** '''[[Import-export_library/Music|Music Library]]'''
** '''[[Import-export_library/Video|Video Library]]'''
* '''[[HOW-TO:Create_Video_Library|Return to Video Guide]]'''
|}

{{mininav|[[Video_library|Video Library]]{{l2|[[Music_library|Music Library]]}}}}
{{see also|NFO files|Artwork|HOW-TO:Backup the video library}}

= Watched, PlayCount, ResumePoints =
By default {{kodi}} will export all data in the MyVideosxxx.db.

The Watched Status, Play Counts and Resume Points are '''not imported''' by default. By pasting the following code to the ''advancedsettings.xml'' file, any or all three items can be imported. Do not duplicate the ''<advancedsettings>'' tags if you already have the advancedsettings.xml file.
:'''false''' = Not imported
:'''true''' = Imported
:{{small see also|Advancedsettings.xml}}

<syntaxhighlight lang=xml>
<advancedsettings>
<videolibrary>
<exportautothumbs>false</exportautothumbs> 
<importwatchedstate>false</importwatchedstate> 
<importresumepoint>false</importresumepoint> 
</videolibrary>
</advancedsettings>
</syntaxhighlight>

= Export =
<gallery mode="packed" widths="500px" heights="283px">
File:LibExp01.jpg|Location of setting
File:LibExp02.png|Select which Export option you require.
</gallery>

In settings, select '''Export library''' as shown in the first image. You will be required to choose the Export method as depicted in the second image.

{{red|If you intend to export artwork from cache, be aware of the modifications that {{kodi}} makes to cached artwork. If you have local artwork, do not export artwork.}}

'''''See: [[Artwork#Cache|Artwork Cache]]'''''

== Separate Files ==
<gallery mode="packed" widths="500px" heights="283px">
File:LibExp03.png|Do you want to export Thumbnails and Fanart?
File:LibExp05.jpg|Do you want to export Actors Thumbs?
File:LibExp04.png|Do you want to Overwrite Old Files?
</gallery>

This option will export the metadata stored in the database and save it as a '''nfo file'''. It will be saved to the same directory where that particular Movie/TV Show/Episode/Music Video is located.

*After selecting '''Separate''', you will then be asked if you would like to '''Export thumbnails and fanart?'''. This will export all artwork that has been cached.
**Choosing '''Yes''' will save a copy of the cached artwork into the Movie, TV Show, TV Show Episode and Music Video directory alongside the video file and the nfo file.
**Choosing '''No''' will not export artwork
:'''Note 1:''' Exported artwork will use the long name format of ''<videofilename>-<artworktype>.<ext>'' eg- ''Lucy (2014)-poster.jpg''
:'''Note 2:''' If you use local artwork, do not export artwork as your original artwork may be overwritten with an inferior copy or duplicated if you use the short name format.

*If you selected ''Yes'' to the previous option you will be asked '''Export Actors Thumbs?'''.
**Choosing '''Yes''' will export a copy of the Actors artwork in a directory named ''.actors''
**Choosing '''No''' will not export a copy of the Actors artwork

*The final option is '''Overwrite Old Files?'''.
**Choosing '''Yes''' will overwrite the existing nfo files and artwork (if selected). This is useful if you have modified your metadata such as changed the artwork, created or modified movie sets, etc. Any movies/tv shows/music videos that were not present since the last Export will have the nfo and artwork exported to their directory.
**Choosing '''No''' will add nfo files and artwork to those movies/tv shows/music videos that do not already have them. eg they are new and added after the last export. If you made changes to a movie/tv show/music video that already has an nfo created, these changes will '''not''' be exported.
**If this is the first time this option has been run and/or you have no nfo files and artwork saved in your movie/tv show/music video directories, both choices will have the same result.

The Export will commence immediately once the final option is selected. An onscreen progress bar will indicate progress.

== Single File ==
<gallery mode="packed" widths="500px" heights="283px">
File:LibExp06.jpg
</gallery>
{{red|'''Note''': Do not use this option if you have changed, or intend to change, the filenames or paths of your video files after running the Export. Doing so will leave you with a dead library. The data will be imported but Kodi will not be able to locate the moved files. Use the Separate files method instead.}}

This option will export all metadata and all artwork to a single directory, to a location nominated by the user, as follows:
*The only option available is the ''save location'' which you will be prompted and required to enter
*Kodi will create a directory in your selected location named ''xbmc_videodb_yyyy-mm-dd''
*Library metadata will be saved into a single ''videodb.xml'' file within that directory
*Artwork will be saved within multiple sub-directories according to type
*Subsequent exports '''will not''' overwrite existing Single File exports
*Subsequent exports are '''full''' exports. They are '''not''' incremental exports.

{{note|The Single File Export process changes the artwork location URL to the folder location of the export, which causes an issue if you need to refresh the image.}}
{{-}}

= Import =
Which Import method you use will depend on which Export method was used:

== Separate Files ==
If you exported your library using the '''Export to Separate Files''' option, then you must use the normal scraping process to re-import the data from the NFO Files. eg Update Library option.

:'''''See:[[Updating_or_removing_videos|Adding or Removing Videos]]'''''

== Single File ==
If you exported your library using the '''Export to Single File''' option, you will need to use this method to import the data as follows

*Select '''Import''' to commence the import process
*Locate the the directory that holds the single file export
*If you have multiple single file exports, ensure you have selected the correct one.
*Select '''Ok'''. A progress bar will be displayed to indicate progress
*Once complete, your library should be functional again

Be aware that if you have removed movies or tv shows or music videos since the export, the metadata for those movies, tv shows and music videos will be re-imported into the library. You will need to run a '''Clean Library''' to remove them.

{{top}}

{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:Video library]]
[[Category:Advanced topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]