Movie artwork: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (→‎Keyart: fix aspect)
No edit summary
Line 3: Line 3:




<section begin="intro" />Movie artwork are images directly related to a movie, preferably of high quality, that are displayed when viewing the movie entry in the library. The movie section in Kodi has the impressive ability to display up to 14 types of artwork. This page will describe the different types of artwork available in the Movie category of Kodi.<section end="intro" />
<section begin="intro" />Movie artwork are images directly related to a movie or movie collection / set, preferably of high quality, that are displayed when viewing the movie or collection entry in the library. The artwork support in {{Kodi}}'s music 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 Movie library of Kodi.<section end="intro" />


It is important to note the following:
{{red|'''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 '''[[Advancedsettings.xml#Extra artwork| whitelisted in advancedsettings.xml]]''' to be added to the library automatically during scanning and scraping.


*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.
= Movie artwork =
*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


<gallery mode="packed" widths="350px" heights="200px">
File:Artwork-FanartView02.jpg|Movie fanart
File:Artwork-PosterView01.jpg|Movie poster
File:Artwork-Banner02.jpg|Movie banner
File:Artwork-ClearArt01.jpg|Movie clearart
File:Artwork-ClearLogo.jpg|Movie clearlogo
File:Artwork-Thumbs01.jpg|Movie landscape
File:Artwork-DiscArt01.jpg|Movie discart
</gallery>


= Basic Movie Artwork =
== Movie "fanart" ==
The artwork in the Basic section is the minimum artwork displayed by the default skin Estuary with a standard install.<br />
Fanart is also known as wallpapers, backdrops, or backgrounds.
Note the following:
;{{See also|wikipedia:Fanart|l1=Fanart on Wikipedia}}
*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.
*The Aspect Ratios should be respected as the image fields within skins are not adjustable. Using incorrect ratios may lead to stretching, squashing or cropping of your artwork.


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


== Fanart ==
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.
[[File:Artwork-FanartView02.jpg|400px|right]]
Fanart can be defined as images, depicting iconic scenes in a movie, that have been created by fans.  
;{{see also|wikipedia:Fanart|l1=Fanart on Wikipedia}}


For Kodi, it means digital images, of high quality, that are used as full screen backdrops or wallpapers to enhance the user experience.
== Movie "poster" ==
Movie 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 of the movie.


The image to the right is a typical example of Movie 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.  
Movie posters have a '''recommended resolution of 1000x1500''', with an '''aspect ratio of approximately 1:1.5'''. They do not have transparency but do have the movie logo or name on the image.
 
== Movie "banner" ==
Movie banners are wide and short images that contain recognizable characters or props from the movie and typically includes a clearly visible logo or the name of the movie.
 
Movie banners have a '''recommended resolution of 1000x185''' with an '''aspect ratio of 1:0.185'''. They do not have transparency.
 
== Movie "clearlogo" ==
Movie logos typically use the distinctive font associated with the movie and is uncluttered by other images.
 
Movie 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.
 
== Movie "clearart" ==
Movie clearart have a transparent background with recognizable characters or props from the movie along with a logo or name.
 
Movie 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.
 
== Movie "landscape" ==
Landscape images are specially made 16x9 images that contain recognizable characters or props from the movie 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.
 
Movie landscape have a '''recommended resolution of 1000x562''' with an '''aspect ratio of 16:9'''. They have no transparency.
 
== Movie "discart" ==
Movie discart replicates the picture on the physical Blu-ray or other disc. Although the disc artwork is round, the image itself is square and the disc image is placed in the center on a transparent background.
 
Movie discart have a '''recommended resolution of 1000x1000''' with an '''aspect ratio of 1:1 (square)'''. They have a transparent background.
 
== Movie "keyart" ==
Movie 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.
 
Movie keyart have a '''recommended resolution of 1000x1500''', with an '''aspect ratio of approximately 1:1.5'''. They do not have transparency.
 
== Movie "thumb" ==
Movie thumbnails are still images from the movie itself, and can be generated from the video file in your library.
 
Movie thumbnails have a recommended resolution that matches the resolution of the video file.
 
== Local movie artwork ==
 
Local movie artwork can be saved in the same folder the [[Naming_video_files/Movies#Movie_Folder_.26_Filename|movie file]] is saved. The general rule for movie artwork file names is "<arttype>.<ext>" or "<movie file name>-<arttype>.<ext>" - with some arttype examples listed below and extension matching the file type. Movie artwork can also be added from online services with an '''"information provider" scraper add-on'''.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''<br />
'''''Example naming convention for locally saved movie artwork:'''''
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
{|
{|
|- valign="top"
|- valign="top"
| '''''File Type'''''
| width=150px |'''''Artwork type'''''
| '''''Aspect Ratio'''''
| width=150px |'''''File Name'''''
| '''''Resolution- <small>recommended</small>'''''
| width=600px |'''''Save name & location example'''''
| width=150px |'''''Recommended resolution'''''
| width=150px |'''''Aspect ratio'''''
|- valign="top"
| fanart
| fanart.jpg
| f:\Movies\Blade Runner 2049 (2017)\fanart.jpg<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-fanart.jpg
| 1920x1080
| 16:9
|- valign="top"
| poster
| poster.jpg
| f:\Movies\Blade Runner 2049 (2017)\poster.jpg<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-poster.jpg
| 1000x1500
| approximately 1:1.5
|- valign="top"
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| banner
| width=200px | {{nowrap|16:9}}
| banner.jpg
| width=200px | {{nowrap|1920x1080}}
| f:\Movies\Blade Runner 2049 (2017)\banner.jpg<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-banner.jpg
|}
| 1000x185
</div><br />
| 1:0.185
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
|- valign="top"
| width=250px |'''''Saved movies as'''''
| landscape
| width=250px |'''''File Name'''''
| landscape.jpg
| width=600px |'''''Save Location and example'''''
| f:\Movies\Blade Runner 2049 (2017)\landscape.jpg<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-landscape.jpg
| 1000x562
| 16:9
|- valign="top"
|- valign="top"
| width=250px |BluRay & DVD Structure:
| clearlogo
----
| clearlogo.png
| width=250px |fanart.jpg/png
| f:\Movies\Blade Runner 2049 (2017)\clearlogo.png<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearlogo.png
----
| 800x310
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\fanart.jpg/png
| 1:0.388
----
|- valign="top"
|- valign="top"
| width=250px |Single movie in directory:
| clearart
| width=250px |fanart.jpg/png
| clearart.png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\fanart.jpg/png
| f:\Movies\Blade Runner 2049 (2017)\clearart.png<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearart.png
| 1000x562
| 16:9
|- valign="top"
|- valign="top"
| width=250px | '''or''' <small>(default)</small>
| keyart
----
| keyart.jpg
| width=250px |<NameOfVideoFile>-fanart.jpg/png
| f:\Movies\Blade Runner 2049 (2017)\keyart.jpg<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-keyart.jpg
----
| 1000x1500
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\Big Buck Bunny (2008)-fanart.jpg/png
| approximately 1:1.5
----
|- valign="top"
|- valign="top"
| width=250px |Two or more movies in single directory:
| thumb
| width=250px |<NameOfVideoFile>-fanart.jpg/png
| thumb.jpg
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-fanart.jpg/png
| f:\Movies\Blade Runner 2049 (2017)\thumb.jpg<br>h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-thumb.jpg
| 1000x1500
| approximately 1:1.5
|}
|}
</div>
</div>


= Movie set artwork =
Movie collections / sets have the same art types available as movies. Kodi currently does not support adding movie set artwork from the local file system, but it is supported with scrapers.
; {{see also|Movie_sets}}
== Movie set "fanart" ==
Fanart is also known as wallpapers, backdrops, or backgrounds.
;{{See also|wikipedia:Fanart|l1=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.
== Movie set "poster" ==
Movie 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 of the movie set.


Movie set posters have a '''recommended resolution of 1000x1500''', with an '''aspect ratio of approximately 1:1.5'''. They do not have transparency but do have the movie set logo or name on the image.


== Poster ==
== Movie set "banner" ==
[[File:Artwork-PosterView01.jpg|400px|right]]
Movie set banners are wide and short images that contain recognizable characters or props from the movie set and typically includes a clearly visible logo or the name of the movie set.


Also known as ''Cover Art'' and ''Folder Image''. The Poster Art used in Kodi replicates the movie posters often seen in cinema complexes.
Movie set banners have a '''recommended resolution of 1000x185''' with an '''aspect ratio of 1:0.185'''. They do not have transparency.
;{{see also|wikipedia:Poster|l1=Poster on Wikipedia}}


The image to the right is displaying poster images of four movies 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.
== Movie set "clearlogo" ==
Movie set logos typically use the distinctive font associated with the movie set and is uncluttered by other images.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
Movie set 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.
'''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|left|#ffdddd, #ddffdd 50%, #ddddff}}">
== Movie set "clearart" ==
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
Movie set clearart have a transparent background with recognizable characters or props from the movie set along with its logo or name.
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=250px |BluRay & DVD Structure:
----
| width=250px |poster.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\poster.jpg/png
----
|- valign="top"
| width=250px |Single movie in directory:
| width=250px |poster.jpg/png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\poster.jpg/png
|- valign="top"
| width=250px | '''or''' <small>(default)</small>
----
| width=250px |<NameOfVideoFile>-poster.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\Big Buck Bunny (2008)-poster.jpg/png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-poster.jpg/png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-poster.jpg/png
|}
</div>


Movie set 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.


== Movie set "landscape" ==
Landscape images are specially made 16x9 images that contain recognizable characters or props from the movie set 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.


== Animated Artwork ==
Movie set landscape have a '''recommended resolution of 1000x562''' with an '''aspect ratio of 16:9'''. They have no transparency.
[[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.  
== Movie set "discart" ==
Movie set discart replicates the picture on the physical Blu-ray or other disc. Although the disc artwork is round, the image itself is square and the disc image is placed in the center on a transparent background.


To the right is an example of Animated Fanart.
Movie set discart have a '''recommended resolution of 1000x1000''' with an '''aspect ratio of 1:1 (square)'''. They have a transparent background.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
== Movie set "keyart" ==
'''Required file properties:'''<br />
Movie set 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.
<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|left|#ffdddd, #ddffdd 50%, #ddddff}}">
Movie set keyart have a '''recommended resolution of 1000x1500''', with an '''aspect ratio of approximately 1:1.5'''. They do not have transparency.
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- 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>


== Local movie set artwork ==


Local movie set artwork is not supported in Kodi, but it can be added from online services with an '''"information provider" scraper add-on'''.
The add-on [https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef] can add local movie set artwork to your library. [https://forum.kodi.tv/showthread.php?tid=153502 Movie Set Artwork Automator] hasn't been supported for some time, but it is also capable of adding local movie set artwork to your library.


== Actor Image ==
== Actor Image ==
Line 225: Line 234:
|}
|}
</div>
</div>


== Source Folder Artwork ==
== Source Folder Artwork ==
Line 278: Line 285:
</div>
</div>


= Experimental movie artwork =


== "extrafanart" folder ==
{{anchor|Extra Fanart}}


= Extended Movie Artwork =
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.
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]'''''
 
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.
*The Aspect Ratios should be respected as the image fields within skins are not adjustable. Using incorrect ratios may lead to stretching, squashing or cropping of your artwork.
*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 movie in a single directory, the add-on will scrape the online artwork. It will not scrape the local artwork. Each movie must be in its own directory.
**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.
 
 
== Banner ==
[[File:Artwork-Banner02.jpg|400px|right]]
Also known as Wide Banner Icons. The image to the right shows the Movie Banner view on the Aeon Nox skin. They are images that normally contain recognisable characters or moments in the movie. 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.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''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:0.185}}
| width=200px | {{nowrap|1000x185}}
|}
</div><br />
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=250px |BluRay & DVD Structure:
----
| width=250px |banner.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\banner.jpg/png
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |banner.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\banner.jpg/png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-banner.jpg/png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-banner.jpg/png
|}
</div>
 
== ClearArt ==
[[File:Artwork-ClearArt01.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 movie name or logo, along with an iconic prop or scene from the movie, or an actors image.
 
The image to the right is displaying ClearArt at the bottom right corner of the image.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''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|1000x562}}
|}
</div><br />
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=250px |BluRay & DVD Structure:
----
| width=250px |clearart.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\clearart.png
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |clearart.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\clearart.png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-clearart.png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-clearart.png
|}
</div>
 
 
== Clearlogo ==
[[File:Artwork-ClearLogo.jpg|400px|right]]
 
This is the basic movie logo or movie name on a transparent background. The logo uses the movies distinctive font. There are no movie or actor images incorporated into the logo. The transparent background allows it to be overlayed on other images or video with minimal impact. This image is sometimes saved as "logo.png", but "clearlogo.png" is preferred to match the library naming convention.
 
The image on the right is displaying the ClearLogo movie names across the bottom of the image.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''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|800x310}}
|}
</div><br />
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=250px |BluRay & DVD Structure:
----
| width=250px |clearlogo.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\clearlogo.png
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |clearlogo.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\clearlogo.png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-clearlogo.png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-clearlogo.png
|}
</div>
 
 
 
== Landscape ==
[[File:Artwork-Thumbs01.jpg|400px|right]]
Landscape images are specially made small fanart images that contain the movie logo and main cast characters or a memorable movie moment. They are used in certain page layouts for movie browsing. Skins can make passable replacements for media items without one with fanart and the clearlogo.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''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|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=250px |BluRay & DVD Structure:
----
| width=250px |landscape.jpg
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\landscape.jpg
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |landscape.jpg
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\landscape.jpg
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-landscape.jpg
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-landscape.jpg
|}
</div>
 
== Thumb ==
The Thumb is a legacy item and can be omitted  for movies. It is a Poster with the same properties of Posters above. There are some skins that still have provision for it, but if there is no specific thumb.jpg file, the [http://kodi.wiki/index.php?title=Movie_artwork&action=edit#Poster poster] will be used. If you find that your displayed Posters look squashed, you should delete any thumb.* artwork in the movie folder, as it is the wrong aspect ratio for the skin in use.<br />
 
It is still used for TV Show episode images<br />
 
 
 
= 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>]'''''
 


 
Extra Fanart is stored in a separate Folder named "extrafanart". Create a Folder named '''extrafanart''' in the folder of the movie, 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.
== DiscArt ==
[[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. This image is sometimes saved as "disc.png", but "discart.png" is preferred to match the library naming convention.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''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|left|#ffdddd, #ddffdd 50%, #ddddff}}">
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
'''''Example naming convention for locally saved extrafanart::'''''
{|
{|
|- valign="top"
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
| width=600px |'''''Save name & location example'''''
|- valign="top"
|- valign="top"
| width=250px |BluRay & DVD Structure:
| width=250px |fanart0.jpg
----
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart0.jpg
| width=250px |discart.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\discart.png
----
|- valign="top"
|- valign="top"
| width=250px |Single movie in directory:
| width=250px |fanart1.jpg
----
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart1.jpg
| width=250px |discart.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\discart.png
----
|- valign="top"
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |fanart2.jpg
| width=250px |<NameOfVideoFile>-discart.png
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart2.jpg
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-discart.png
|}
|}
</div>
</div>


== Multiple fanart ==


== Keyart ==
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.
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.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''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|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=250px |BluRay & DVD Structure:
----
| width=250px |keyart.jpg
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\keyart.jpg
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |keyart.jpg
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\keyart.jpg
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-keyart.jpg
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-keyart.jpg
|}
</div>
 
== 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 Movie.  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.
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.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced Extra Fanart:'''''
'''''Example naming convention for locally saved multiple fanart:'''''
{|
{|
|- valign="top"
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=300px |'''''Artwork type'''''
| width=250px |'''''File Name'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
| width=600px |'''''Save name & location example'''''
|- valign="top"
| width=250px |BluRay Structure:
----
| width=250px |fanart0.jpg (0 thru 9)
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\BDMV\extrafanart\fanart0.jpg
----
|- valign="top"
|- valign="top"
| width=250px |DVD Structure:
| width=300px |fanart (standard fanart)
----
| width=250px |fanart.jpg
| width=250px |fanart0.jpg (0 thru 9)
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart.jpg
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\extrafanart\fanart0.jpg
----
|- valign="top"
|- valign="top"
| width=250px |Single movie in directory:
| width=300px |fanart1
----
| width=250px |fanart1.jpg
| width=250px |fanart0.jpg (0 thru 9)
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart1.jpg
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\extrafanart\fanart0.jpg
----
|- valign="top"
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=300px |fanart2
| width=250px |Not possible
| width=250px |fanart2.jpg
| width=600px |Each movie requires separate directory
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart2.jpg
|}
|}
</div>
</div>


== "extrathumbs" folder ==
{{anchor|Extra Thumbs}}


 
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 ==
These are extra Poster images. It is possible to download and save additional high quality ''Thumbs'' which the skin can display, usually in rotation on the display page of the movie. Extra Thumbs are reliant on a supporting skin and the images have exactly the same properties as the standard Poster image described above. These images are not cached, and are directly accessed by the skin.


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. The location of the extrathumbs Folder is as follows.
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. The location of the extrathumbs Folder is as follows.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced Extra Thumbs:'''''
'''''Example naming convention for locally saved extrathumbs::'''''
{|
{|
|- valign="top"
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
| width=600px |'''''Save name & location example'''''
|- valign="top"
| width=250px |BluRay Structure:
----
| width=250px |thumb0.jpg (0 thru 9)
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\BDMV\extrathumbs\thumb0.jpg
----
|- valign="top"
| width=250px |DVD Structure:
----
| width=250px |thumb0.jpg (0 thru 9)
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\extrathumbs\thumb0.jpg
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |thumb0.jpg (0 thru 9)
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\extrathumbs\thumb0.jpg
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |Not possible
| width=600px |Each movie requires separate directory
|}
</div>
 
 
 
== Movieset Fanart ==
; {{see also|Movie_sets}}
 
Kodi does not automatically recognise and scrape the Movieset Fanart. It needs to be [[Artwork#Kodi-_Choose_Art|manually selected]]. There are add-ons available that can assist in automating the process of downloading and inserting Movieset Artwork.
:'''''See also: [https://forum.kodi.tv/showthread.php?tid=153502 Movie Set Artwork Automator]'''''
 
:'''''See also: [https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]'''''
 
This artwork is used for movie Collections or Sets. For example, the Superman collection consists of five movies. Kodi has the ability to display these as a Box-Set. When viewing the box-set, rather than displaying a fanart that is associated with only one of the movies, it is preferable to display a fanart image that has a connection to all the movies.
 
The file and image properties of the movieset fanart are exactly the same as for Fanart.
 
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=300px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
| width=250px |BluRay & DVD Structure:
----
| width=300px |movieset-fanart.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\movieset-fanart.jpg/png
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=300px |movieset-fanart.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\movieset-fanart.jpg/png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=300px |<NameOfVideoFile>-movieset-fanart.jpg/png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-movieset-fanart.jpg/png
|}
</div>
 
 
 
== Movieset Poster ==
; {{see also|Movie_sets}}
 
Kodi does not automatically recognise and scrape the Movieset Poster. It needs to be [[Artwork#Kodi-_Choose_Art|manually selected]]. There are add-ons available that can assist in automating the process of downloading and inserting Movieset Artwork.
:'''''See also: [https://forum.kodi.tv/showthread.php?tid=153502 Movie Set Artwork Automator]'''''
:'''''See also: [https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]'''''
 
This artwork is used for movie Collections or Sets. For example, the Superman collection consists of five movies. Kodi has the ability to display these as a Box-Set. When viewing the box-set, rather than displaying a Poster that is associated with only one of the movies, it is preferable to display a Poster image that has a connection to all the movies.
 
The file and image properties of the movieset poster are exactly the same as for Poster.
 
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=300px |'''''File Name'''''
| width=600px |'''''Save Location and example'''''
|- valign="top"
|- valign="top"
| width=250px |BluRay & DVD Structure:
| width=250px |fanart0.jpg
----
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb0.jpg
| width=300px |movieset-poster.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png
----
|- valign="top"
|- valign="top"
| width=250px |Single movie in directory:
| width=250px |fanart1.jpg
----
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb1.jpg
| width=300px |movieset-poster.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png
----
|- valign="top"
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |fanart2.jpg
| width=300px |<NameOfVideoFile>-movieset-poster.jpg/png
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb2.jpg
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-movieset-poster.jpg/png
|}
|}
</div>
</div>


{{Top}}
{{Top}}




{{updated|17}}
{{updated|18}}
[[Category:FAQ]]
[[Category:FAQ]]
[[Category:Index]]
[[Category:Index]]

Revision as of 19:09, 2 February 2019

Artwork contents

Artwork Main Page



See also:


Return to:

Home icon grey.png   ▶ Video Library Index ▶ Artwork ▶ Movie artwork


Movie artwork are images directly related to a movie or movie collection / set, preferably of high quality, that are displayed when viewing the movie or collection entry in the library. The artwork support in Kodi's music 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 Movie 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.

Movie artwork

Movie "fanart"

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

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.

Movie "poster"

Movie 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 of the movie.

Movie posters have a recommended resolution of 1000x1500, with an aspect ratio of approximately 1:1.5. They do not have transparency but do have the movie logo or name on the image.

Movie "banner"

Movie banners are wide and short images that contain recognizable characters or props from the movie and typically includes a clearly visible logo or the name of the movie.

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

Movie "clearlogo"

Movie logos typically use the distinctive font associated with the movie and is uncluttered by other images.

Movie 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.

Movie "clearart"

Movie clearart have a transparent background with recognizable characters or props from the movie along with a logo or name.

Movie 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.

Movie "landscape"

Landscape images are specially made 16x9 images that contain recognizable characters or props from the movie 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.

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

Movie "discart"

Movie discart replicates the picture on the physical Blu-ray or other disc. Although the disc artwork is round, the image itself is square and the disc image is placed in the center on a transparent background.

Movie discart have a recommended resolution of 1000x1000 with an aspect ratio of 1:1 (square). They have a transparent background.

Movie "keyart"

Movie 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.

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

Movie "thumb"

Movie thumbnails are still images from the movie itself, and can be generated from the video file in your library.

Movie thumbnails have a recommended resolution that matches the resolution of the video file.

Local movie artwork

Local movie artwork can be saved in the same folder the movie file is saved. The general rule for movie artwork file names is "<arttype>.<ext>" or "<movie file name>-<arttype>.<ext>" - with some arttype examples listed below and extension matching the file type. Movie artwork can also be added from online services with an "information provider" scraper add-on.

Example naming convention for locally saved movie artwork:

Artwork type File Name Save name & location example Recommended resolution Aspect ratio
fanart fanart.jpg f:\Movies\Blade Runner 2049 (2017)\fanart.jpg
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-fanart.jpg
1920x1080 16:9
poster poster.jpg f:\Movies\Blade Runner 2049 (2017)\poster.jpg
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-poster.jpg
1000x1500 approximately 1:1.5
banner banner.jpg f:\Movies\Blade Runner 2049 (2017)\banner.jpg
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-banner.jpg
1000x185 1:0.185
landscape landscape.jpg f:\Movies\Blade Runner 2049 (2017)\landscape.jpg
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-landscape.jpg
1000x562 16:9
clearlogo clearlogo.png f:\Movies\Blade Runner 2049 (2017)\clearlogo.png
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearlogo.png
800x310 1:0.388
clearart clearart.png f:\Movies\Blade Runner 2049 (2017)\clearart.png
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearart.png
1000x562 16:9
keyart keyart.jpg f:\Movies\Blade Runner 2049 (2017)\keyart.jpg
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-keyart.jpg
1000x1500 approximately 1:1.5
thumb thumb.jpg f:\Movies\Blade Runner 2049 (2017)\thumb.jpg
h:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-thumb.jpg
1000x1500 approximately 1:1.5

Movie set artwork

Movie collections / sets have the same art types available as movies. Kodi currently does not support adding movie set artwork from the local file system, but it is supported with scrapers.

Movie set "fanart"

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

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.

Movie set "poster"

Movie 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 of the movie set.

Movie set posters have a recommended resolution of 1000x1500, with an aspect ratio of approximately 1:1.5. They do not have transparency but do have the movie set logo or name on the image.

Movie set "banner"

Movie set banners are wide and short images that contain recognizable characters or props from the movie set and typically includes a clearly visible logo or the name of the movie set.

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

Movie set "clearlogo"

Movie set logos typically use the distinctive font associated with the movie set and is uncluttered by other images.

Movie set 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.

Movie set "clearart"

Movie set clearart have a transparent background with recognizable characters or props from the movie set along with its logo or name.

Movie set 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.

Movie set "landscape"

Landscape images are specially made 16x9 images that contain recognizable characters or props from the movie set 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.

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

Movie set "discart"

Movie set discart replicates the picture on the physical Blu-ray or other disc. Although the disc artwork is round, the image itself is square and the disc image is placed in the center on a transparent background.

Movie set discart have a recommended resolution of 1000x1000 with an aspect ratio of 1:1 (square). They have a transparent background.

Movie set "keyart"

Movie set 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.

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

Local movie set artwork

Local movie set artwork is not supported in Kodi, but it can be added from online services with an "information provider" scraper add-on. The add-on Artwork Beef can add local movie set artwork to your library. Movie Set Artwork Automator hasn't been supported for some time, but it is also capable of adding local movie set artwork to your library.

Actor Image

Artwork-Actors02.jpg

The Actor artwork is a portrait of an actor for easy identification. The image is named as follows <FirstName>_<LastName>.jpg

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.

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 Structure: <FirstName>_<LastName>.jpg f:MyMovies\Big Buck Bunny (2008)\BDMV\.actors\Amy_Adams.jpg
DVD Structure: <FirstName>_<LastName>.jpg f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\.actors\Amy_Adams.jpg
Single movie in Directory: <FirstName>_<LastName>.jpg f:\MyMovies\Big Buck Bunny (2008)\.actors\Amy_Adams.jpg
Two or more movies in single Directory: <FirstName>_<LastName>.jpg f:\MyMovies\.actors\Amy_Adams.jpg

Source Folder Artwork

Artwork-VideoFolder01.jpg

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 movie sources in the Video menu. You will not see this artwork in the Movies 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 in 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. 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>Movie</name>
   <path>xbms://192.168.1.100:1400/Movie/</path>
   <thumbnail>F:\MyMovies\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:\MyMovies\folder.jpg
Alternative name: <foldername>.jpg f:\MyMovies\MyMovies.jpg

Experimental movie 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 movie, 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:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart0.jpg
fanart1.jpg f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart1.jpg
fanart2.jpg f:\Movies\Blade Runner 2049 (2017)\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:\Movies\Blade Runner 2049 (2017)\fanart.jpg
fanart1 fanart1.jpg f:\Movies\Blade Runner 2049 (2017)\fanart1.jpg
fanart2 fanart2.jpg f:\Movies\Blade Runner 2049 (2017)\fanart2.jpg

"extrathumbs" folder

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. The location of the extrathumbs Folder is as follows.

Example naming convention for locally saved extrathumbs::

File Name Save name & location example
fanart0.jpg f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb0.jpg
fanart1.jpg f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb1.jpg
fanart2.jpg f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb2.jpg
Return to top