Movie artwork: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Confirm File properties)
m (Updated for v20)
(44 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Artwork_Contents}}
{{Artwork_Contents}}
{{mininav|[[Artwork]]}}
{{mininav|[[Video_library|Video Library]] |[[Artwork]]}}


{{Notice/dash|'''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>]]'''}}


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.
= Introduction =
<section begin="intro" />This page details information specific to the movie library.<section end="intro" />


It is important to note the following:
The following artwork types are standard for movies and supported by many skins. For more details see '''[[Artwork types|Artwork Types]]'''


*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.
{| class="prettytable"
*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. Estuary can display the Extended artwork via additional add-ons.
! colspan="10" style="text-align:left;" | Commonly Supported Artwork
*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
|-
 
|style="width:80px; text-align:left;"|banner
 
|style="width:80px; text-align:left;"|clearart
= Basic Movie Artwork =
|style="width:80px; text-align:left;"|clearlogo
The artwork in the Basic section is the minimum artwork displayed by the default skin Estuary with a standard install.<br />
|style="width:80px; text-align:left;"|discart
Note the following:
|style="width:80px; text-align:left;"|fanart
*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
|style="width:100px; text-align:left;"|fanart''x''<br> (extra fanart)
 
|style="width:80px; text-align:left;"|keyart
 
|style="width:80px; text-align:left;"|landscape
== Fanart ==
|style="width:80px; text-align:left;"|poster
[[File:Artwork-FanartView02.jpg|400px|right]]
|style="width:100px; text-align:left;"|poster''x''<br> (extra poster)
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.
;{{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.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|1920x1080}}
|}
</div><br />
 
{|
|+ '''''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''
|}
|}






== Poster ==
= Scraping =
[[File:Artwork-PosterView01.jpg|400px|right]]
The {{kodi}} scrapers can automatically download artwork without any extra effort from the user.


Also known as ''Cover Art'' and ''Folder Image''. The Poster Art used in Kodi replicates the movie posters often seen in cinema complexes.
Artwork settings for the video library are adjusted in the {{kodi}} settings pages here... {{highlight|[[Settings/Media/Videos#Artwork|Settings > Media > Videos > Artwork]]}}
;{{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.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| width=200px | {{nowrap|1:1.5}}
| width=200px | {{nowrap|1000x1500}}
|}
</div><br />


= Local Artwork =
Local movie artwork is saved in the same folder where the '''[[Naming_video_files|movie file]]''' is saved.


{|
The default file name for movie artwork is  '''<movie file name>-<arttype>.<ext>''' - see image below. {{resize|0.8em|(does not apply to DVD and Bluray folders)}}
|+ '''''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:}}
| '''''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''
|}


There is also a short name '''<arttype>.<ext>''' that is used for DVD and Bluray folders. It can also be used for Single Files when the following conditions are met...
#'''[[Naming_video_files/Movies#Movie_Folder|Movie Folders]]''' are used
#'''Movies are in separate folders that match the movie title''' must be '''Enabled''' in the [[Adding_video_sources#Set_Content|Set Content Screen]]
#No corresponding artwork with long format names are present in that movie folder, as these take priority.




== Actor Image ==
<gallery mode="packed" widths="1000px" heights="562px">
[[File:Artwork-Actors02.jpg|400px|right]]
File:LocalMovieArtwork01.jpg|link=|'''''Example of correct use of Movie Folder with artwork, nfo file, trailer and theme.<br> Take not of file naming and location.'''''
 
</gallery>
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.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg}}
| width=200px | {{nowrap|1:1.5}}
| width=200px | {{nowrap|1000x1500}}
|}
</div><br />
 
{|
|+ '''''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 Structure:}}
| '''''<FirstName>_<LastName>.jpg'''''
| eg ''f:MyMovies\Big Buck Bunny (2008)\BDMV\.actors\Amy_Adams.jpg''
|- valign="top"
| width=200px | {{nowrap|DVD Structure:}}
| '''''<FirstName>_<LastName>.jpg'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\.actors\Amy_Adams.jpg''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''<FirstName>_<LastName>.jpg'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\.actors\Amy_Adams.jpg''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| '''''<FirstName>_<LastName>.jpg'''''
| eg ''f:\MyMovies\.actors\Amy_Adams.jpg''
|}
 
 
 
== Video Folder Artwork ==
[[File:Artwork-VideoFolder01.jpg|400px|right]]
 
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.
 
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
 
<pre><nowiki>
<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>
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|640x360}}
|}
</div><br />
 
 
{|
|+ '''''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''
|}
 
 
 
= Extended Movie Artwork =
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.
One example is The Artwork Downloader add-on which can be installed from the official Kodi repository.
; {{see also|Add-on:Artwork_Downloader}}
 
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
*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. To use your own artwork, they will need to be manually applied.
**The add-on will ignore movies when more than one movie is in a single directory. Each movie is required to be in its own separate 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:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| width=200px | {{nowrap|1:0.185}}
| width=200px | {{nowrap|1000x185}}
|}
</div><br />
 
; {{see also|Wide_banner_icons}}
 
 
{|
|+ '''''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:}}
| '''''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''
|}
 
 
 
== 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:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|1:0.562}}
| width=200px | {{nowrap|1000x562}}
|}
</div><br />
 
{|
|+ '''''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:}}
| '''''clearart.png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearart.png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''clearart.png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearart.png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| ''n/a''
| ''Movie must be in it's own movie directory''
|}
 
 
 
== 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.
 
The image on the right is displaying the ClearLogo movie names across the bottom of the image.
 
The file type must be png. The image has an aspect ratio of 1:0.388 and the normal resolution is 800x310.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|1:0.388}}
| width=200px | {{nowrap|800x310}}
|}
</div><br />
 
{|
|+ '''''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:}}
| '''''clearlogo.png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearlogo.png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''clearlogo.png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\clearlogo.png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| ''n/a''
| ''Movie must be in it's own movie directory''
|}
 
 
 
== Landscape ==
[[File:Artwork-Thumbs01.jpg|400px|right]]
Landscape, also known as Movie Thumbs, 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. The original intent of this artwork has blurred over the years so if you have no Landscape images, it is safe to use your Fanart or Extrafanart images.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|1000x562}}
|}
</div><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br /><br />
<br /><br />
 
 
== Thumbnail ==
The Thumbnail is a legacy item and can be left blank for movies.<br />
 
It is still used for TV Show episode images<br />
 
{{note|This item needs updating or correcting}}
 
 
 
= Skin Dependent & Other Artwork =
The following artwork requires a skin that supports that type of artwork.
;{{see also|skin}}
:'''''See also: [https://kodi.tv/addons/browse?keyword=&category=1192&author=&sort=title+ASC<nowiki>Add-on Search</nowiki>]'''''
 
 
 
== Disc ==
[[File:Artwork-DiscArt01.jpg|400px|right]]
 
DiscArt requires the use of a supporting skin. It replicates the picture on the physical DVD and Bluray disc. Although the disc artwork is round, the image itself is square and the disc image is placed on a transparent background.
 
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''Required file properties:'''
{|
|- valign="top"
| '''''File Type'''''
| '''''Aspect Ratio'''''
| '''''Resolution- normal'''''
|- valign="top"
| width=150px | {{nowrap|*.png}}
| width=200px | {{nowrap|1:1}}
| width=200px | {{nowrap|1000x1000}}
|}
</div><br />
 
 
{|
|+ '''''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:}}
| '''''disc.png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\disc.png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''disc.png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\disc.png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| ''n/a''
| ''Movie must be in it's own movie directory''
|}
 
 
 
== Logo ==
The Logo has the same qualities and properties as the ClearLogo. These two items can be easily interchanged. Although, there are logo's with a solid background rather than a transparent background and these should not be used to replace the ClearLogo.
 
 
 
== Extra fanart ==
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}}
 
 
{|
|+ '''''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:}}
| '''''movieset-fanart.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-fanart.jpg/png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''movieset-fanart.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-fanart.jpg/png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| ''n/a''
| ''Movie must be in it's own movie directory''
|}
 
 
 
== Movieset Poster ==
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}}
 
 
{|
|+ '''''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:}}
| '''''movieset-poster.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png''
|- valign="top"
| width=200px | {{nowrap|Single movie in Directory:}}
| '''''movieset-poster.jpg/png'''''
| eg ''f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png''
|- valign="top"
| width=200px | {{nowrap|All movies in single Directory:}}
| ''n/a''
| ''Movie must be in it's own movie directory''
|}




{{highlight|<big>Return to [[Artwork|Artwork Main Page]]</big>|color=#f2e0ce}}




{{updated|17}}
{{top}}
{{updated|20}}


[[Category:Manual]]
[[Category:Karellen]]
[[Category:Index]]
[[Category:Video library]]
[[Category:Video library]]
[[Category:Music library]]
[[Category:Advanced topics]]

Revision as of 00:30, 5 February 2023

Artwork contents

Artwork Main Page



See also:


Return to:

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


Introduction

This page details information specific to the movie library.

The following artwork types are standard for movies and supported by many skins. For more details see Artwork Types

Commonly Supported Artwork
banner clearart clearlogo discart fanart fanartx
(extra fanart)
keyart landscape poster posterx
(extra poster)


Scraping

The Kodi scrapers can automatically download artwork without any extra effort from the user.

Artwork settings for the video library are adjusted in the Kodi settings pages here... Settings > Media > Videos > Artwork


Local Artwork

Local movie artwork is saved in the same folder where the movie file is saved.

The default file name for movie artwork is <movie file name>-<arttype>.<ext> - see image below. (does not apply to DVD and Bluray folders)

There is also a short name <arttype>.<ext> that is used for DVD and Bluray folders. It can also be used for Single Files when the following conditions are met...

  1. Movie Folders are used
  2. Movies are in separate folders that match the movie title must be Enabled in the Set Content Screen
  3. No corresponding artwork with long format names are present in that movie folder, as these take priority.




Return to top