TV-Show artwork

Artwork contents
Artwork Main Page Artwork Types Creating Artwork Changing Artwork Album Artwork Artist Artwork Live TV Artwork Movie Artwork Movie Set Artwork Music Video Artwork TV Show Artwork Season Artwork Episode Artwork See also: Artwork Cache JSON-RPC & Skin Access Artwork Dump (v19↑) Artwork Beef (v18↓) Import-export library Return to: Music Library Portal Video Library Portal

Video Library Index

Artwork

TV-Show artwork

TV Show artwork are images directly related to a TV Show, preferably of high quality, that are displayed when viewing the entry in the library. The artwork support in Kodi's video library is very flexible and able to display many types of artwork, but this page will describe the types of artwork readily available for the TV show library of Kodi.

It is important to note the following:

• Artwork is skin dependent. This means that some skins display a small number of artwork types, while other skins will display many different artwork types.
• The default skin, Estuary, displays only a limited selection of artwork. Another skin must be used to see other artwork.
• Each artwork type must be whitelisted in advancedsettings.xml to be added to the library automatically during scanning and scraping.

TV show artwork

• 

  TV show poster

• 

  TV show fanart

• 

  TV show banner

• 

  TV show clearart

• 

  TV show clearlogo

• 

  TV show landscape

• 

  TV show characterart

• 

  Episode thumb

• 

  Episode fanart

TV show "fanart"

Fanart is also known as wallpapers, backdrops, or backgrounds.

See also: Fanart on Wikipedia

For Kodi they are used as full screen displays to enhance the user experience.

Fanart have a recommended resolution of 1920x1080 the display, with a specific aspect ratio of 16:9 to match the ratio of current generation televisions and monitors, which allows the screen to be completely filled by the image. Fanart also does not have transparency and preferably does not have a logo or title on the image.

TV show "poster"

TV show posters replicates the movie posters often seen in cinema complexes, or the front cover of home video releases, and contain a clearly visible logo or name.

TV show posters have a recommended resolution of 1000x1500, with an aspect ratio of approximately 1:1.5. They do not have transparency.

TV show "banner"

TV show banners are wide and short images that contain recognizable characters or props and typically includes a clearly visible logo or the name.

TV show banners have a recommended resolution of 1000x185 with an aspect ratio of 1:0.185. They do not have transparency.

TV show "clearlogo"

TV show logos typically use the distinctive font associated with the TV show and is uncluttered by other images.

TV show logos have a recommended resolution of 800x310 with an aspect ratio of 1:0.388. The transparent background allows it to be overlaid on other images or video with minimal impact.

TV show "clearart"

TV show clearart have a transparent background with recognizable characters or props along with a logo or name.

TV show clearart have a recommended resolution of 1000x562 with an aspect ratio of 16:9. The transparent background allows it to be overlaid on other images or video with minimal impact.

TV show "landscape"

Landscape images are specially made 16x9 images that contain recognizable characters or props and a logo. They are used in certain page layouts for browsing. Skins can make passable replacements for media items without one with fanart and the clearlogo.

TV show landscape have a recommended resolution of 1000x562 with an aspect ratio of 16:9. They have no transparency.

TV show "characterart"

TV show character art is an image of the main or prominent character in a TV show. It uses a transparent background in a similar fashion to clearlogo and clearart.

TV show characterart have a recommended resolution of 800x310 with an aspect ratio of 16:9. They have a transparent background.

TV show "keyart"

TV show keyart is a poster without text or a logo. This is useful as a separate item in a skinner's toolbox as it can be paired with a clearlogo or large text title elsewhere on the window, and without text it is less distracting in the background or half-obscured, similar to fanart.

TV show keyart have a recommended resolution of 1000x1500, with an aspect ratio of approximately 1:1.5. They do not have transparency.

Local TV show artwork

Local TV show artwork can be saved in the top level folder of the TV show. The general rule for TV show artwork file names is "<arttype>.<ext>", with some arttype examples listed below and extension matching the file type. TV show artwork can also be added from online services with an "information provider" scraper add-on.

Example naming convention for locally saved TV show artwork:

Artwork type	File Name	Save name & location example	Recommended resolution	Aspect ratio
fanart	fanart.jpg	f:\TVShows\Angel\fanart.jpg	1920x1080	16:9
poster	poster.jpg	f:\TVShows\Angel\poster.jpg	1000x1500	approximately 1:1.5
banner	banner.jpg	f:\TVShows\Angel\banner.jpg	1000x185	1:0.185
landscape	landscape.jpg	f:\TVShows\Angel\landscape.jpg	1000x562	16:9
clearlogo	clearlogo.png	f:\TVShows\Angel\clearlogo.png	800x310	1:0.388
clearart	clearart.png	f:\TVShows\Angel\clearart.png	1000x562	16:9
characterart	characterart.jpg	f:\TVShows\Angel\characterart.jpg	800x310	approximately 16:9
keyart	keyart.jpg	f:\TVShows\Angel\keyart.jpg	1000x1500	approximately 1:1.5

Season artwork

Season "poster"

Season posters replicates the movie posters often seen in cinema complexes, or the front cover of home video releases, and contain a clearly visible logo or name and season number.

Season posters have a recommended resolution of 1000x1500, with an aspect ratio of approximately 1:1.5. They do not have transparency.

Season "banner"

Season banners are wide and short images that contain recognizable characters or props and typically includes a clearly visible logo or the name and season number.

Season banners have a recommended resolution of 1000x185 with an aspect ratio of 1:0.185. They do not have transparency.

Season "landscape"

Landscape images are specially made 16x9 images that contain recognizable characters or props and a logo and season number. They are used in certain page layouts for browsing. Skins can make passable replacements for media items without one with fanart and season name / number.

Season landscape have a recommended resolution of 1000x562 with an aspect ratio of 16:9. They have no transparency.

Local season artwork

Local Season artwork can be saved in the top level folder of the TV show. The general rule for Season artwork file names is "season<num>-<arttype>.<ext>", with some arttype examples listed below and extension matching the file type - artwork can be saved for the "Specials" season as "season-specials-<arttype>.<ext>" and "season-all-<arttype>.<ext>" for the "All seasons" entry. Season artwork can also be added from online services with an "information provider" scraper add-on.

Example naming convention for locally saved Season artwork:

Artwork type	File Name	Save name & location example	Recommended resolution	Aspect ratio
poster	poster.jpg	f:\TVShows\Angel\season01-poster.jpg f:\TVShows\Angel\season-specials-poster.jpg	1000x1500	approximately 1:1.5
banner	banner.jpg	f:\TVShows\Angel\season01-banner.jpg	1000x185	1:0.185
landscape	landscape.jpg	f:\TVShows\Angel\season01-landscape.jpg	1000x562	16:9

Episode artwork

Episode thumbnail

The Episode Thumbnail is an individual and specific image to a particular episode. It usually is a snapshot of a memorable scene in that particular episode.

These images are often shown in a small box with several on screen at once, so have a recommended resolution of about 960x540.

Episode fanart

The Episode fanart is a high resolution press-shot or capture of a particular episode. It usually is a snapshot of a memorable scene in that particular episode.

Fanart have a recommended resolution of 1920x1080 the display, with a specific aspect ratio of 16:9 to match the ratio of current generation televisions and monitors, which allows the screen to be completely filled by the image.

Local episode artwork

Local episode artwork can be saved next to the episode file. The general rule for episode artwork file names is "<episode filename>-<arttype>.<ext>", with some arttype examples listed below and extension matching the file type. Episode artwork can also be added from online services with an "information provider" scraper add-on.

Example naming convention for locally saved episode artwork:

Artwork type	File Name	Save name & location example	Recommended resolution	Aspect ratio
thumb	thumb.jpg	f:\TVShows\Angel\Angel - 01x01 - City Of-thumb.jpg	960x540	match video resolution
fanart	fanart.jpg	f:\TVShows\Angel\Angel - 01x01 - City Of-fanart.jpg	1920x1080	16:9

Actor Image

The Actor artwork is a portrait of an actor for easy identification.

The image to the right is displaying the Actor images of five actors along the top row. They are portrait, medium to high quality images.

It is important to note the following limitation with actor artwork. Kodi cannot download actor images for every listed actor in the show. This is due to a limitation with the TMDB and TVDB scraper sites. Those sites list only biographical data and images for the main cast actors only. Episode actors (those actors that appear in only one or two episodes) are line entries at the scraper sites, which means that the actor has no profile page or image attached to them.

If that episode actor is a main cast actor in another tv show or movie listed within your Kodi library, then an Actor Image and biographical data will be available for display. When viewing the actors for a tv show in Kodi, it is normal to see missing actor artwork. These limitations are being worked on and should become available when the relevant sites update their API's. For TVDB this should become available when they finalise their v2 API. It will then be possible to link episode actors to their profile pages on IMDB. This is beyond the control of Kodi.

Required file properties:
Note: The resolution may be increased but ensure the aspect ratio is maintained

File Type	Aspect Ratio	Resolution- recommended
*.jpg	1:1.5	1000x1500

Naming conventions for your own manually sourced artwork:

Saved movies as	File Name	Save Location
BluRay & DVD Structure:	<FirstName>_<LastName>.jpg	f:\TVShows\Dominion\.actors\Amy_Adams.jpg
One episode per directory in the TV Show:	<FirstName>_<LastName>.jpg	f:\TVShows\Dominion\.actors\Amy_Adams.jpg
All episodes in TV Show directory:	<FirstName>_<LastName>.jpg	f:\TVShows\Dominion\.actors\Amy_Adams.jpg

Source Folder Artwork

The Folder Artwork, also known as Source Folder thumb, are landscape images that can be used to replace the standard folder icons when browsing your tv show sources in the Video menu. You will not see this artwork in the TV Show menu. This image file is saved directly within the Source directory.

To enable the image, navigate to Videos>Files in the menu system. Highlight a source and call up the Context Menu. Select Choose Thumbnail. If you have saved the image in the correct location, it will be available to select immediately. If not, you will need to navigate to locate and select it. The image must remain in its original location once selected as it will not be cached. Deleting the image will remove it from view in the folder icon.

You are able to also apply the folder thumb by modifying the \userdata\sources.xml as follows

<source>
   <name>tv show</name>
   <path>xbms://192.168.1.100:1400/tv show/</path>
   <thumbnail>F:\My TV Shows\folder.jpg</thumbnail>
</source>

Required file properties:
Note: The resolution may be increased but ensure the aspect ratio is maintained

File Type	Aspect Ratio	Resolution- recommended
*.jpg	16:9	640x360

Naming conventions for your own manually sourced artwork:

Saved movies as	File Name	Save Location
Folder Artwork:	folder.jpg	f:\TVShows\folder.jpg
Alternative name:	<foldername>.jpg	f:\TVShows\MyMovies.jpg

Experimental TV show artwork

"extrafanart" folder

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. This is older and more widely supported in skins.

Extra fanart is stored in a separate Folder named "extrafanart". Create a folder named extrafanart in the folder of the TV show, and place each extra fanart image in it. This artwork is not added to the Kodi library, instead skins list the folder directly; this can wake hard drives while browsing the library. The filename is mostly not important.

Example naming convention for locally saved extrafanart::

File Name	Save name & location example
fanart0.jpg	f:\TVShows\Angel\extrafanart\fanart0.jpg
fanart1.jpg	f:\TVShows\Angel\extrafanart\fanart1.jpg
fanart2.jpg	f:\TVShows\Angel\extrafanart\fanart2.jpg

Multiple fanart

Multiple fanart is an alternative to "extrafanart" that 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.

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. This currently requires more work from skins to display than "extrafanart" and can be awkward to configure because each numbered fanart needs to be added to the artwork whitelist, but the improved performance and behavior that matches other artwork is worth it.

Example naming convention for locally saved multiple fanart:

Artwork type	File Name	Save name & location example
fanart (standard fanart)	fanart.jpg	f:\TVShows\Angel\fanart.jpg
fanart1	fanart1.jpg	f:\TVShows\Angel\fanart1.jpg
fanart2	fanart2.jpg	f:\TVShows\Angel\fanart2.jpg

Return to top

Karellen (talk) 01:57, 29 June 2017 (EDT)