Artwork types - Revision history

Karellen: Update for v22

2026-10-18T08:35:34Z

Update for v22

← Older revision		Revision as of 08:35, 18 October 2026
Line 6:		Line 6:

	= Common Art Types =		= Common Art Types =
	<section begin="intro" />This page describes the common types of artwork used by {{kodi}} skins, scrapers and other art add-ons, where they are used and their specifications. See the linked pages for information on how to use them in {{kodi}}.		<section begin="intro" />This page describes the common types of artwork used by {{kodi}} skins, scrapers and other art add-ons, where they are used, and their specifications. See the linked pages for information on how to use them in {{kodi}}.

	{{highlight\|'''Note:''' All resolutions are suggestions and roughly fall in line with the sizing at the scraper sites. You may modify the resolution to suit your own needs, but the aspect ratio must be maintained otherwise the image may undergo stretching, squashing or cropping when viewed in {{kodi}}. If you intend to share your artwork, check the scraper sites to ensure your artworks are within their minimum and maximum limits.\|color=#f6fb83}}		{{highlight\|'''Note:''' All resolutions are suggestions and roughly fall in line with the sizing at the scraper sites. You may modify the resolution to suit your own needs, but the aspect ratio must be maintained otherwise the image may undergo stretching, squashing or cropping when viewed in {{kodi}}. If you intend to share your artwork, check the scraper sites to ensure your artworks are within their minimum and maximum limits.\|color=#f6fb83}}
Line 308:		Line 308:
	{{highlight\|[[TV-Show artwork]]\|color=#f5f5a1}}		{{highlight\|[[TV-Show artwork]]\|color=#f5f5a1}}

	Landscape images are fanart with text. They are used in certain page layouts for browsing. If the Landscape image is not available, skins can make passable replacements by using fanart and overlaying the clearlogo.		Landscape images are fanart with text. They are used in certain page layouts for browsing. If the Landscape image is not available, some skins can make passable replacements by using fanart and overlaying the clearlogo.

	{\| class="prettytable"		{\| class="prettytable"
Line 494:		Line 494:
	'''Used in:''' {{highlight\|[[Movie artwork]]\|color=#ddddff}}		'''Used in:''' {{highlight\|[[Movie artwork]]\|color=#ddddff}}

	'''Note:''' This image type is no longer supported. The site that hosted the multiple characterart images closed down. Artwork ~~Beef~~ and ~~Artwork Dump~~ do not support this image type. Only one skin (Aeon Tajo) still uses this image, but {{kodi}} can still cache local images if the Type is set in the artwork settings page- {{highlight\|[[Settings/Media/Videos#Artwork\|Settings > Media > Videos > Artwork]]}}		'''Note:''' This image type is no longer supported. The site that hosted the multiple characterart images closed down. Artwork Dump, Skin Info Service and the scrapers do not support this image type. Only one skin (Aeon Tajo) still uses this image, but {{kodi}} can still cache local images if the Type is set in the artwork settings page- {{highlight\|[[Settings/Media/Videos#Artwork\|Settings > Media > Videos > Artwork]]}}

	This is multiple character art for Movies. It has the same concept as character art for TV-Shows described above. In contrast the artwork has no official conventions in terms of resolution and aspect ratio.		This is multiple character art for Movies. It has the same concept as character art for TV-Shows described above. In contrast the artwork has no official conventions in terms of resolution and aspect ratio.
Line 529:		Line 529:
	{{highlight\|[[TV-Show artwork]]\|color=#f5f5a1}}		{{highlight\|[[TV-Show artwork]]\|color=#f5f5a1}}

	This method is ~~slowly being phased out in favour~~ of the ''fanart#'' method described in the previous section		This method is deprecated and none of the skins created for v20 and later support it. Use the ''fanart#'' method described in the previous section.

	<section begin="ExtrafanartFolder" />It is possible to download and save additional high quality fanart which the skin can display, usually in a slideshow. Extra fanart is reliant on a supporting skin and the images have exactly the same properties as the standard fanart described above.		<section begin="ExtrafanartFolder" />It is possible to download and save additional high quality fanart which the skin can display, usually in a slideshow. Extra fanart is reliant on a supporting skin and the images have exactly the same properties as the standard fanart described above.
Line 560:		Line 560:
	{{anchor\|Extra Thumbs}}		{{anchor\|Extra Thumbs}}
	'''Used in:''' {{highlight\|[[Movie artwork]]\|color=#ddddff}}		'''Used in:''' {{highlight\|[[Movie artwork]]\|color=#ddddff}}

			This method is deprecated and none of the skins created for v20 and later support it.

	It is possible to download and save additional thumbnails which the skin can display. Extra thumbs are reliant on a supporting skin and the images have exactly the same properties as the standard thumb described above.		It is possible to download and save additional thumbnails which the skin can display. Extra thumbs are reliant on a supporting skin and the images have exactly the same properties as the standard thumb described above.

	Extra Thumbs are stored in a separate Folder named "extrathumbs". Create a Folder named '''extrathumbs''' in the folder of the Movie. Each Extra Thumb must be named ''thumbX.jpg'' where ''X'' is a sequential number starting with 0 ''(thumb0.jpg, thumb1.jpg, thumb2.jpg, etc)''. There is a limit of 10 thumb images allowable. Be aware that some skins utilise less than 10 of the images.		Extra Thumbs are stored in a separate Folder named "extrathumbs". Create a Folder named '''extrathumbs''' in the folder of the Movie. Each Extra Thumb must be named ''thumbX.jpg'' where ''X'' is a sequential number starting with 0 ''(thumb0.jpg, thumb1.jpg, thumb2.jpg, etc)''. There is a limit of 10 thumb images allowable. Be aware that some skins utilise less than 10 of the images.

	~~This artwork is not in common use.~~


Line 720:		Line 720:

	{{Top}}		{{Top}}
	{{updated\|20}}		{{updated\|22}}

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

Karellen at 20:29, 9 July 2023

2023-07-09T20:29:58Z

← Older revision		Revision as of 20:29, 9 July 2023
Line 403:		Line 403:

	== thumb ==		== thumb ==

	''Thumb'' is the most basic art type (and the oldest historically) used by {{Kodi}} skins. The properties differ depending on the area of {{kodi}} it is being used in. Skins often show this type of art both full size, and also as a small icon alongside each item in a list.		''Thumb'' is the most basic art type (and the oldest historically) used by {{Kodi}} skins. The properties differ depending on the area of {{kodi}} it is being used in. Skins often show this type of art both full size, and also as a small icon alongside each item in a list.


	=== Video Library ===		=== Video Library ===
	~~'''Used in:''' {{highlight\|~~[[~~Movie artwork]]~~\|~~color=#ddddff}}~~		The thumb.jpg image should only be used for [[Artwork/Episode\|episode artwork]]. It should not be used in any other area of the video library.
	~~{{highlight\|[[Movie sets~~ artwork]]~~\|color=#ddffdd}}~~
	~~{{highlight\|[[Music Video artwork]]\|color=#ffc7ff}}~~
	~~{{highlight\|[[TV-Show artwork]]\|color=#f5f5a1}}~~

	~~This art type hold thumbnails that are still images from the movie itself, and can~~ be ~~generated from~~ the video ~~file in your~~ library~~. They are also used as images for episodes in TV Shows.~~

	~~They are normally used as a last option fallback if no other artwork is found~~.

	{\| class="prettytable"		{\| class="prettytable"

Karellen: Updated for v20

2023-02-05T00:16:32Z

Updated for v20

← Older revision		Revision as of 00:16, 5 February 2023
Line 8:		Line 8:
	<section begin="intro" />This page describes the common types of artwork used by {{kodi}} skins, scrapers and other art add-ons, where they are used and their specifications. See the linked pages for information on how to use them in {{kodi}}.		<section begin="intro" />This page describes the common types of artwork used by {{kodi}} skins, scrapers and other art add-ons, where they are used and their specifications. See the linked pages for information on how to use them in {{kodi}}.

	'''Note: '''All resolutions are suggestions and roughly fall in line with the sizing at the scraper sites. You may modify the resolution to suit your own needs, but the aspect ratio must be maintained otherwise the image may undergo stretching, squashing or cropping when viewed in {{kodi}}. If you intend to share your artwork, check the scraper sites to ensure your artworks are within their minimum and maximum limits.		{{highlight\|'''Note:''' All resolutions are suggestions and roughly fall in line with the sizing at the scraper sites. You may modify the resolution to suit your own needs, but the aspect ratio must be maintained otherwise the image may undergo stretching, squashing or cropping when viewed in {{kodi}}. If you intend to share your artwork, check the scraper sites to ensure your artworks are within their minimum and maximum limits.\|color=#f6fb83}}


Line 728:		Line 728:

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

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

Karellen at 02:54, 12 August 2022

2022-08-12T02:54:37Z

← Older revision		Revision as of 02:54, 12 August 2022
Line 329:		Line 329:
	\| No		\| No
	\|}		\|}


			== logo ==
			No longer used.

			Use '''clearlogo.png''' instead

Karellen at 03:54, 23 June 2021

2021-06-23T03:54:32Z

← Older revision		Revision as of 03:54, 23 June 2021
Line 435:		Line 435:
	'''Used in:''' {{highlight\|[[Artwork/Artist\|Music- Artists artwork]]\|color=#72d2f7}}		'''Used in:''' {{highlight\|[[Artwork/Artist\|Music- Artists artwork]]\|color=#72d2f7}}
	{{highlight\|[[Artwork/Album\|Music- Albums artwork]]\|color=#72d2f7}}		{{highlight\|[[Artwork/Album\|Music- Albums artwork]]\|color=#72d2f7}}
	{{highlight\|[[~~Music_artwork~~\|Source Folder Icons]]\|color=#b1d9b6}}		{{highlight\|[[Artwork/Album\|Source Folder Icons]]\|color=#b1d9b6}}

	This art type holds high quality images of the album front cover and square artist images. The artist images usually show the whole band without any text or logos.		This art type holds high quality images of the album front cover and square artist images. The artist images usually show the whole band without any text or logos.

Karellen: Updated for v19

2021-06-23T03:19:02Z

Updated for v19

Show changes

Karellen at 23:21, 5 January 2021

2021-01-05T23:21:50Z

← Older revision		Revision as of 23:21, 5 January 2021
Line 42:		Line 42:
	\|}		\|}


			== Album ==
			See: '''[[Artwork_types#Music_Library\|thumb]]'''


			== Artist ==
			See: '''[[Artwork_types#Music_Library\|thumb]]'''

Rmrector: /* fanart# */ clarify multiple fanart usage

2020-05-03T16:10:27Z

fanart#: clarify multiple fanart usage

← Older revision		Revision as of 16:10, 3 May 2020
Line 292:		Line 292:
	This is Multiple fanart. It has the same specifications as fanart in the previous section.		This is Multiple fanart. It has the same specifications as fanart in the previous section.

	Multiple fanart is an alternative to the "extrafanart" folders~~. Multiple fanart adds~~ all of the fanart images to the Kodi library, and they are treated just like any other artwork type. This is newer and not supported in as many skins as extrafanart, but can be overcome with the use of '''''[https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]'''''.		It is possible to download and save additional high quality fanart which the skin can display, usually in a slideshow. Multiple fanart is reliant on a supporting skin and the images have exactly the same properties as the standard fanart described above. Multiple fanart is an alternative to the "extrafanart" folders, adding all of the fanart images to the Kodi library, and they are treated just like any other artwork type. This is newer and not supported in as many skins as extrafanart, but can be overcome with the use of '''''[https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]'''''.

	Multiple additional fanart is named "fanart1", "fanart2", and so on with the number increasing for each artwork. The number can increase to 10 and beyond, but numbers cannot be zero-padded and each number needs a corresponding whitelist entry in the advancedsettings.xml file. The advantage is improved performance and behavior.		Multiple additional fanart is named "fanart1", "fanart2", and so on with the number increasing for each artwork. The number can increase to 10 and beyond, but numbers cannot be zero-padded and each number needs a corresponding whitelist entry in the advancedsettings.xml file. The advantage is improved performance and behavior.


	== keyart ==		== keyart ==

Rmrector: /* Video Library */

2019-12-14T15:19:03Z

Video Library

← Older revision		Revision as of 15:19, 14 December 2019
Line 422:		Line 422:

	== thumb ==		== thumb ==

			''Thumb'' is the most basic art type (and the oldest historically) used by {{Kodi}} skins. The properties differ depending on the area of {{kodi}} it is being used in. Skins often show this type of art both full size, and also as a small icon alongside each item in a list.

	=== Video Library ===		=== Video Library ===
Line 428:		Line 430:
	{{highlight\|[[Music Video artwork]]\|color=#ffc7ff}}		{{highlight\|[[Music Video artwork]]\|color=#ffc7ff}}
	{{highlight\|[[TV-Show artwork]]\|color=#f5f5a1}}		{{highlight\|[[TV-Show artwork]]\|color=#f5f5a1}}

	''Thumb'' is the most basic art type (and the oldest historically) used by {{Kodi}} skins. The properties differ depending on the area of {{kodi}} it is being used in. Skins often show this type of art both full size, and also as a small icon alongside each item in a list.

	This art type hold thumbnails that are still images from the movie itself, and can be generated from the video file in your library. They are also used as images for episodes in TV Shows.		This art type hold thumbnails that are still images from the movie itself, and can be generated from the video file in your library. They are also used as images for episodes in TV Shows.
Line 452:		Line 452:
	\| No		\| No
	\|}		\|}


	=== Music Library ===		=== Music Library ===

Karellen at 07:37, 21 August 2019

2019-08-21T07:37:56Z

← Older revision		Revision as of 07:37, 21 August 2019
Line 383:		Line 383:
	\| No		\| No
	\|}		\|}


			== poster# - character poster sets ==
			'''Used in:''' {{highlight\|[[Movie artwork]]\|color=#ddddff}}

			This is multiple posters and has the same specifications as Posters above.

			These multiple posters are released as a set which displays the characters of the movie. Each poster in the set highlights one character and there can be up to 20 poster per movie. There can be multiple sets per movie, each set differing in style. Each poster in the set is designed to have a fixed position order, usually because they can be placed edge to edge to create a larger artwork.

			The intention is that they are displayed in a multiimage sideshow. More information and examples can be found [https://forum.kodi.tv/showthread.php?tid=345299 in this thread].


Line 494:		Line 504:
	Kodi's support for displaying animated artwork is basic, and does have some limitations.		Kodi's support for displaying animated artwork is basic, and does have some limitations.

	~~Number one~~ is a hard limit on the number of pixels in a single animated artwork. The size of animated artwork is limited to roughly 12 frames of 1920x1080. This limit is defined as fully decoded pixels. The trend for animated posters is for smaller images with more frames (a recent "animatedposter" is 500x713 with 60 frames). Kodi will discard any remaining frames after it has reached this limit, which will probably hitch unpleasantly, so obeying this limit is important.		;Limitation 1-
	* Technically this limit is 11 frames but Kodi will decode full frames until it has decoded MORE than this, so the calculation is		:{{kodi}} does not save animated artwork to the texture cache and will not play them (only displaying the first frame) unless they are stored on a client-local file system. ie- Animated artwork will not work across networks.
	** 1920 × 1080 = 2,073,600 * 11 =
	~~***~~ 22,809,600 pixels '''plus''' one more frame		;Limitation 2-
			:There is a hard limit on the number of pixels in a single animated artwork. The size of animated artwork is limited to roughly 12 frames of 1920x1080. This limit is defined as fully decoded pixels. The trend for animated posters is for smaller images with more frames (a recent "animatedposter" is 500x713 with 60 frames). Kodi will discard any remaining frames after it has reached this limit, which will probably hitch unpleasantly, so obeying this limit is important.
			::Technically this limit is 11 frames but Kodi will decode full frames until it has decoded MORE than this, so the calculation is
			::1920 × 1080 = 2,073,600 * 11 (frames) = 22,809,600 pixels '''plus''' one more frame


	~~Number two is that Kodi doesn't save animated artwork to the texture cache and will not play them (only displaying the first frame) unless they are stored on a client-local file system.~~

	== extrafanart Folder ==		== extrafanart Folder ==
Line 545:		Line 558:
	This artwork is not in common use.		This artwork is not in common use.


	~~== poster# - character poster sets ==~~
	~~'''Used in:''' {{highlight\|[[Movie artwork]]\|color=#ddddff}}~~

	~~This is multiple posters and has the same specifications as Posters above.~~

	These multiple posters are released as a set which displays the characters of the movie. Each poster in the set highlights one character and there can be up to 20 poster per movie. There can be multiple sets per movie, each set differing in style. Each poster in the set is designed to have a fixed position order, usually because they can be placed edge to edge to create a larger artwork.

	~~The intention is that they are displayed in a multiimage sideshow. More information and examples can be found [https://forum.kodi.tv/showthread.php?tid=345299 in this thread].~~