Settings/Media/Library - Revision history

Karellen at 08:46, 16 October 2026

2026-10-16T08:46:24Z

← Older revision		Revision as of 08:46, 16 October 2026
Line 102:		Line 102:
	\|- valign="top"		\|- valign="top"
	\| '''Description:'''		\| '''Description:'''
	\| Setting is visible when either ''Ask'' or ''Auto'' are selected in the previous setting.<br>		\|
			Settings ► Media ► Library ► Video Library ► '''Make the most recent version the default version'''<br>
			Setting is visible when either ''Ask'' or ''Auto'' are selected in the previous setting.<br>
	When an existing version or movie exists and a new version is scanned into the library, this new version becomes the default version.<br>		When an existing version or movie exists and a new version is scanned into the library, this new version becomes the default version.<br>
	Users who prefer managing default version themselves should disable this setting. <ref>https://github.com/xbmc/xbmc/pull/28668</ref>		Users who prefer managing default version themselves should disable this setting. <ref>https://github.com/xbmc/xbmc/pull/28668</ref>

Karellen: Update for v22

2026-10-16T08:43:17Z

Update for v22

← Older revision		Revision as of 08:43, 16 October 2026
Line 16:		Line 16:
	\|- valign="top"		\|- valign="top"
	\| '''Description:'''		\| '''Description:'''
	\| This provides access to the Video Sources. It is an alternate access to ~~Videos>Files~~ from the main menu.<br>		\| This provides access to the Video Sources. It is an alternate access to Videos►Files from the main menu.<br>
	See: '''[[HOW-TO:Create Video Library]]'''		See: '''[[HOW-TO:Create Video Library]]'''
	\|}		\|}
Line 28:		Line 28:
	\|- valign="top"		\|- valign="top"
	\| '''Description:'''		\| '''Description:'''
	\| This provides access to the Music Sources. It is an alternate access to ~~Music>Files~~ from the Music menu.<br>		\| This provides access to the Music Sources. It is an alternate access to Music►Files from the Music menu.<br>
	See: '''[[HOW-TO:Create Music Library]]'''		See: '''[[HOW-TO:Create Music Library]]'''
	\|}		\|}
Line 74:		Line 74:


	== ~~Ignore~~ different ~~video~~ versions ~~on scan~~ ==		== Group the different versions of videos ==
	<section begin="IgnoreVideoVersionsScan" />		<section begin="IgnoreVideoVersionsScan" />
	{\|		{\|
Line 83:		Line 83:
	\| '''Description:'''		\| '''Description:'''
	\|		\|
	Settings ► Media ► Library ► Video Library ► '''Ignore different video versions on scan'''		Settings ► Media ► Library ► Video Library ► '''Group the different versions of videos'''<br>
			This new setting in v22 replaces the former ''Ignore different video versions on scan''<br>
			* '''Off''' - No action taken on any video versions. ''Off'' is the same as ''Enabled'' using the former setting
			* '''Ask''' - When versions are found, library scans will pause until a response is made by the user. ''Ask'' is the same as ''Disabled'' using the former setting.
			* '''Auto''' - Automatically creates a new version without user intervention. Library scans are not interrupted.
			Auto uses the same existing video-matching algorithms as Ask (search by unique id then title and year) and when there is a single match, creates a new version with the type of the new setting Default version type. The default type is "Standard Edition", with a selection from all the defined types in the system.
			The default value is "Off", same as the current setting. <ref>https://github.com/xbmc/xbmc/pull/28349</ref>
			\|}<section end="IgnoreVideoVersionsScan" />
			: See: '''[[Video_versions\|Video Versions]]'''

	* '''~~Disabled~~''' - When an Update Library is run and the scanner discovers a title that may be a duplicate of another title already scanned into the library, the Update Library will pause with a pop-up requesting confirmation on how to treat the duplicate. The Library Update will not continue until the pop-up is cleared.
	* '''~~Enabled~~''' ~~- (default) When an Update Library~~ is ~~run, there~~ are ~~no interruptions to~~ the ~~scan~~ and ~~the various versions will be~~ scanned ~~or scraped~~ into the library ~~without a video~~ version ~~being created~~. ~~Use the Versions Manager method described below to create a Video Version after scanning has ended~~.		== Make the most recent version the default version ==
	\|}<section end="~~IgnoreVideoVersionsScan~~" />		<section begin="recentversiondefault" />
			{\|
			\|- valign="top"
			\| width=120px \| {{nowrap\|'''Settings level:'''}}
			\| Advanced
			\|- valign="top"
			\| '''Description:'''
			\| Setting is visible when either ''Ask'' or ''Auto'' are selected in the previous setting.<br>
			When an existing version or movie exists and a new version is scanned into the library, this new version becomes the default version.<br>
			Users who prefer managing default version themselves should disable this setting. <ref>https://github.com/xbmc/xbmc/pull/28668</ref>
			\|}<section end="recentversiondefault" />
			: See: '''[[Video_versions\|Video Versions]]'''


Line 101:		Line 120:
	Settings ► Media ► Library ► Video Library ► '''Ignore video extras on scan'''		Settings ► Media ► Library ► Video Library ► '''Ignore video extras on scan'''

	* '''Disabled''' - When an Update Library is run, and if a folder named ''Extras'' exists, any video files in the folder will be added to the Extras listing for the movie.<br/>See: '''[[Video_extras\|Video Extras]]'''		* '''Disabled''' - When an Update Library is run, and if a folder named ''Extras'' exists, any video files in the folder will be added to the Extras listing for the movie.<br/>
	* '''Enabled''' - (default) When an Update Library is run, any extras in the ''Extras'' folder will not be added to the Extras listing.~~<br/>~~Videos in the ''Extras'' folder will be treated like a movie file and added to the library. ~~To avoid~~ this ensure the advancedsettings.xml file has the correct ignore code.<br/>See: '''[[Video_extras#Advancedsetting.xml\|Video Extras]]'''		See: '''[[Video_extras\|Video Extras]]'''
			* '''Enabled''' - (default) When an Update Library is run, any extras in the ''Extras'' folder will not be added to the Extras listing. Videos in the ''Extras'' folder will be treated like a movie file and added to the library. If this is unwanted, ensure the advancedsettings.xml file has the correct ignore code.<br/>
			See: '''[[Video_extras#Advancedsetting.xml\|Video Extras Advanced Settings]]'''
	\|}<section end="IgnoreVideoExtrasScan" />		\|}<section end="IgnoreVideoExtrasScan" />

Line 219:		Line 240:
	\|}		\|}



			= Maintenance =
			[[File:Settings-Media-Library-Maintenance.jpg\|600px]]


			== Clean image cache ==
			{\|
			\|- valign="top"
			\| width=120px \| {{nowrap\|'''Settings level:'''}}
			\| Expert
			\|- valign="top"
			\| '''Description:'''
			\| v22 adds a conservative image cache cleaning process. It removes images from the cache if they are not in the video or music library and have not been used in the past month. It is a a background process checking up to 1000 images up to 4 times per day.<br>
			This setting allows the user to clear all old images at once. <ref>https://github.com/xbmc/xbmc/pull/25293</ref>
			\|}



			= References =
			<references />


Line 224:		Line 266:

	{{Top}}		{{Top}}
	{{updated\|21}}		{{updated\|22}}

	[[Category:Settings]]		[[Category:Settings]]

Karellen at 03:36, 23 August 2024

2024-08-23T03:36:22Z

← Older revision		Revision as of 03:36, 23 August 2024
Line 102:		Line 102:

	* '''Disabled''' - When an Update Library is run, and if a folder named ''Extras'' exists, any video files in the folder will be added to the Extras listing for the movie.<br/>See: '''[[Video_extras\|Video Extras]]'''		* '''Disabled''' - When an Update Library is run, and if a folder named ''Extras'' exists, any video files in the folder will be added to the Extras listing for the movie.<br/>See: '''[[Video_extras\|Video Extras]]'''
	* '''Enabled''' - (default) When an Update Library is run, any extras in the ''Extras'' folder will not be added to the Extras listing.<br/>Videos in the ''Extras'' folder will be treated like a movie file and added to the library. To avoid this ensure the advancedsettings.xml file has the correct ignore code.<br/>See: '''[[~~Add-on:Extras~~#~~Preventing_Extras_Being_Added_To_Library~~\|~~Preventing~~ Extras ~~being added to the library~~]]'''		* '''Enabled''' - (default) When an Update Library is run, any extras in the ''Extras'' folder will not be added to the Extras listing.<br/>Videos in the ''Extras'' folder will be treated like a movie file and added to the library. To avoid this ensure the advancedsettings.xml file has the correct ignore code.<br/>See: '''[[Video_extras#Advancedsetting.xml\|Video Extras]]'''
	\|}<section end="IgnoreVideoExtrasScan" />		\|}<section end="IgnoreVideoExtrasScan" />

Karellen: v21 Updates

2024-05-01T00:54:31Z

v21 Updates

← Older revision		Revision as of 00:54, 1 May 2024
Line 47:		Line 47:

	= Video Library =		= Video Library =
	[[File:~~Settings_media_library_video_library~~.jpg\|600px]]		[[File:Settings-Media-Library-VideoLibrary.jpg\|600px]]


Line 72:		Line 72:
	\| Hide the pop-up progress bar.		\| Hide the pop-up progress bar.
	\|}		\|}


			== Ignore different video versions on scan ==
			<section begin="IgnoreVideoVersionsScan" />
			{\|
			\|- valign="top"
			\| width=120px \| {{nowrap\|'''Settings level:'''}}
			\| Basic
			\|- valign="top"
			\| '''Description:'''
			\|
			Settings ► Media ► Library ► Video Library ► '''Ignore different video versions on scan'''

			* '''Disabled''' - When an Update Library is run and the scanner discovers a title that may be a duplicate of another title already scanned into the library, the Update Library will pause with a pop-up requesting confirmation on how to treat the duplicate. The Library Update will not continue until the pop-up is cleared.
			* '''Enabled''' - (default) When an Update Library is run, there are no interruptions to the scan and the various versions will be scanned or scraped into the library without a video version being created. Use the Versions Manager method described below to create a Video Version after scanning has ended.
			\|}<section end="IgnoreVideoVersionsScan" />


			== Ignore video extras on scan ==
			<section begin="IgnoreVideoExtrasScan" />
			{\|
			\|- valign="top"
			\| width=120px \| {{nowrap\|'''Settings level:'''}}
			\| Basic
			\|- valign="top"
			\| '''Description:'''
			\|
			Settings ► Media ► Library ► Video Library ► '''Ignore video extras on scan'''

			* '''Disabled''' - When an Update Library is run, and if a folder named ''Extras'' exists, any video files in the folder will be added to the Extras listing for the movie.<br/>See: '''[[Video_extras\|Video Extras]]'''
			* '''Enabled''' - (default) When an Update Library is run, any extras in the ''Extras'' folder will not be added to the Extras listing.<br/>Videos in the ''Extras'' folder will be treated like a movie file and added to the library. To avoid this ensure the advancedsettings.xml file has the correct ignore code.<br/>See: '''[[Add-on:Extras#Preventing_Extras_Being_Added_To_Library\|Preventing Extras being added to the library]]'''
			\|}<section end="IgnoreVideoExtrasScan" />


Line 81:		Line 113:
	\|- valign="top"		\|- valign="top"
	\| '''Description:'''		\| '''Description:'''
	\| ~~Clean~~ the library database.		\| Is used to clean orphaned entries in the library database. Not all tables are cleaned by this process.
	~~{{divbox\|yellow\|Removing content from disconnected sources\|If storage media~~ are ~~disconnected, using~~ this ~~function will not remove their contents from the library. This protects your library from accidental erasure in case a removable storage device is unplugged~~.

	To permanently remove titles from the library:~~<br>~~		Removing content from disconnected sources<br/>
			If storage media are disconnected, using this function will not remove their contents from the library. This protects your library from accidental erasure in case a removable storage device is unplugged.<br/>
			To permanently remove titles from the library:
	# Use the correct method of removing titles from the library as detailed in the link below.<br>		# Use the correct method of removing titles from the library as detailed in the link below.<br>
	# After correctly deleting from the library first, ''then'' run a clean library to purge the database of unnecessary records.<br>		# After correctly deleting from the library first, ''then'' run a clean library to purge the database of unnecessary records.<br>
	See '''[[Updating_or_removing_videos#Remove_From_Library\|Removing content]]'''}}		See: '''[[Updating_or_removing_videos#Remove_From_Library\|Removing content]]'''
	\|}		\|}

Line 100:		Line 133:
	\| Export the contents of the video library. Used as a backup of your library, or to create a new {{kodi}} installation.		\| Export the contents of the video library. Used as a backup of your library, or to create a new {{kodi}} installation.
	{{note\|For the Video library, we recommend using the Separate Files method.}}<br>		{{note\|For the Video library, we recommend using the Separate Files method.}}<br>
	See '''[[Import-export_library/Video\|Export Video Library]]'''		See: '''[[Import-export_library/Video\|Export Video Library]]'''
	\|}		\|}

Line 112:		Line 145:
	\| '''Description:'''		\| '''Description:'''
	\| If you exported your library using the '''Single File''' method, use this to import the single file into the video library.<br>		\| If you exported your library using the '''Single File''' method, use this to import the single file into the video library.<br>
	See '''[[Import-export_library/Video#Import\|Import Single File]]'''		See: '''[[Import-export_library/Video#Import\|Import Single File]]'''
	\|}		\|}

Line 171:		Line 204:
	\| Music files are still required to have the correct embedded tags to be scanned into the library. This function will export the additional data that was scraped into the music library.		\| Music files are still required to have the correct embedded tags to be scanned into the library. This function will export the additional data that was scraped into the music library.
	For the Music library, we recommend using the Single Files method as this will also export play counts, user ratings and last played data.<br>		For the Music library, we recommend using the Single Files method as this will also export play counts, user ratings and last played data.<br>
	See '''[[Import-export_library/Music\|Export Music Library]]'''		See: '''[[Import-export_library/Music\|Export Music Library]]'''
	\|}		\|}

Line 183:		Line 216:
	\| '''Description:'''		\| '''Description:'''
	\| If you exported your library using the '''Single File''' method, use this to import the single file into the music library.<br>		\| If you exported your library using the '''Single File''' method, use this to import the single file into the music library.<br>
	See '''[[Import-export_library/Music#Import_-_Single_File\|Import Single File]]'''		See: '''[[Import-export_library/Music#Import_-_Single_File\|Import Single File]]'''
	\|}		\|}

Line 191:		Line 224:

	{{Top}}		{{Top}}
	{{updated\|20}}		{{updated\|21}}

	[[Category:Settings]]		[[Category:Settings]]

Karellen: Updated for v20

2023-01-16T23:44:59Z

Updated for v20

Show changes

LGoosens: Changed wording

2022-12-15T21:50:07Z

Changed wording

← Older revision		Revision as of 21:50, 15 December 2022
Line 84:		Line 84:
	\|}		\|}

	{{divbox\|yellow\|Removing content from disconnected sources\|If storage media are disconnected, using this function will not remove their contents from the library. This protects your library from accidental erasure in case ~~your~~ removable storage device is unplugged.		{{divbox\|yellow\|Removing content from disconnected sources\|If storage media are disconnected, using this function will not remove their contents from the library. This protects your library from accidental erasure in case a removable storage device is unplugged.

	To permanently remove titles from the library:<br>		To permanently remove titles from the library:<br>

LGoosens: Structured markup for clarity

2022-12-15T21:48:27Z

Structured markup for clarity

← Older revision		Revision as of 21:48, 15 December 2022
Line 129:		Line 129:
	\| '''Description:'''		\| '''Description:'''
	\| Check for new music content every time {{kodi}} is started.		\| Check for new music content every time {{kodi}} is started.
	If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media.		{{note\|If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media.<br>
	~~For~~ alternate methods to scan new items into the library...		The linked page gives alternate methods to scan new items into the library.}}
	{{see\|Update Music Library}}		{{see\|Update Music Library}}
	\|}		\|}


	== Hide progress of library updates ==		== Hide progress of library updates ==

LGoosens: Structured markup for clarity

2022-12-15T21:46:48Z

Structured markup for clarity

← Older revision		Revision as of 21:46, 15 December 2022
Line 58:		Line 58:
	\| '''Description:'''		\| '''Description:'''
	\| Check for new video content every time {{kodi}} is started.		\| Check for new video content every time {{kodi}} is started.
	If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media.		{{note\|If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media.<br>
	~~For~~ alternate methods to scan new items into the library...		The linked page gives alternate methods to scan new items into the library.}}
	{{see\|Updating or removing videos}}		{{see\|Updating or removing videos}}
	\|}		\|}


	== Hide progress of library updates ==		== Hide progress of library updates ==

LGoosens: Clarified this (I hope) + structured markup

2022-12-15T21:43:22Z

Clarified this (I hope) + structured markup

← Older revision		Revision as of 21:43, 15 December 2022
Line 83:		Line 83:
	\| '''Description:'''		\| '''Description:'''
	\| Remove items from the library.		\| Remove items from the library.
	Many users misunderstand this function. {{kodi}} has been designed to allow plugging and unplugging of portable hard drives. Due to this, when you run this option your media may not be deleted as expected. This is to ensure a library is not deleted because a USB HDD was unplugged.<br>
	~~Use the correct method of removing titles from the library as detailed in the link below.<br>~~
	~~After correctly deleting from the library ''first'' then run a clean library to purge the database of unnecessary records.~~
	~~: See '''[[Updating_or_removing_videos#Remove_From_Library\|Removing content]]'''~~
	\|}		\|}

			{{divbox\|yellow\|Removing content from disconnected sources\|If storage media are disconnected, using this function will not remove their contents from the library. This protects your library from accidental erasure in case your removable storage device is unplugged.

			To permanently remove titles from the library:<br>
			# Use the correct method of removing titles from the library as detailed in the link below.<br>
			# After correctly deleting from the library first, ''then'' run a clean library to purge the database of unnecessary records.
			See '''[[Updating_or_removing_videos#Remove_From_Library\|Removing content]]'''}}

	== Export library ==		== Export library ==

LGoosens: Structured markup for clarity

2022-12-15T20:36:08Z

Structured markup for clarity

← Older revision		Revision as of 20:36, 15 December 2022
Line 97:		Line 97:
	\|- valign="top"		\|- valign="top"
	\| '''Description:'''		\| '''Description:'''
	\| Export the contents of the video library. Used as a backup of your library or to create a new {{kodi}} installation.		\| Export the contents of the video library. Used as a backup of your library, or to create a new {{kodi}} installation.
	For the Video library, we recommend using the Separate Files method.		{{note\|For the Video library, we recommend using the Separate Files method.}}
	: See '''[[Import-export_library/Video\|Export Video Library]]'''		: See '''[[Import-export_library/Video\|Export Video Library]]'''

	\|}		\|}


	== Import library ==		== Import library ==