Artwork/Cache - Revision history

Rmrector: /* Texture optimization */

2025-05-18T17:14:22Z

Texture optimization

← Older revision		Revision as of 17:14, 18 May 2025
Line 45:		Line 45:

	= Texture optimization =		= Texture optimization =
	# ~~Images~~ are limited to a maximum pixel dimension to fit in a 16:9 box, with a default configuration of 1920x1080 for images that are 16:9 (like fanart) and larger than this, and 1280x720 for all other images. This can be changed with '''[[Advancedsettings.xml#Library artwork\| advancedsettings.xml]]'''.		# Cached images are limited to a maximum pixel dimension to fit in a 16:9 box, with a default configuration of 1920x1080 for images that are 16:9 (like fanart) and larger than this, and 1280x720 for all other images. This can be changed with '''[[Advancedsettings.xml#Library artwork\| advancedsettings.xml]]'''.
	#* ~~Images~~ in the GUI ~~will look~~ best by configuring this at or somewhat smaller than images are displayed by your skin and device. Additionally due to final scaling algorithm, a slightly larger image than the display area will look notably worse than a slightly smaller image.		#* Before Kodi 22, images in the GUI looked best by configuring this at or somewhat smaller than images are displayed by your skin and device. Additionally due to final scaling algorithm, a slightly larger image than the display area will look notably worse than a slightly smaller image.
	#* If you are experiencing slow loading images or lagging GUI navigation on low powered equipment and/or your {{Kodi}} device has minimal storage available, these defaults can be lowered to noticeably reduce the cost of artwork. For higher powered equipment these settings can be increased to maintain the original artwork size. (eg 3840x2160 fanart)		#* If you are experiencing slow loading images or lagging GUI navigation on low powered equipment and/or your {{Kodi}} device has minimal storage available, these defaults can be lowered to noticeably reduce the cost of artwork. For higher powered equipment these settings can be increased to maintain the original artwork size. (eg 3840x2160 fanart)
	# Images are re-encoded in a decoder-friendly way so that the image can be displayed as quickly as possible.		# Images are re-encoded in a decoder-friendly way so that the image can be displayed as quickly as possible.

Rmrector: /* Automatic cache cleaner */

2024-07-20T00:39:07Z

Automatic cache cleaner

← Older revision		Revision as of 00:39, 20 July 2024
Line 52:		Line 52:
	This optimized image is exported with {{Kodi}}'s '''[[Import-export_library\|Library Export]]''' feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>		This optimized image is exported with {{Kodi}}'s '''[[Import-export_library\|Library Export]]''' feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>

	= Automatic cache ~~cleaner~~ =		= Automatic cache cleaning =
	{{Kodi}} 22 adds an automatic process to clean out unused images over time - images not associated with an item in the media library nor viewed within the last 30 days. There is also an option in [[Settings/Media/Library]] to immediately remove all such images at once.		{{Kodi}} 22 adds an automatic process to clean out unused images over time - images not associated with an item in the media library nor viewed within the last 30 days. There is also an option in [[Settings/Media/Library]] to immediately remove all such images at once.

Rmrector: /* Texture optimization */

2024-07-20T00:38:31Z

Texture optimization

← Older revision		Revision as of 00:38, 20 July 2024
Line 51:		Line 51:

	This optimized image is exported with {{Kodi}}'s '''[[Import-export_library\|Library Export]]''' feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>		This optimized image is exported with {{Kodi}}'s '''[[Import-export_library\|Library Export]]''' feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>

			= Automatic cache cleaner =
			{{Kodi}} 22 adds an automatic process to clean out unused images over time - images not associated with an item in the media library nor viewed within the last 30 days. There is also an option in [[Settings/Media/Library]] to immediately remove all such images at once.

	= Advanced: How to refresh the cached image of an icon manually =		= Advanced: How to refresh the cached image of an icon manually =

Rmrector: /* Texture optimization */

2024-04-14T22:51:18Z

Texture optimization

← Older revision		Revision as of 22:51, 14 April 2024
Line 46:		Line 46:
	= Texture optimization =		= Texture optimization =
	# Images are limited to a maximum pixel dimension to fit in a 16:9 box, with a default configuration of 1920x1080 for images that are 16:9 (like fanart) and larger than this, and 1280x720 for all other images. This can be changed with '''[[Advancedsettings.xml#Library artwork\| advancedsettings.xml]]'''.		# Images are limited to a maximum pixel dimension to fit in a 16:9 box, with a default configuration of 1920x1080 for images that are 16:9 (like fanart) and larger than this, and 1280x720 for all other images. This can be changed with '''[[Advancedsettings.xml#Library artwork\| advancedsettings.xml]]'''.
			#* Images in the GUI will look best by configuring this at or somewhat smaller than images are displayed by your skin and device. Additionally due to final scaling algorithm, a slightly larger image than the display area will look notably worse than a slightly smaller image.
	#* If you are experiencing slow loading images or lagging GUI navigation on low powered equipment and/or your {{Kodi}} device has minimal storage available, these defaults can be lowered to noticeably reduce the cost of artwork. For higher powered equipment these settings can be increased to maintain the original artwork size. (eg 3840x2160 fanart)		#* If you are experiencing slow loading images or lagging GUI navigation on low powered equipment and/or your {{Kodi}} device has minimal storage available, these defaults can be lowered to noticeably reduce the cost of artwork. For higher powered equipment these settings can be increased to maintain the original artwork size. (eg 3840x2160 fanart)
	# Images are re-encoded in a decoder-friendly way so that the image can be displayed as quickly as possible.		# Images are re-encoded in a decoder-friendly way so that the image can be displayed as quickly as possible.

	This optimized image is exported with {{Kodi}}'s '''[[Import-export_library\|Library Export]]''' feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>		This optimized image is exported with {{Kodi}}'s '''[[Import-export_library\|Library Export]]''' feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>



	= Advanced: How to refresh the cached image of an icon manually =		= Advanced: How to refresh the cached image of an icon manually =

Karellen: Updated for v20

2023-02-05T00:48:04Z

Updated for v20

← Older revision		Revision as of 00:48, 5 February 2023
Line 6:		Line 6:
	<section begin="intro" />{{Kodi}} maintains a texture cache on local device storage for all artwork displayed in the GUI, whether from an online source or the local file system. These textures are optimized and stored locally for faster loading.		<section begin="intro" />{{Kodi}} maintains a texture cache on local device storage for all artwork displayed in the GUI, whether from an online source or the local file system. These textures are optimized and stored locally for faster loading.

	When ~~artwork~~ is added to the library, {{Kodi}} initially only has a URL or path to the artwork. The artwork itself is ~~only~~ downloaded (if from an online source) and then cached ~~when the image is displayed in the GUI or other interface such as the Chorus web interface~~.<section end="intro" />		When media is added to the library, {{Kodi}} initially only has a URL or path to the artwork. The artwork itself is downloaded (if from an online source) and then cached.<section end="intro" />

	All images that {{Kodi}} loads, with the exception of textures that are provided directly by the skin, are cached to the userdata/Thumbnails folder.<br />		All images that {{Kodi}} loads, with the exception of textures that are provided directly by the skin, are cached to the userdata/Thumbnails folder.<br />
Line 89:		Line 89:
	#Restart Kodi		#Restart Kodi
	#Kodi will automatically rebuild the Textures database and repopulate the Thumbnails cache as the images are displayed in the GUI or other Kodi interface.		#Kodi will automatically rebuild the Textures database and repopulate the Thumbnails cache as the images are displayed in the GUI or other Kodi interface.


			{{warning\|Artwork links must be considered as a perishable item. Scraper sites frequently purge thousands of images. As a result, performing this advanced method may result in many images no longer displaying as they are no longer available at the scraper sites.}}


Line 117:		Line 120:

	{{Top}}		{{Top}}
	{{updated\|19}}		{{updated\|20}}

	[[Category:Karellen]]		[[Category:Karellen]]
	[[Category:Music library]]		[[Category:Music library]]
	[[Category:Video library]]		[[Category:Video library]]

Karellen: Updated for v19

2021-06-23T03:48:38Z

Updated for v19

← Older revision		Revision as of 03:48, 23 June 2021
Line 3:		Line 3:


			= Introduction =
	<section begin="intro" />{{Kodi}} maintains a texture cache on local device storage for all artwork displayed in the GUI, whether from an online source or the local file system. These textures are optimized and stored locally for faster loading.		<section begin="intro" />{{Kodi}} maintains a texture cache on local device storage for all artwork displayed in the GUI, whether from an online source or the local file system. These textures are optimized and stored locally for faster loading.

Line 8:		Line 9:

	All images that {{Kodi}} loads, with the exception of textures that are provided directly by the skin, are cached to the userdata/Thumbnails folder.<br />		All images that {{Kodi}} loads, with the exception of textures that are provided directly by the skin, are cached to the userdata/Thumbnails folder.<br />

			'''Note:''' It is not possible to disable the artwork cache and operate exclusively from locally saved artwork as described in the related artwork pages.


Line 25:		Line 28:
	# For local files, another hash of the image is generated based on size and modified date, which can be used to check if the original image has changed.		# For local files, another hash of the image is generated based on size and modified date, which can be used to check if the original image has changed.
	# These details are stored in the SQL database Textures.db, along with information on when the image was cached.		# These details are stored in the SQL database Textures.db, along with information on when the image was cached.



	= Loading textures =		= Loading textures =
Line 40:		Line 45:

	= Texture optimization =		= Texture optimization =
	# Images are limited to a maximum pixel dimension to fit in a 16:9 box, with a default configuration of 1920x1080 for images that are 16:9 (like fanart) and larger than this, and 1280x720 for all other images. This can be changed with ''[[Advancedsettings.xml#Library artwork\| advancedsettings.xml]]''.		# Images are limited to a maximum pixel dimension to fit in a 16:9 box, with a default configuration of 1920x1080 for images that are 16:9 (like fanart) and larger than this, and 1280x720 for all other images. This can be changed with '''[[Advancedsettings.xml#Library artwork\| advancedsettings.xml]]'''.
	#* If you are experiencing slow loading images or lagging GUI navigation on low powered equipment and/or your {{Kodi}} device has minimal storage available, these defaults can be lowered to noticeably reduce the cost of artwork. For higher powered equipment these settings can be increased to maintain the original artwork size. (eg 3840x2160 fanart)		#* If you are experiencing slow loading images or lagging GUI navigation on low powered equipment and/or your {{Kodi}} device has minimal storage available, these defaults can be lowered to noticeably reduce the cost of artwork. For higher powered equipment these settings can be increased to maintain the original artwork size. (eg 3840x2160 fanart)
	# Images are re-encoded in a decoder-friendly way so that the image can be displayed as quickly as possible.		# Images are re-encoded in a decoder-friendly way so that the image can be displayed as quickly as possible.

	This optimized image is exported with {{Kodi}}'s [[Import-export_library\|Library Export]] feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>		This optimized image is exported with {{Kodi}}'s '''[[Import-export_library\|Library Export]]''' feature, rather than the original full-quality image, so it is best to avoid exporting artwork if at all possible.<ref>https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318</ref>


Line 66:		Line 71:

	'''''See also: [[Databases#Database_Versions\|Database Versions]]'''''		'''''See also: [[Databases#Database_Versions\|Database Versions]]'''''



	= Advanced: delete textures13.db =		= Advanced: delete textures13.db =
Line 110:		Line 117:

	{{Top}}		{{Top}}
			{{updated\|19}}

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

Rmrector: /* The caching procedure */ only local files are checked for changes

2021-01-24T18:15:53Z

The caching procedure: only local files are checked for changes

← Older revision		Revision as of 18:15, 24 January 2021
Line 23:		Line 23:
	# {{Kodi}} generates a hash (CRC) of the URL, like "6a643bff".		# {{Kodi}} generates a hash (CRC) of the URL, like "6a643bff".
	# The texture is optimized (see [[#Texture optimization]]) and cached to a device-local file with the given URL hash. It is cached as a PNG if transparency is required and JPG otherwise.		# The texture is optimized (see [[#Texture optimization]]) and cached to a device-local file with the given URL hash. It is cached as a PNG if transparency is required and JPG otherwise.
	# ~~Another~~ hash of the image is generated based on size and modified date, which can be used to check if the original image has changed.		# For local files, another hash of the image is generated based on size and modified date, which can be used to check if the original image has changed.
	# These details are stored in the SQL database Textures.db, along with information on when the image was cached.		# These details are stored in the SQL database Textures.db, along with information on when the image was cached.



	= Loading textures =		= Loading textures =

ThumbOne: /* Advanced: How to refresh the cached image of an icon manually */ Fixing erroneous references to .xbmc (now .kodi)

2020-07-04T01:03:23Z

Advanced: How to refresh the cached image of an icon manually: Fixing erroneous references to .xbmc (now .kodi)

Karellen at 08:14, 26 May 2019

2019-05-26T08:14:38Z

Show changes

Rmrector: /* Kodi version updates */

2019-02-02T03:38:14Z

Kodi version updates

← Older revision		Revision as of 03:38, 2 February 2019
Line 85:		Line 85:
	== Kodi version updates ==		== Kodi version updates ==

	{{~~#lst~~:~~Artwork~~\|~~CacheMaxResolution~~}}		<section begin="CacheMaxResolution" />{{red\|'''Note:''' The maximum resolution currently available for cached artwork is 1920x1080, regardless of any ''advancedsettings.xml'' entries. The only known workaround requires you to manually locate the existing cached artwork, delete it and replace it with the higher resolution image, ensuring the new image is named exactly as the former image was.}}

			{{green\|'''Note:''' In v18, the 1920x1080 limitation has been removed. Using <imageres>9999</imageres> and <fanartres>9999</fanartres> will allow caching artwork at original size. See: https://github.com/xbmc/xbmc/pull/13599}}
			<section end="CacheMaxResolution" />

	{{updated\|18}}		{{updated\|18}}
	[[Category:Advanced topics]]		[[Category:Advanced topics]]
	[[Category:Manual]]		[[Category:Manual]]

← Older revision		Revision as of 01:03, 4 July 2020
Line 52:		Line 52:
	= Advanced: How to refresh the cached image of an icon manually =		= Advanced: How to refresh the cached image of an icon manually =
	The [[Texture Cache Maintenance utility]] can do this in a safer way, but this is the manual option.		The [[Texture Cache Maintenance utility]] can do this in a safer way, but this is the manual option.
	There is an image like ''/home/x/.~~xbmc~~/addons/my.lovely.addon/icon.png'' . After changing that file, the old image is still visible in {{kodi}}. To solve this we need to remove the actual thumbnail file from the filesystem and its reference in the DB:		There is an image like ''/home/x/.kodi/addons/my.lovely.addon/icon.png'' . After changing that file, the old image is still visible in {{kodi}}. To solve this we need to remove the actual thumbnail file from the filesystem and its reference in the DB:

	# Get the thumbnail path to remove the file from the filesystem		# Get the thumbnail path to remove the file from the filesystem
	$ sqlite3 .~~xbmc~~/userdata/Database/Textures13.db "SELECT cachedurl FROM texture WHERE url = '/home/x/.~~xbmc~~/addons/my.lovely.addon/icon.png';"		$ sqlite3 .kodi/userdata/Database/Textures13.db "SELECT cachedurl FROM texture WHERE url = '/home/x/.kodi/addons/my.lovely.addon/icon.png';"
	6/6a643bff.png		6/6a643bff.png

	This ''6/6a643bff.png'' is the cached image under ''/home/x/.~~xbmc~~/userdata/Thumbnails''. So: you need to remove from your filesystem ''/home/x/.~~xbmc~~/userdata/Thumbnails/6/6a43bff.png''		This ''6/6a643bff.png'' is the cached image under ''/home/x/.kodi/userdata/Thumbnails''. So: you need to remove from your filesystem ''/home/x/.kodi/userdata/Thumbnails/6/6a43bff.png''

	# Remove the image->cached image link in the DB		# Remove the image->cached image link in the DB
	$ sqlite3 .~~xbmc~~/userdata/Database/Textures13.db "DELETE FROM texture WHERE url = '/home/x/.~~xbmc~~/addons/my.lovely.addon/icon.png';"		$ sqlite3 .kodi/userdata/Database/Textures13.db "DELETE FROM texture WHERE url = '/home/x/.kodi/addons/my.lovely.addon/icon.png';"

	Next time Kodi needs the image, it will recreate the thumbnail.		Next time Kodi needs the image, it will recreate the thumbnail.
Line 68:		Line 68:

	'''''See also: [[Databases#Database_Versions\|Database Versions]]'''''		'''''See also: [[Databases#Database_Versions\|Database Versions]]'''''



	= Advanced: delete textures13.db =		= Advanced: delete textures13.db =