TV-Show artwork: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Error corrections)
No edit summary
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Artwork_Contents}}
{{Artwork_Contents}}
{{mininav|[[Artwork]]}}
{{mininav|[[:Category:Video_library|Video Library Index]] |[[Artwork]]}}




<section begin="intro" />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 TV Show section in Kodi has the impressive ability to display up to 13 types of artwork. This page will describe the different types of artwork available in the TV Show category of Kodi.<section end="intro" />
<section begin="intro" />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 depending on the skin in use.<section end="intro" />


{{red|'''It is important to note the following:'''}}
*Artwork is totally skin dependent. This means that some skins display a small number of artwork types, while other skins will display most or all of the available artwork types.
*In previous versions of Kodi and in older wiki pages, the term Thumbnails was used to describe Artwork. Kodi has now moved away from referring to thumbnails due to the amount of confusion and concern it caused users.
*The base line for all artwork is the default skin Estuary. By default, Estuary displays the Basic artwork.
*While high resolution do look impressive on HDTV's it is important to be aware that the increased artwork size can negatively affect low powered hardware




= Basic TV Show Artwork =
= Scanning & Scraping =
The artwork in the Basic section is the minimum artwork displayed by the default skin Estuary with a standard install.
v18 introduces an '''experimental''' feature that will auto-load extended artwork without the use of additional add-ons. It is considered an advanced feature. Usage and practicality of this feature are being monitored and may change in later releases.


{{red|'''Note the following:'''}}
In the TV Show library, artwork is described as follows:
*The following naming schemes apply '''only''' to the artwork you have manually sourced and saved. It does not apply to artwork downloaded by the Kodi scraper or any add-on processes.


 
{| class="prettytable"
== Banner ==
! colspan="12" style="text-align:left; background-color:#f5f5a1;" | TV Show Artwork
[[File:Artwork-Banner01.jpg|400px|right]]
|-
Also known as Wide Banner Icons. The image to the right shows the Banner view. They are images that normally contain recognisable characters or moments in the show. The banner image normally displays the movie logo which is of a size that is clearly legible. There should be no written advertising of Actors, Studios etc.
! colspan="3" style="text-align:left;" | Basic Artwork
 
! colspan="1" style="text-align:left;" |
 
! colspan="8" style="text-align:left;" | Extended Artwork
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
|-
'''Required file properties:'''<br />
|style="width:80px; text-align:left;"|banner
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
|style="width:80px; text-align:left;"|fanart
{|
|style="width:80px; text-align:left;"|poster
|- valign="top"
! colspan="1" style="text-align:left;" |
| '''''File Type'''''
|style="width:80px; text-align:left;"|characterart
| '''''Aspect Ratio'''''
|style="width:80px; text-align:left;"|clearart
| '''''Resolution- <small>recommended</small>'''''
|style="width:80px; text-align:left;"|clearlogo
|- valign="top"
|style="width:80px; text-align:left;"|discart
| width=150px | {{nowrap|*.jpg or png}}
|style="width:100px; text-align:left;"|fanart''xx'' (extrafanart)
| width=200px | {{nowrap|1:0.185}}
|style="width:80px; text-align:left;"|keyart
| width=200px | {{nowrap|1000x185}}
|style="width:80px; text-align:left;"|landscape
|-
! colspan="12" style="text-align:left; background-color:#f5f5a1;" | Season Artwork
|-
! colspan="3" style="text-align:left;" | Basic Artwork
! colspan="1" style="text-align:left;" |
! colspan="8" style="text-align:left;" | Extended Artwork
|-
|style="width:80px; text-align:left;"|banner
|style="width:80px; text-align:left;"|fanart
|style="width:80px; text-align:left;"|poster
! colspan="1" style="text-align:left;" |
|style="width:80px; text-align:left;"|landscape
|colspan="6"|''<--  Add artwork to advancedsettings.xml as required and supported by skin  -->''
|-
! colspan="12" style="text-align:left; background-color:#f5f5a1;" | Episode Artwork
|-
! colspan="3" style="text-align:left;" | Basic Artwork
! colspan="1" style="text-align:left;" |
! colspan="8" style="text-align:left;" | Extended Artwork
|-
|style="width:80px; text-align:left;"|thumb
|
|
! colspan="1" style="text-align:left;" |
|style="width:80px; text-align:left;"|fanart
|colspan="6"|''<--  Add artwork to advancedsettings.xml as required and supported by skin  -->''
|}
|}
</div><br />


<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''Basic''' artwork requires no special setup as it has always been natively scanned and scraped by {{kodi}}
'''''Naming and Saving conventions for your own manually sourced artwork:'''''


<small>The naming convention for Season banner is '''''season01-banner.jpg''''' where 01 is the season number and '''''season-all-banner.jpg''''' for the All season poster and '''''season-specials-banner.jpg''''' for the Specials season</small>
'''Extended''' artwork required the use of additional add-ons in previous versions. Artwork Downloader (now defunct) was used. More recently '''''[https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]''''' is used.


{|
Users now have the '''option''' of allowing {{kodi}} to load all artwork without add-ons. To use this feature...
|- valign="top"
| width=300px |'''''Saved TV Show Episodes as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |banner.jpg/png
----
| width=600px |f:\TVShows\Dominion\banner.jpg/png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |banner.jpg/png
----
| width=600px |f:\TVShows\Dominion\banner.jpg/png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |banner.jpg/png
| width=600px |f:\TVShows\Dominion\banner.jpg/png
|}
</div>


:'''1.''' Add the below code to the '''[[Advancedsettings.xml| advancedsettings.xml]]''' file, ensuring you do not duplicate any tags if they already exist... eg ''<advancedsettings></advancedsettings>, <videolibrary></videolibrary>''
:'''2a.''' If you have local artwork saved as detailed in the next section, {{Kodi}} will scan this first, otherwise
:'''2b.''' Install the '''[[Add-on:The Movie Database|TheMovieDB- TV Shows Scraper]]''' and ensure the setting to download extra art is enabled.
:'''3.''' Restart {{kodi}} and scan or scrape tv shows as normal.


:'''Note:''' The code box adds common extended artwork that most skins will utilise. It is your choice which extended artwork you add and where (tv show, season, episode). If you add additional to that shown, ensure the skin has support to display it.
<syntaxhighlight lang="xml" line='line'>
<advancedsettings>
<videolibrary>   
      <tvshowextraart>    <!-- Extended artwork for TV Shows -->
        <arttype>characterart</arttype>
        <arttype>clearart</arttype>
        <arttype>clearlogo</arttype>
        <arttype>fanart1</arttype> <!-- Multiple fanart -->
        <arttype>fanart2</arttype> <!-- Add as many as required. -->
        <arttype>fanart3</arttype>
        <arttype>keyart</arttype>
        <arttype>landscape</arttype>
      </tvshowextraart> 
      <tvseasonextraart>  <!-- Extended artwork for Seasons -->
        <arttype>landscape</arttype>
      </tvseasonextraart>   
      <episodeextraart>    <!-- Extended artwork for Episodes -->
        <arttype>fanart</arttype>
      </episodeextraart>
</videolibrary>
</advancedsettings>
</syntaxhighlight>


== Poster- Main ==
[[File:Artwork-PosterView02.jpg|400px|right]]


Also known as ''Cover Art'' and ''Folder Image''. It normally includes the name of the TV Show, along with images of the main character or recognisable scenes from the show.
'''{{red|Note: There is no requirement to use this method. If you find this too complicated, then continue to use Artwork Beef to load extended artwork into {{kodi}}}}'''
;{{see also|wikipedia:Poster|l1=Poster on Wikipedia}}


The image to the right is displaying Poster View of the shows in the Kodi library. They are portrait, high quality images which use a small portion of the screen allowing movie information or other items to be displayed alongside.


<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| width=200px | {{nowrap|1:1.5}}
| width=200px | {{nowrap|1000x1500}}
|}
</div><br />


<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
= Local TV Show Artwork =
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
Local TV show artwork is saved in the top level folder [[Naming_video_files/TV_shows#Recommended|of the TV show]].  
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |poster.jpg/png
----
| width=600px |f:\TVShows\Dominion\poster.jpg/png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |poster.jpg/png
----
| width=600px |f:\TVShows\Dominion\poster.jpg/png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |poster.jpg/png
| width=600px |f:\TVShows\Dominion\poster.jpg/png
|}
</div>


The general rule for TV show artwork file names is '''''<arttype>.<ext>'''''.


This method applies in all cases, whether you use single file videos, dvd folders, bluray folders, episode folders, season folders or any combination of those.


== Poster- Season ==
[[File:Artwork-SeasonPoster01.jpg|400px|right]]


The Season Poster has the same properties as the TV Show Poster. The season poster is used to display each season in the TV Show. The image to the right shows the Shift view in Estuary which displays the available seasons for the selected TV Show.
<gallery mode="packed" widths="1000px" heights="562px">
File:LocalTVShowArtwork01.jpg|'''''TV Show and Season Artwork'''''
</gallery>


<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained<br /></small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| width=200px | {{nowrap|1:1.5}}
| width=200px | {{nowrap|1000x1500}}
|}
</div><br />


<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''


<small>The naming convention for Season posters is '''''season01-poster.jpg''''' where 01 is the season number and '''''season-all-poster.jpg''''' for the All season poster and '''''season-specials-poster.jpg''''' for the Specials season</small>
= Local Season Artwork =


{|
Local Season artwork is saved in the top level folder [[Naming_video_files/TV_shows#Recommended|of the TV show]] alongside the TV Show artwork. There is no conflict as Season artwork is named differently as detailed below.
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |season01-poster.jpg/png
----
| width=600px |f:\TVShows\Dominion\season01-poster.jpg/png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |season01-poster.jpg/png
----
| width=600px |f:\TVShows\Dominion\season01-poster.jpg/png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |season01-poster.jpg/png
| width=600px |f:\TVShows\Dominion\season01-poster.jpg/png
|}
</div>


The general rules for Season artwork file names are
* Standard seasons are named as '''''season<num>-<arttype>.<ext>'''''
* The "specials" season is named as '''''season-specials-<arttype>.<ext>'''''
* The "all" season is named as '''''season-all-<arttype>.<ext>'''''


This method applies in all cases, whether you use single file videos, dvd folders, bluray folders, episode folders, season folders or any combination of those.


== Fanart ==
See previous image for example of correct naming of Season Artwork.
[[File:Artwork-FanartView03.jpg|400px|right]]
Fanart can be defined as images, depicting iconic scenes in a tv show, that have been created by fans. They are also known as Wallpapers or Backdrops.
;{{see also|wikipedia:Fanart|l1=Fanart on Wikipedia}}


For Kodi, it means digital images, of high quality, that are used as full screen displays to enhance the user experience.
;{{see also|FanArt}}


The image to the right is a typical example of a TV Show fanart. It is specifically designed to match the 16:9 ratio of current generation televisions and monitors. This allows the screen to be completely filled by the image.


<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
= Local episode artwork =
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|1920x1080}}
|}
</div><br />


<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
Local episode artwork is saved next to the [[Naming_video_files/TV_shows#TV_Show_Folder|episode file]].
'''''Naming and Saving conventions for your own manually sourced artwork:'''''


<small>The naming convention for Season fanart is '''''season01-fanart.jpg''''' where 01 is the season number and '''''season-all-fanart.jpg''''' for the All season fanart and '''''season-specials-fanart jpg''''' for the Specials season</small>
The general rules for Episode artwork file names are
* Single file episodes (eg .mkv) '''''<episode filename>-<arttype>.<ext>'''''
* DVD and Bluray Folders '''''<arttype>.<ext>'''''


{|
<gallery mode="packed" widths="1000px" heights="562px">
|- valign="top"
File:LocalEpisodeArtwork01.jpg|'''''Episode Artwork'''''
| width=300px |'''''Saved movies as'''''
</gallery>
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |fanart.jpg/png
----
| width=600px |f:\TVShows\Dominion\fanart.jpg/png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |fanart.jpg/png
----
| width=600px |f:\TVShows\Dominion\fanart.jpg/png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |fanart.jpg/png
| width=600px |f:\TVShows\Dominion\fanart.jpg/png
|}
</div>






== Animated Artwork ==
[[File:Artwork-Animated01.gif|right]]
Animated Artwork are image files that contain movement. A creator starts with a static image and adds additional frames (images) to the file, each one slightly different to the previous and next image. The images are saved as a gif file, which is recognised as an animated file.


Kodi has the ability to display animated Fanart and animated Posters. If you have located an animated fanart or poster that you would like to display, simply replace the existing Fanart or Poster artwork using the [[Artwork#Importing.2FScraping_Artwork|Kodi- Choose Art]] procedure.
{{Top}}


To the right is an example of Animated Fanart.


<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.gif}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|1920x1080 --''' for Fanart'''}}
|- valign="top"
| width=150px | {{nowrap|*.gif}}
| width=200px | {{nowrap|1:1.5}}
| width=200px | {{nowrap|1000x1500 --''' for Poster'''}}
|}
</div><br />


<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
{{updated|18}}
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
[[Category:FAQ]]
{|
[[Category:Index]]
|- valign="top"
| width=200px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=200px |See above
| width=250px |See above
| width=600px |Use Naming and Saving conventions as described in Poster and Fanart above:
|}
</div>
 
 
 
== Episode Thumbnail ==
[[File:Artwork-EpisodeThumb01.jpg|400px|right]]
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.<br />
The image to the right shows the episode listing using the Episode Thumb view.
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|1920x1080}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |thumb.jpg
----
| width=600px |f:\TVShows\Dominion\Dominion S01E01\thumb.jpg
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
| width=250px |thumb.jpg
| width=600px |f:\TVShows\Dominion\Dominion S01E01\thumb.jpg
|- valign="top"
| width=300px |''also'':
----
| width=250px |<EpisodeFileName>-thumb.jpg
----
| width=600px |f:\TVShows\Dominion\Dominion S01E01\Dominion S01E01-thumb.jpg
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |<EpisodeFileName>-thumb.jpg
| width=600px |f:\TVShows\Dominion\Dominion S01E01-thumb.jpg
|}
</div>
 
 
 
== Actor Image ==
[[File:Artwork-Actors01.jpg|400px|right]]
 
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.
 
{{Red|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 only line entries at the scraper sites, which means that the actor has no profile page or image attached to them- unless that episode actor is a main cast actor in another tv show listed at the site. 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 once the relevant sites and their API's are updated, it will be possible to link episode actors to their profile pages on IMDB.}}
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg}}
| width=200px | {{nowrap|1:1.5}}
| width=200px | {{nowrap|1000x1500}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
| width=250px |<FirstName>_<LastName>.jpg
| width=600px |f:\TVShows\Dominion\.actors\Amy_Adams.jpg
|- valign="top"
| width=300px |One episode per directory in the TV Show:
| width=250px |<FirstName>_<LastName>.jpg
| width=600px |f:\TVShows\Dominion\.actors\Amy_Adams.jpg
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |<FirstName>_<LastName>.jpg
| width=600px |f:\TVShows\Dominion\.actors\Amy_Adams.jpg
|}
</div>
 
 
 
== Source Folder Artwork ==
[[File:Artwork-VideoFolder01.jpg|400px|right]]
 
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
 
<pre><nowiki>
<source>
  <name>tv show</name>
  <path>xbms://192.168.1.100:1400/tv show/</path>
  <thumbnail>F:\My TV Shows\folder.jpg</thumbnail>
</source>
</nowiki></pre>
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|640x360}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=200px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location'''''
|- valign="top"
| width=200px |Folder Artwork:
| width=250px |folder.jpg
| width=600px |f:\TVShows\folder.jpg
|- valign="top"
| width=200px |Alternative name:
| width=250px |<foldername>.jpg
| width=600px |f:\TVShows\MyMovies.jpg
|}
</div>
 
 
 
= Extended TV Show Artwork =
To display the Extended artwork, you will need to change to a skin that supports the additional types of artwork. Add-ons are available to automate the download and caching of the extended artwork listed below. This is usually downloaded and installed with the skin. If not, you can manually download and install the add-on separately. The downloader can then be used to automatically scrape the extended artwork from either online or local sources. If you do not want to automate the process, it is possible to perform this procedure manually using the [[Artwork#Kodi-_Choose_Art|Kodi- Choose Art]] procedure detailed in the main Artwork page.
 
Two examples are below.
; {{see also|Add-on:Artwork_Downloader}}
:'''''See also: [https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]'''''
 
{{red|'''Note the following:'''}}
*The following naming schemes apply '''only''' to the artwork you have manually sourced and saved. It does not apply to artwork downloaded by the Kodi scraper or any add-on processes.
*If using the Artwork Downloader add-on, it is important to note the following
**The add-on has the option to use local artwork (if correctly named and saved) or online artwork. This can be selected in the settings page of the add-on
**If you have more than one episode in a single directory, the add-on will scrape the online and also the local artwork if correctly named and saved.
**Using the Kodi scraper will not download extended artwork. The artwork downloader is required to be run after the Kodi scrape process. i.e. you are performing two scrapes.
 
 
== ClearArt ==
[[File:Artwork-ClearArt02.jpg|400px|right]]
 
ClearArt are images that are saved on a transparent background. This allows the image to be overlayed on another image or playing video. The images normally include the tv show name or logo, along with an iconic prop or scene from the tv show, or an actors image.
 
The image to the right is displaying ClearArt at the bottom right corner of the image.
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|1:0.562}}
| width=200px | {{nowrap|500*281}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |clearart.png
----
| width=600px |f:\TVShows\Dominion\clearart.png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |clearart.png
----
| width=600px |f:\TVShows\Dominion\clearart.png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |clearart.png
| width=600px |f:\TVShows\Dominion\clearart.png
|}
</div>
 
 
 
== Clearlogo ==
[[File:Artwork-ClearLogo02.jpg|400px|right]]
 
This is the basic tv show logo or name on a transparent background. The logo uses the distinctive font of the tv show and is uncluttered by images from the show or actors. The transparent background allows it to be overlayed on other images or video with minimal impact.
 
The image on the right is displaying the tv show listing using the Logo view in the Aeon Nox skin.
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}  
| width=200px | {{nowrap|1:0.388}}
| width=200px | {{nowrap|400x155}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |clearlogo.png
----
| width=600px |f:\TVShows\Dominion\clearlogo.png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |clearlogo.png
----
| width=600px |f:\TVShows\Dominion\clearlogo.png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |clearlogo.png
| width=600px |f:\TVShows\Dominion\clearlogo.png
|}
</div>
 
 
 
== Character Art ==
[[File:Artwork-CharacterArt01.jpg|400px|right]]
Character Art, also known simply as Character, is an image of the main or prominent character in a tv show. It uses a transparent background in a similar fashion to Clear Logo and Clear Art. There are very few skins that display this artwork.
 
The image to the right displays the Clear Logo and Character Art in the top right corner.
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|800x310}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |characterart.png
----
| width=600px |f:\TVShows\Dominion\characterart.png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |characterart.png
----
| width=600px |f:\TVShows\Dominion\characterart.png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |characterart.png
| width=600px |f:\TVShows\Dominion\characterart.png
|}
</div>
 
 
 
== Landscape ==
[[File:Artwork-Landscape01.jpg|400px|right]]
Landscape, also known as TV Show Thumbs (as distinct from Episode Thumbs), are specially made small fanart images. The main differences between Landscape and Fanart images is that Landscape image contains the tv show logo. They are used in certain page layouts for movie browsing. The original intent of this artwork has blurred over the years so if you have no Landscape images, it is safe to use your Fanart or Extrafanart images.
 
The image to the right displays the Landscape view in Aeon Nox skin.
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|1000x562}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |landscape.jpg
----
| width=600px |f:\TVShows\Dominion\landscape.jpg
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |landscape.jpg
----
| width=600px |f:\TVShows\Dominion\landscape.jpg
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |landscape.jpg
| width=600px |f:\TVShows\Dominion\landscape.jpg
|}
</div>
 
 
 
= Skin Dependent & Other Artwork =
The following artwork requires a skin that supports that type of artwork.
;{{see also|skin}}
:'''''See also: [https://kodi.tv/addons/browse?keyword=&category=1192&author=&sort=title+ASC<nowiki>Add-on Search</nowiki>]'''''
 
 
== Disc ==
[[File:Artwork-DiscArt01.jpg|400px|right]]
 
DiscArt requires the use of a supporting skin. It replicates the picture on the physical DVD and Bluray disc. Although the disc artwork is round, the image itself is square and the disc image is placed on a transparent background.
 
<div style="{{linear-gradient|bottom|#f5f5a1, #a1f5e4}}">
'''Required file properties:'''<br />
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|1:1}}
| width=200px | {{nowrap|1000x1000}}
|}
</div><br />
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |disc.png
----
| width=600px |f:\TVShows\Dominion\disc.png
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |disc.png
----
| width=600px |f:\TVShows\Dominion\disc.png
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |disc.png
| width=600px |f:\TVShows\Dominion\disc.png
|}
</div>
 
 
 
== Logo ==
The Logo has the same qualities and properties as the ClearLogo. These two items can be easily interchanged. Although, there are logo's with a solid background rather than a transparent background and these should not be used to replace the ClearLogo.
 
 
 
== Extra fanart ==
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. These images are not cached, and are directly accessed by the skin.
 
Extra Fanart is stored in a separate Folder named "extrafanart". Create a Folder named '''extrafanart''' in the folder of the TV Show ''(eg f:\TV Shows\Californication\extrafanart)''. Each Extra Fanart must be named ''fanartX.jpg'' where ''X'' is a sequential number starting with 0 ''(fanart0.jpg, fanart1.jpg, fanart2.jpg, etc)''. There is a limit of 10 fanart images allowable. Be aware that some skins utilise less than 10 of the images. The location of the extrafanart Folder is as follows.
 
<div style="{{linear-gradient|top|#f5f5a1, #a1f5e4}}">
'''''Naming and Saving conventions for your own manually sourced Extra Fanart:'''''
{|
|- valign="top"
| width=300px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=300px |BluRay & DVD Structure:
----
| width=250px |fanart0.jpg (0 thru 9)
----
| width=600px |f:\TVShows\Dominion\extrafanart\fanart0.jpg
----
|- valign="top"
| width=300px |One episode per directory in the TV Show:
----
| width=250px |fanart0.jpg (0 thru 9)
----
| width=600px |f:\TVShows\Dominion\extrafanart\fanart0.jpg
----
|- valign="top"
| width=300px |All episodes in TV Show directory:
| width=250px |fanart0.jpg (0 thru 9)
| width=600px |f:\TVShows\Dominion\extrafanart\fanart0.jpg
|}
</div>
 
 
 
 
{{Top}}
 
 
{{updated|17}}
[[Category:Guides]]
[[Category:Guides]]
[[Category:First time user]]
[[Category:FAQ]]
[[Category:Manual]]
[[Category:Manual]]
[[Category:Index]]
[[Category:Karellen]]
[[Category:Video library]]
[[Category:Video library]]
[[Category:First time user]]
[[Category:Advanced topics]]
[[Category:Quick Start Guide]]
[[Category:Quick Start Guide]]
[[Category:Advanced topics]]
[[User:Karellen|Karellen]] ([[User talk:Karellen|talk]]) 01:57, 29 June 2017 (EDT)

Revision as of 20:08, 22 May 2019

Artwork contents

Artwork Main Page



See also:


Return to:

Home icon grey.png   ▶ 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 depending on the skin in use.


Scanning & Scraping

v18 introduces an experimental feature that will auto-load extended artwork without the use of additional add-ons. It is considered an advanced feature. Usage and practicality of this feature are being monitored and may change in later releases.

In the TV Show library, artwork is described as follows:

TV Show Artwork
Basic Artwork Extended Artwork
banner fanart poster characterart clearart clearlogo discart fanartxx (extrafanart) keyart landscape
Season Artwork
Basic Artwork Extended Artwork
banner fanart poster landscape <-- Add artwork to advancedsettings.xml as required and supported by skin -->
Episode Artwork
Basic Artwork Extended Artwork
thumb fanart <-- Add artwork to advancedsettings.xml as required and supported by skin -->

Basic artwork requires no special setup as it has always been natively scanned and scraped by Kodi

Extended artwork required the use of additional add-ons in previous versions. Artwork Downloader (now defunct) was used. More recently Artwork Beef is used.

Users now have the option of allowing Kodi to load all artwork without add-ons. To use this feature...

1. Add the below code to the advancedsettings.xml file, ensuring you do not duplicate any tags if they already exist... eg <advancedsettings></advancedsettings>, <videolibrary></videolibrary>
2a. If you have local artwork saved as detailed in the next section, Kodi will scan this first, otherwise
2b. Install the TheMovieDB- TV Shows Scraper and ensure the setting to download extra art is enabled.
3. Restart Kodi and scan or scrape tv shows as normal.
Note: The code box adds common extended artwork that most skins will utilise. It is your choice which extended artwork you add and where (tv show, season, episode). If you add additional to that shown, ensure the skin has support to display it.
<advancedsettings>
	<videolibrary>    
      <tvshowextraart>     <!-- Extended artwork for TV Shows -->
         <arttype>characterart</arttype>
         <arttype>clearart</arttype>
         <arttype>clearlogo</arttype>
         <arttype>fanart1</arttype> <!-- Multiple fanart -->
         <arttype>fanart2</arttype> <!-- Add as many as required. -->
         <arttype>fanart3</arttype> 
         <arttype>keyart</arttype>
         <arttype>landscape</arttype>
      </tvshowextraart>  
      <tvseasonextraart>   <!-- Extended artwork for Seasons -->
         <arttype>landscape</arttype>
      </tvseasonextraart>    
      <episodeextraart>    <!-- Extended artwork for Episodes -->
         <arttype>fanart</arttype>
      </episodeextraart>
	</videolibrary>
</advancedsettings>


Note: There is no requirement to use this method. If you find this too complicated, then continue to use Artwork Beef to load extended artwork into Kodi


Local TV Show Artwork

Local TV show artwork is saved in the top level folder of the TV show.

The general rule for TV show artwork file names is <arttype>.<ext>.

This method applies in all cases, whether you use single file videos, dvd folders, bluray folders, episode folders, season folders or any combination of those.



Local Season Artwork

Local Season artwork is saved in the top level folder of the TV show alongside the TV Show artwork. There is no conflict as Season artwork is named differently as detailed below.

The general rules for Season artwork file names are

  • Standard seasons are named as season<num>-<arttype>.<ext>
  • The "specials" season is named as season-specials-<arttype>.<ext>
  • The "all" season is named as season-all-<arttype>.<ext>

This method applies in all cases, whether you use single file videos, dvd folders, bluray folders, episode folders, season folders or any combination of those.

See previous image for example of correct naming of Season Artwork.


Local episode artwork

Local episode artwork is saved next to the episode file.

The general rules for Episode artwork file names are

  • Single file episodes (eg .mkv) <episode filename>-<arttype>.<ext>
  • DVD and Bluray Folders <arttype>.<ext>



Return to top