Movie artwork: Difference between revisions

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




{{divbox|gold|'''Page under construction. 20 June 2017. To comment or make suggestions, go to [[https://forum.kodi.tv/showthread.php?tid=316985<nowiki>Artwork Forum</nowiki>]]''' }}
<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 video library is very flexible and able to display many types of artwork, but this page will describe the types of artwork readily available for the Movie library of Kodi.<section end="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.  
{{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.


It is important to note the following:
= Movie artwork =


*Artwork is totally skin dependent. This means that some skins display a small number of artwork types, while other skins will display most of the available artwork types.
<gallery mode="packed" widths="350px" heights="200px">
*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.
File:Artwork-FanartView02.jpg|Movie fanart
*The base line for all artwork is the default skin Estuary. By default, Estuary displays the Basic artwork. Estuary can display the Extended artwork via additional add-ons.
File:Artwork-PosterView01.jpg|Movie poster
*While high resolution do look glorious on HDTV's it is important to be aware that the increased artwork size can negatively affect low powered hardware
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>


== Movie "fanart" ==
Fanart is also known as wallpapers, backdrops, or backgrounds.
;{{See also|wikipedia:Fanart|l1=Fanart on Wikipedia}}


= Basic Movie Artwork =
For Kodi they are used as full screen displays to enhance the user experience.
The artwork in the Basic section is the minimum artwork displayed by the default skin Estuary with a standard install.<br />
Note the following:
*The following naming schemes apply '''only''' to the artwork you have manually sourced and saved. It does not apply to the Kodi scraper or any add-on processes


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.


== Fanart ==
== Movie "poster" ==
[[File:Artwork-FanartView02.jpg|400px|right]]
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.
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 posters have a '''recommended resolution of 1000x1500''', with an '''aspect ratio of approximately 1:1.5'''. They do not have transparency.
;{{see also|FanArt}}


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 "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.
The standard resolution of fanart is 1920x1080. But with the rise in popularity of 4k televisions, there is a slow but steady shift to 3840x2160 sized fanart.
 
 
{|
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
| width=200px | '''''Saved movies as'''''
| '''''File Name'''''
| '''''Save Location'''''
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| '''''fanart.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\fanart.jpg/png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''fanart.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\fanart.jpg/png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| '''''<moviename>-fanart.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\Big Buck Bunny (2008)-fanart.jpg/png''
|}


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.


== Poster ==
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.
[[File:Artwork-PosterView01.jpg|400px|right]]


Also known as ''Cover Art'' and ''Folder Image''. The Poster Art used in Kodi replicates the movie posters often seen in cinema complexes.
== Movie "clearart" ==
;{{see also|wikipedia:Poster|l1=Poster on Wikipedia}}
Movie clearart have a transparent background with recognizable characters or props from the movie along with a logo or name.


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


The aspect ration of the poster is 1:1.5 with a resolution of 1000x1500. With the rise in popularity of 4k televisions, there is a slow but steady shift to 2000x3000 sized Posters.  
== 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" ==
|+ '''''How to save your own manually sourced artwork'''''
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.
|- valign="top"
| width=200px | '''''Saved movies as'''''
| '''''File Name'''''
| '''''Save Location'''''
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| '''''poster.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\poster.jpg/png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''poster.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\poster.jpg/png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| '''''<moviename>-poster.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\Big Buck Bunny (2008)-poster.jpg/png''
|}


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.


== Actor Image ==
Movie keyart have a '''recommended resolution of 1000x1500''', with an '''aspect ratio of approximately 1:1.5'''. They do not have transparency.
[[File:Artwork-Actors02.jpg|400px|right]]


The Actor artwork is a portrait of an actor for easy identification. The image is named as follows ''<FirstName>_<LastName>.jpg''
== Movie "thumb" ==
Movie thumbnails are still images from the movie itself, and can be generated from the video file in your library.


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.
Movie thumbnails are often displayed in small boxes and have a '''recommended resolution of about 960x540'''.


The aspect ratio of the Actor Image is 1:1.5 with a normal resolution of 1000x1500. With the rise in popularity of 4k televisions, there is a slow but steady shift to 2000x3000 sized image.
== 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 default name for movie artwork file names is '''<movie file name>-<arttype>.<ext>''' - with some arttype examples listed below and extension matching the image type. There is also a short name "<arttype>.<ext>" that can be used if your movie source folder is configured with [[Adding video sources#Set Content |Movies are in separate folders that match the movie title]], but the long name "<movie file name>-<arttype>.<ext>" still takes precedence. 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}}">
'''''Example naming convention for locally saved movie artwork:'''''
{|
{|
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
|- valign="top"
| width=200px | '''''Saved movies as'''''
| movie file
| '''''File Name'''''
| Blade Runner 2049 (2017).mkv
| '''''Save Location'''''
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017).mkv
|
|
|- valign="top"
| width=100px |'''''Artwork type'''''
| width=200px |'''''File Name'''''
| width=600px |'''''Save name & location example'''''
| width=150px |'''''Recommended resolution'''''
| width=150px |'''''Aspect ratio'''''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|BluRay Structure:}}
| fanart
| '''''<FirstName>_<LastName>.jpg'''''
| fanart.jpg
| eg ''f:MyMovies\Big Buck Bunny (2008)\BDMV\.actors\Amy_Adams.jpg''
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-fanart.jpg<br>f:\Movies\Blade Runner 2049 (2017)\fanart.jpg
| 1920x1080
| 16:9
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|DVD Structure:}}
| poster
| '''''<FirstName>_<LastName>.jpg'''''
| poster.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\.actors\Amy_Adams.jpg''
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-poster.jpg<br>f:\Movies\Blade Runner 2049 (2017)\poster.jpg
| 1000x1500
| approximately 1:1.5
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| banner
| '''''<FirstName>_<LastName>.jpg'''''
| banner.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\.actors\Amy_Adams.jpg''
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-banner.jpg<br>f:\Movies\Blade Runner 2049 (2017)\banner.jpg
| 1000x185
| 1:0.185
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| landscape
| '''''<FirstName>_<LastName>.jpg'''''
| landscape.jpg
| eg ''f:\MyMovies\.actors\Amy_Adams.jpg''
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-landscape.jpg<br>f:\Movies\Blade Runner 2049 (2017)\landscape.jpg
| 1000x562
| 16:9
|- valign="top"
| clearlogo
| clearlogo.png
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearlogo.png<br>f:\Movies\Blade Runner 2049 (2017)\clearlogo.jpg
| 800x310
| 1:0.388
|- valign="top"
| clearart
| clearart.png
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearart.png<br>f:\Movies\Blade Runner 2049 (2017)\clearart.jpg
| 1000x562
| 16:9
|- valign="top"
| keyart
| keyart.jpg
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-keyart.jpg<br>f:\Movies\Blade Runner 2049 (2017)\keyart.jpg
| 1000x1500
| approximately 1:1.5
|- valign="top"
| thumb
| thumb.jpg
| f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-thumb.jpg<br>f:\Movies\Blade Runner 2049 (2017)\thumb.jpg
| 960x540
| match video aspect
|}
|}
</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}}


== Video Folder Artwork ==
== Movie set "fanart" ==
[[File:Artwork-VideoFolder01.jpg|400px|right]]
Fanart is also known as wallpapers, backdrops, or backgrounds.
;{{See also|wikipedia:Fanart|l1=Fanart on Wikipedia}}


The Folder Artwork 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 is located directly within the Source directory.
For Kodi they are used as full screen displays to enhance the user experience.


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


You are able to also apply the folder thumb by modifying the '''\userdata\sources.xml''' as follows
== 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.


<pre><nowiki>
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.
<source>
  <name>Music</name>
  <path>xbms://192.168.1.100:1400/Music/</path>
  <thumbnail>F:\Apps\XBMC\thumbs\shares\thumb.png</thumbnail>
</source>
</nowiki></pre>


The aspect ratio of the folder artwork is the same as per Fanart. As the image will always be a small icon size, you can reduce the resolution.
== 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.
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
| width=200px | '''''Saved movies as'''''
| '''''File Name'''''
| '''''Save Location'''''
|- valign="top"
| width=200px | {{nowrap|Folder Artwork:}}
| '''''folder.jpg'''''
| eg ''f:\MyMovies\folder.jpg''
|- valign="top"
| Alternative name:
| '''''<foldername>.jpg'''''
| eg ''f:\MyMovies\MyMovies.jpg''
|}


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


= Extended Movie Artwork =
== Movie set "clearart" ==
To display the Extended artwork, an add-on will need to be installed to extend the image handling capabilities of Estuary and other skins. Once this is installed, it will insert extra artwork fields in the Estuary Skin. The downloader can then be used to either automatically scrape the extra artwork or, due to the newly available artwork fields, you can manually search and insert your local artwork.
Movie set clearart have a transparent background with recognizable characters or props from the movie set along with its logo or name.
One example is The Artwork Downloader add-on which can be installed from the official Kodi repository.  
; {{see|Add-on:Artwork_Downloader}}


Note the following:
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.
*The following naming schemes apply '''only''' to the artwork you have manually sourced and saved. It does not apply to 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 will ignore your locally saved artwork and will only download from the on-line sources.
**The add-on will ignore movies when more than one movie is in a single directory. Each movie needs to be in it's own separate directory.


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


== Banner ==
Movie set landscape have a '''recommended resolution of 1000x562''' with an '''aspect ratio of 16:9'''. They have no transparency.
[[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.


The Banner uses an aspect ratio of 1:0.185. The standard resolution is 1000x185.
== Movie set "discart" ==
; {{see also|Wide_banner_icons}}
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" ==
|+ '''''How to save your own manually sourced artwork'''''
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.
|- valign="top"
| width=200px | '''''Saved movies as'''''
| '''''File Name'''''
| '''''Save Location'''''
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| '''''banner.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\banner.jpg/png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''banner.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\banner.jpg/png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| ''n/a''
| ''Movie must be in it's own movie directory''
|}


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 ==


== ClearArt ==
Local movie set artwork is not supported in Kodi, but it can be added from online services with an '''"information provider" scraper add-on'''.
[[File:Artwork-ClearArt01.jpg|400px|right]]
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.


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.
= Actor Image =
[[File:Artwork-Actors02.jpg|400px|right]]


The image to the right is displaying ClearArt at the bottom right corner of the image.
The Actor artwork is a portrait of an actor for easy identification. The image is named as follows ''<FirstName>_<LastName>.jpg''


The image has an aspect ratio of 1:0.562 and the normal resolution is 1000x562.
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.


<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 conventions for your own manually sourced artwork:'''''
{|
{|
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
|- valign="top"
| width=200px | '''''Saved movies as'''''
| width=250px |'''''Saved movies as'''''
| '''''File Name'''''
| width=250px |'''''File Name'''''
| '''''Save Location'''''
| width=600px |'''''Save Location'''''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| width=250px |BluRay Structure:
| '''''clearart.png'''''
| width=250px |<FirstName>_<LastName>.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearart.png''
| width=600px |f:MyMovies\Big Buck Bunny (2008)\BDMV\.actors\Amy_Adams.jpg
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| width=250px |DVD Structure:
| '''''clearart.png'''''
| width=250px |<FirstName>_<LastName>.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearart.png''
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\.actors\Amy_Adams.jpg
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| width=250px |Single movie in Directory:
| ''n/a''
| width=250px |<FirstName>_<LastName>.jpg
| ''Movie must be in it's own movie directory''
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\.actors\Amy_Adams.jpg
|- valign="top"
| width=250px |Two or more movies in single Directory:
| width=250px |<FirstName>_<LastName>.jpg
| width=600px |f:\MyMovies\.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 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.


== Clearlogo ==
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.
[[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.
You are able to also apply the folder thumb by modifying the '''\userdata\sources.xml''' as follows


The image on the right is displaying the ClearLogo movie names across the bottom of the image.
<pre><nowiki>
 
<source>
The image has an aspect ratio of 1:0.388 and the normal resolution is 800x310.
  <name>Movie</name>
  <path>xbms://192.168.1.100:1400/Movie/</path>
  <thumbnail>F:\MyMovies\folder.jpg</thumbnail>
</source>
</nowiki></pre>


<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|640x360}}
|}
</div><br />


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming conventions for your own manually sourced artwork:'''''
{|
{|
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
| width=200px | '''''Saved movies as'''''
| '''''File Name'''''
| '''''Save Location'''''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| width=200px |'''''Saved movies as'''''
| '''''clearlogo.png'''''
| width=250px |'''''File Name'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearlogo.png''
| width=600px |'''''Save Location'''''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| width=200px |Folder Artwork:
| '''''clearlogo.png'''''
| width=250px |folder.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearlogo.png''
| width=600px |f:\MyMovies\folder.jpg
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| width=200px |Alternative name:
| ''n/a''
| width=250px |<foldername>.jpg
| ''Movie must be in it's own movie directory''
| width=600px |f:\MyMovies\MyMovies.jpg
|}
|}
</div>


= Experimental movie artwork =


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


== Landscape ==
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.
Landscape used to be an option with some skins and is still a hangover from earlier versions of XBMC. Unfortunately, the removal of the option may affect (and annoy) many users. Landscape is the same as Fanart.
 
 
 
 
 
 
== Thumbnail ==
[[File:Artwork-Thumbs01.jpg|400px|right]]
 
Thumbs and Movie Thumbs are a source of confusion for many people. The term Thumbs tends to convey the impression of a very small and low quality image. This is not the case. Movie thumbs are just smaller versions of Fanart. Most times it is the same image.
 
Thumbs are a setting within Kodi that will produce a thumbnail without access to the web. It takes an image from (n)th time in the video and applies it if there is no poster as an example an episode image. Old versions of XBMC did support thumbnail.jpg instead of poster.jpg in that aspect
 
This is also hangover from earlier days, when computer processing power was not powerful enough to manipulate a high number of images at a very fast rate. These days, thumbs can be ignored, and fanart used in it's place.
 
The image content of the Thumb is the same as for Fanart. The image properties have an aspect ratio is 16:9 with a usual resolution of 1000x562.
 
 
 
 
 
 
= 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.  
 
The aspect ration of the image is 1:1, and the usual resolution is 1000x1000.


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.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Example naming convention for locally saved extrafanart::'''''
{|
{|
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
|- valign="top"
| width=200px | '''''Saved movies as'''''
| width=250px |'''''File Name'''''
| '''''File Name'''''
| width=600px |'''''Save name & location example'''''
| '''''Save Location'''''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| width=250px |fanart0.jpg
| '''''disc.png'''''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart0.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\disc.png''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| width=250px |fanart1.jpg
| '''''disc.png'''''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart1.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\disc.png''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| width=250px |fanart2.jpg
| ''n/a''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart2.jpg
| ''Movie must be in it's own movie directory''
|}
|}
</div>


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


== Logo ==
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.
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 ==
Extra fanart is reliant on a supporting skin.
You are able to download and save additional high quality Fanart which the skin can display, usually in a slideshow.
; {{see also|Extra_Fanart}}
 
 
 
== Movieset Fanart ==
As of v17, Kodi does not automatically recognise and scrape the Movieset Fanart. It needs to be manually selected.
 
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 properties of the movieset fanart are exactly the same as for Fanart.
 
It is possible that this artwork will be included in future versions of Kodi. But at this stage, the artwork needs to be manually applied.
; {{see also|Movie_set}}
 


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Example naming convention for locally saved multiple fanart:'''''
{|
{|
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
|- valign="top"
| width=200px | '''''Saved movies as'''''
| width=300px |'''''Artwork type'''''
| '''''File Name'''''
| width=250px |'''''File Name'''''
| '''''Save Location'''''
| width=600px |'''''Save name & location example'''''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| width=300px |fanart (standard fanart)
| '''''movieset-fanart.jpg/png'''''
| width=250px |fanart.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-fanart.jpg/png''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart.jpg
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| width=300px |fanart1
| '''''movieset-fanart.jpg/png'''''
| width=250px |fanart1.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-fanart.jpg/png''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart1.jpg
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| width=300px |fanart2
| ''n/a''
| width=250px |fanart2.jpg
| ''Movie must be in it's own movie directory''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart2.jpg
|}
|}
</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.


== Movieset Poster ==
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.
As of v17, Kodi does not automatically recognise and scrape the Movieset Poster. It needs to be manually selected.
 
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 properties of the movieset poster are exactly the same as for Poster.
 
It is possible that this artwork will be included in future versions of Kodi. But at this stage, the artwork needs to be manually applied.
; {{see also|Movie_set}}
 


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Example naming convention for locally saved extrathumbs::'''''
{|
{|
|+ '''''How to save your own manually sourced artwork'''''
|- valign="top"
|- valign="top"
| width=200px | '''''Saved movies as'''''
| width=250px |'''''File Name'''''
| '''''File Name'''''
| width=600px |'''''Save name & location example'''''
| '''''Save Location'''''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|BluRay & DVD Structure:}}
| width=250px |fanart0.jpg
| '''''movieset-poster.jpg/png'''''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb0.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| width=250px |fanart1.jpg
| '''''movieset-poster.jpg/png'''''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb1.jpg
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png''
|- valign="top"
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| width=250px |fanart2.jpg
| ''n/a''
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb2.jpg
| ''Movie must be in it's own movie directory''
|}
|}
</div>


{{Top}}




= Obtaining Artwork =
{{updated|18}}
Movie artwork can be obtained using a variety of methods. The most common method is via the Kodi scraper.
[[Category:FAQ]]
 
[[Category:Index]]
 
[[Category:Guides]]
== Scrapers ==
A scraper is a Kodi core function which, in combination with the relevant metadata API add-on, will preform an automatic online search for movie information and then retrieve all relevant metadata and artwork and import it into the Kodi Library. The most common source for movie information is [https://www.themoviedb.org/ The MovieDB]. There are many other sources, but most are specialist listings for foreign language movies, or Disney movies, for example.
 
The entire scraping process is reliant on your local directory and file names being named in accordance with the title listed at the scraper site. To ensure correct naming, simply visit the website, search for your movie, and copy the title from the site and paste into your directory/filename.
 
Kodi will then match the movie and download all relevant metadata and artwork. It is important to note that if you already have correctly named artwork in the movie folder, then Kodi will scrape the local artwork and ignore the online source. Metadata will still be downloaded though.
 
If you subsequently locate artwork that is preferable, it is possible to replace the artwork by calling up the Information page of the movie and selecting ''Choose Art'', then navigating to, and selecting, your preferred artwork.
 
; {{see also|How_To_use_Scrapers}}
; {{see also|Naming_video_files}}
 
 
 
== Manual Search & Save ==
There are three methods to manually search and save your artwork.
 
 
=== Web Search ===
Using an online search engine can help you discover individual artworks, or additional sites where artwork is hosted. When downloading, check that the resolution is of an acceptable standard. Also pay respect to any copyright notices that are attached to the artwork.
 
Once downloaded, they must be named and saved correctly for the artwork to be visible to Kodi.
 
 
=== Kodi- Choose Art ===
From within Kodi, you have the ability to change the default artwork.
 
Simply highlight the Movie whose artwork you want to change. Call up the ''Movie Information'' page, then select ''Choose Art''. From within this page, you will be given the option to select which type of artwork you would like to change. Once selected, you will then be provided with a list of available artworks at the scraper site, or you can navigate to a local or network location.
 
<gallery widths=450px heights=250px>
File:Artwork-ChooseArt01.jpg|Select which type of artwork to change
File:Artwork-ChooseArt02.jpg|List of available remote artworks from the scraper site, as well as the ability to ''Browse'' local and network sources
</gallery>
 
 
=== Media Managers ===
There is a range of software that can create nfo files and download artwork and save them to the correct location and correct naming. They perform the same process and function as what Kodi does natively, but they are unable to update Kodi's library. Rather they create what is known as a '''nfo''' file. This file holds all the metadata for that particular movie. The software will also download associated artwork from the scraper site. Kodi can then read this file and scrape it into the library the next time an ''Update Library'' is performed.
 
Although these programs are quick and easy to use, they are more suited for use where a movie is not listed at the scraper site, as you are able to create the movie metadata from scratch. You would normally use this for, say, Home Movies or other items that are not listed at the scraper site.
 
It is always best to use Kodi for the normal mainstream scrapes and the Media Managers for the non-listed movie scrapes.
; {{see also|nfo}}
 
 
 
== Create Your Own ==
So you are not happy with the artwork the scraper downloaded? And you just can't find that perfect artwork by manually searching the internet. Then, you will just have to create your own. For those who are artistically minded and can easily navigate around image editing software, then you should be able to easily create your very own user-defined artwork on your computer.  Only your imagination is the limit, but be mindful that the artwork needs to remain true to the movie it represents.
 
If you are unsure where to start, the following links may prove useful. Especially if you plan to share your masterpieces. If this is the case, it is best to stick to the posted guidelines.
*Fanart.TV- The premier repository for all things artwork. They have an in-depth guide for artwork requirements
:;''see : [https://fanart.tv/movie-fanart/<nowiki>Fanart.tv- Image Creation Guide</nowiki>]''
*The MovieDB- The go to movie scraper site for Kodi. In addition to metadata, they also hold a large repository of artwork that are created and uploaded to the site by people just like you. They also have artwork creation guides.
:; ''see : [https://www.themoviedb.org/documentation/editing/images<nowiki>themoviedb- Image Creation Guide</nowiki>]''
*IMDB- A comprehensive listing of ensuring artwork is appropriate and suitable.
:; ''see : [https://contribute.imdb.com/updates/guide/images<nowiki>IMDB- Image Submission Guide</nowiki>]''
 
; {{see also|Add-on:The_MovieDB}}
 
 
 
= Managing Artwork =
 
 
 
 
 
 
 
== Online ==
 
== Cache ==
{{Editor note|Current Artwork Cache wiki page too large and comprehensive to incorporate here. Leave as separate page. Update page.}}
 
== Local ==
 
 
 
 
 
https://forum.kodi.tv/showthread.php?tid=315806&pid=2599318#pid2599318
https://forum.kodi.tv/showthread.php?tid=316396&pid=2604751#pid2604751
 
 
{{updated|17}}
 
[[Category:Manual]]
[[Category:Manual]]
[[Category:Index]]
[[Category:Karellen]]
[[Category:Video library]]
[[Category:Video library]]
[[Category:Music library]]
[[Category:First time user]]
[[Category:Advanced topics]]
[[Category:Advanced topics]]
[[Category:Quick Start Guide]]

Revision as of 02:31, 12 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 video library is very flexible and able to display many types of artwork, but this page will describe the types of artwork readily available for the 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.

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 are often displayed in small boxes and have a recommended resolution of about 960x540.

Local movie artwork

Local movie artwork can be saved in the same folder the movie file is saved. The default name for movie artwork file names is <movie file name>-<arttype>.<ext> - with some arttype examples listed below and extension matching the image type. There is also a short name "<arttype>.<ext>" that can be used if your movie source folder is configured with Movies are in separate folders that match the movie title, but the long name "<movie file name>-<arttype>.<ext>" still takes precedence. Movie artwork can also be added from online services with an "information provider" scraper add-on.

Example naming convention for locally saved movie artwork:

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

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