Movie artwork: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (→‎Keyart: fix aspect)
No edit summary
(14 intermediate revisions by 2 users not shown)
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, preferably of high quality that are displayed when viewing the movie entry in the library. The artwork support in {{Kodi}}'s video library is very flexible and able to display many types of artwork depending on the skin in use.<section end="intro" />


It is important to note the following:


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


= Scanning & Scraping =
v18 introduces an '''experimental''' feature that will auto-load extended artwork without the use of additional add-ons. Usage and practicality of this feature is being monitored and may change in later releases.


= Basic Movie Artwork =
In the Movie Library, artwork was traditionally described as follows:
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 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.


 
{| class="prettytable"  
== Fanart ==
|-
[[File:Artwork-FanartView02.jpg|400px|right]]
! colspan="2" style="text-align:left;" | Basic Artwork
Fanart can be defined as images, depicting iconic scenes in a movie, that have been created by fans.
! colspan="1" style="text-align:left; background-color:#ffffff;" |
;{{see also|wikipedia:Fanart|l1=Fanart on Wikipedia}}
! colspan="8" style="text-align:left;" | Extended Artwork
 
|-
For Kodi, it means digital images, of high quality, that are used as full screen backdrops or wallpapers to enhance the user experience.
|style="width:80px; text-align:left;"|fanart
 
|style="width:80px; text-align:left;"|poster
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.
|style="text-align:left; background-color:#ffffff;" |
 
|style="width:80px; text-align:left;"|banner
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
|style="width:80px; text-align:left;"|clearart
'''Required file properties:'''<br />
|style="width:80px; text-align:left;"|clearlogo
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
|style="width:80px; text-align:left;"|discart
{|
|style="width:100px; text-align:left;"|fanart''xx'' (extrafanart)
|- valign="top"
|style="width:80px; text-align:left;"|keyart
| '''''File Type'''''
|style="width:80px; text-align:left;"|landscape
| '''''Aspect Ratio'''''
| '''''Resolution- <small>recommended</small>'''''
|- valign="top"
| width=150px | {{nowrap|*.jpg or png}}
| width=200px | {{nowrap|16:9}}
| width=200px | {{nowrap|1920x1080}}
|}
</div><br />
 
<div style="{{linear-gradient|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 |fanart.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\fanart.jpg/png
----
|- valign="top"
| width=250px |Single movie in directory:
| width=250px |fanart.jpg/png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\fanart.jpg/png
|- valign="top"
| width=250px | '''or''' <small>(default)</small>
----
| width=250px |<NameOfVideoFile>-fanart.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\Big Buck Bunny (2008)-fanart.jpg/png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-fanart.jpg/png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-fanart.jpg/png
|}
</div>
 
 
 
== Poster ==
[[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.
;{{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:'''<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}}">
'''''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 |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>
 
 
 
== Animated Artwork ==
[[File:Artwork-Animated01.gif|right]]
Animated Artwork are image files that contain movement. A creator starts with a static image and adds additional frames (images) to the file, each one slightly different to the previous and next image. The images are saved as a gif file, which is recognised as an animated file.
 
Kodi has the ability to display animated Fanart and animated Posters. If you have located an animated fanart or poster that you would like to display, simply replace the existing Fanart or Poster artwork using the [[Artwork#Importing.2FScraping_Artwork|Kodi- Choose Art]] procedure.
 
To the right is an example of Animated 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|*.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}}">
'''''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>
 
 
 
== Actor Image ==
[[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''
 
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:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location'''''
|- valign="top"
| width=250px |BluRay Structure:
| width=250px |<FirstName>_<LastName>.jpg
| width=600px |f:MyMovies\Big Buck Bunny (2008)\BDMV\.actors\Amy_Adams.jpg
|- valign="top"
| width=250px |DVD Structure:
| width=250px |<FirstName>_<LastName>.jpg
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\.actors\Amy_Adams.jpg
|- valign="top"
| width=250px |Single movie in Directory:
| width=250px |<FirstName>_<LastName>.jpg
| 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.
 
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>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:'''''
{|
|- valign="top"
| width=200px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location'''''
|- valign="top"
| width=200px |Folder Artwork:
| width=250px |folder.jpg
| width=600px |f:\MyMovies\folder.jpg
|- valign="top"
| width=200px |Alternative name:
| width=250px |<foldername>.jpg
| width=600px |f:\MyMovies\MyMovies.jpg
|}
</div>
 
 
 
= Extended Movie Artwork =
To display the Extended artwork, you will need to change to a skin that supports the additional types of artwork. Add-ons are available to automate the download and caching of the extended artwork listed below. This is usually downloaded and installed with the skin. If not, you can manually download and install the add-on separately.  The downloader can then be used to automatically scrape the extended artwork from either online or local sources. If you do not want to automate the process, it is possible to perform this procedure manually using the [[Artwork#Kodi-_Choose_Art|Kodi- Choose Art]] procedure detailed in the main Artwork page.
 
Two examples are below.
; {{see also|Add-on:Artwork_Downloader}}
:'''''See also: [https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]'''''
 
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}}">
'''Basic''' artwork requires no special setup as it has always been natively scanned and scraped by {{kodi}}
'''''Naming and Saving conventions for your own manually sourced artwork:'''''
{|
|- 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>


'''Extended''' artwork required the use of additional add-ons in previous versions. Artwork Downloader (now defunct) was used. More recently '''''[https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef]''''' is used.


== Clearlogo ==
Users now have the '''option''' of allowing {{kodi}} to load all artwork without add-ons. To use this feature...
[[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.
:'''1.''' Add the below code to the '''[[Advancedsettings.xml| advancedsettings.xml]]''' file, ensuring you do not duplicate any tags if they already exist... eg ''<advancedsettings></advancedsettings>, <videolibrary></videolibrary>''
:'''2a.''' Install the '''[[Add-on:Universal_Movie_Scraper|Universal Movie Scraper]]''' and adjust the settings to enable scraping of Extended artwork as they are disabled by default. (see image below code box)
:'''2b.''' If you have local artwork saved as detailed in the next section, {{kodi}} will scan this first and the Universal Movie Scraper is not required.
:'''3.''' Restart {{kodi}} and scan or scrape movies as per usual.  


The image on the right is displaying the ClearLogo movie names across the bottom of the image.
:'''Note:''' The code box below adds common extended artwork that most skins will utilise. It is your choice which extended artwork you add. If you add additional to that shown, ensure the skin has support to display it.
:'''Note:''' The Universal Movie Scraper does not scrape extra fanart (''fanartxx''). Extra fanart must saved as local artwork for Kodi to scan.


<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
<syntaxhighlight lang="xml" line='line'>
'''Required file properties:'''<br />
<advancedsettings>
<small>Note: The resolution may be increased but ensure the aspect ratio is maintained</small>
<videolibrary>
{|
<movieextraart>
|- valign="top"
<arttype>banner</arttype>
| '''''File Type'''''
<arttype>clearart</arttype>
| '''''Aspect Ratio'''''
<arttype>clearlogo</arttype>
| '''''Resolution- <small>recommended</small>'''''
<arttype>discart</arttype>
|- valign="top"
        <arttype>fanart1</arttype> <!-- Multiple fanart -->
| width=150px | {{nowrap|*.png}}
        <arttype>fanart2</arttype> <!-- Add as many as required. -->
| width=200px | {{nowrap|1:0.388}}
        <arttype>fanart3</arttype>
| width=200px | {{nowrap|800x310}}
<arttype>keyart</arttype>
|}
<arttype>landscape</arttype>
</div><br />
</movieextraart>
</videolibrary>
</advancedsettings>
</syntaxhighlight>


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


<gallery mode="packed-overlay" widths="500px" heights="283px">
File:UniversalMovieScraper01.jpg|Enable the Extra Artwork options.
</gallery>




== Landscape ==
'''{{red|Note: There is no requirement to use this method. If you find this too complicated, then continue to use Artwork Beef to load extended artwork into {{kodi}}}}'''
[[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 ==
= Local Artwork =
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 />
Local movie artwork is saved in the same folder where the '''[[Naming_video_files|movie file]]''' is saved.


It is still used for TV Show episode images<br />
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)}}


There is also a short name '''<arttype>.<ext>''' that can be used. Short artwork names can be used and are scanned only 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.




= Skin Dependent & Other Artwork =
<gallery mode="packed" widths="1000px" heights="562px">
The following artwork requires a skin that supports that type of artwork.
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.'''''
;{{see also|skin}}
</gallery>
:'''''See also: [https://kodi.tv/addons/browse?keyword=&category=1192&author=&sort=title+ASC<nowiki>Add-on Search</nowiki>]'''''




== 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}}">
'''''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 |discart.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\discart.png
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |discart.png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\discart.png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |<NameOfVideoFile>-discart.png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-discart.png
|}
</div>
== Keyart ==
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.
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced Extra Fanart:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and 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"
| width=250px |DVD Structure:
----
| width=250px |fanart0.jpg (0 thru 9)
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\VIDEO_TS\extrafanart\fanart0.jpg
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=250px |fanart0.jpg (0 thru 9)
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\extrafanart\fanart0.jpg
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=250px |Not possible
| width=600px |Each movie requires separate directory
|}
</div>
== 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.
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Naming and Saving conventions for your own manually sourced Extra Thumbs:'''''
{|
|- valign="top"
| width=250px |'''''Saved movies as'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save Location and 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"
| width=250px |BluRay & DVD Structure:
----
| width=300px |movieset-poster.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png
----
|- valign="top"
| width=250px |Single movie in directory:
----
| width=300px |movieset-poster.jpg/png
----
| width=600px |f:\MyMovies\Big Buck Bunny (2008)\movieset-poster.jpg/png
----
|- valign="top"
| width=250px |Two or more movies in single directory:
| width=300px |<NameOfVideoFile>-movieset-poster.jpg/png
| width=600px |f:\MyMovies\Big Buck Bunny (2008)-movieset-poster.jpg/png
|}
</div>




Line 773: Line 93:




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

Revision as of 22:49, 10 September 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, preferably of high quality that are displayed when viewing the movie entry in the library. The artwork support in Kodi's video library is very flexible and able to display many types of artwork depending on the skin in use.


Scanning & Scraping

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

In the Movie Library, artwork was traditionally described as follows:

Basic Artwork Extended Artwork
fanart poster banner clearart clearlogo discart fanartxx (extrafanart) keyart landscape

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

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

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

1. Add the below code to the advancedsettings.xml file, ensuring you do not duplicate any tags if they already exist... eg <advancedsettings></advancedsettings>, <videolibrary></videolibrary>
2a. Install the Universal Movie Scraper and adjust the settings to enable scraping of Extended artwork as they are disabled by default. (see image below code box)
2b. If you have local artwork saved as detailed in the next section, Kodi will scan this first and the Universal Movie Scraper is not required.
3. Restart Kodi and scan or scrape movies as per usual.
Note: The code box below adds common extended artwork that most skins will utilise. It is your choice which extended artwork you add. If you add additional to that shown, ensure the skin has support to display it.
Note: The Universal Movie Scraper does not scrape extra fanart (fanartxx). Extra fanart must saved as local artwork for Kodi to scan.
<advancedsettings>
	<videolibrary>
		<movieextraart>
			<arttype>banner</arttype>
			<arttype>clearart</arttype>
			<arttype>clearlogo</arttype>
			<arttype>discart</arttype>
         <arttype>fanart1</arttype> <!-- Multiple fanart -->
         <arttype>fanart2</arttype> <!-- Add as many as required. -->
         <arttype>fanart3</arttype> 
			<arttype>keyart</arttype>
			<arttype>landscape</arttype>
		</movieextraart>
	</videolibrary>
</advancedsettings>



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


Local 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 can be used. Short artwork names can be used and are scanned only 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