Difference between revisions of "Movie artwork"

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




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


{{red|'''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 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.


= Movie artwork =
{| class="prettytable"
 
|-
<gallery mode="packed" widths="350px" heights="200px">
! colspan="10" style="text-align:left;" | Commonly Supported Artwork
File:Artwork-FanartView02.jpg|Movie fanart
|-
File:Artwork-PosterView01.jpg|Movie poster
|style="width:80px; text-align:left;"|banner
File:Artwork-Banner02.jpg|Movie banner
|style="width:80px; text-align:left;"|clearart
File:Artwork-ClearArt01.jpg|Movie clearart
|style="width:80px; text-align:left;"|clearlogo
File:Artwork-ClearLogo.jpg|Movie clearlogo
|style="width:80px; text-align:left;"|discart
File:Artwork-Thumbs01.jpg|Movie landscape
|style="width:80px; text-align:left;"|fanart
File:Artwork-DiscArt01.jpg|Movie discart
|style="width:100px; text-align:left;"|fanart''x''<br> (extra fanart)
</gallery>
|style="width:80px; text-align:left;"|keyart
 
|style="width:80px; text-align:left;"|landscape
== Movie "fanart" ==
|style="width:80px; text-align:left;"|poster
Fanart is also known as wallpapers, backdrops, or backgrounds.
|style="width:100px; text-align:left;"|poster''x''<br> (extra poster)
;{{See also|wikipedia:Fanart|l1=Fanart on Wikipedia}}
 
For Kodi they are used as full screen displays to enhance the user experience.
 
Fanart have a '''recommended resolution of 1920x1080''' the display, with a specific '''aspect ratio of 16:9''' to match the ratio of current generation televisions and monitors, which allows the screen to be completely filled by the image. Fanart also does not have transparency and preferably does not have a logo or title on the image.
 
== Movie "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 [[Naming_video_files/Movies#Movie_Folder_.26_Filename|movie file]] is saved. The general rule for movie artwork file names is "<arttype>.<ext>" or "<movie file name>-<arttype>.<ext>" - with some arttype examples listed below and extension matching the file type. The short name can only 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]]'''. 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:'''''
{|
|- valign="top"
| width=150px |'''''Artwork type'''''
| width=150px |'''''File Name'''''
| width=600px |'''''Save name & location example'''''
| width=150px |'''''Recommended resolution'''''
| width=150px |'''''Aspect ratio'''''
|- valign="top"
| fanart
| fanart.jpg
| f:\Movies\Blade Runner 2049 (2017)\fanart.jpg<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-fanart.jpg
| 1920x1080
| 16:9
|- valign="top"
| poster
| poster.jpg
| f:\Movies\Blade Runner 2049 (2017)\poster.jpg<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-poster.jpg
| 1000x1500
| approximately 1:1.5
|- valign="top"
| banner
| banner.jpg
| f:\Movies\Blade Runner 2049 (2017)\banner.jpg<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-banner.jpg
| 1000x185
| 1:0.185
|- valign="top"
| landscape
| landscape.jpg
| f:\Movies\Blade Runner 2049 (2017)\landscape.jpg<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-landscape.jpg
| 1000x562
| 16:9
|- valign="top"
| clearlogo
| clearlogo.png
| f:\Movies\Blade Runner 2049 (2017)\clearlogo.png<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearlogo.png
| 800x310
| 1:0.388
|- valign="top"
| clearart
| clearart.png
| f:\Movies\Blade Runner 2049 (2017)\clearart.png<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-clearart.png
| 1000x562
| 16:9
|- valign="top"
| keyart
| keyart.jpg
| f:\Movies\Blade Runner 2049 (2017)\keyart.jpg<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-keyart.jpg
| 1000x1500
| approximately 1:1.5
|- valign="top"
| thumb
| thumb.jpg
| f:\Movies\Blade Runner 2049 (2017)\thumb.jpg<br>f:\Movies\Blade Runner 2049 (2017)\Blade Runner 2049 (2017)-thumb.jpg
| 960x540
| match video resolution
|}
|}
</div>


= Movie set artwork =


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


== Movie set "fanart" ==
= Scraping =
Fanart is also known as wallpapers, backdrops, or backgrounds.
The {{kodi}} scrapers can automatically download artwork without any extra effort from the user.
;{{See also|wikipedia:Fanart|l1=Fanart on Wikipedia}}


For Kodi they are used as full screen displays to enhance the user experience.
Artwork settings for the video library are adjusted in the {{kodi}} settings pages here... {{highlight|[[Settings/Media/Videos#Artwork|Settings > Media > Videos > Artwork]]}}


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.
= Local Artwork =
Local movie artwork is saved in the same folder where the '''[[Naming_video_files|movie file]]''' is saved.


== Movie set "banner" ==
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)}}
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.
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.


== 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.
<gallery mode="packed" widths="1000px" heights="562px">
 
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.'''''
== Movie set "clearart" ==
</gallery>
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 [https://forum.kodi.tv/showthread.php?tid=258886 Artwork Beef] can add local movie set artwork to your library. [https://forum.kodi.tv/showthread.php?tid=153502 Movie Set Artwork Automator] hasn't been supported for some time, but it is also capable of adding local movie set artwork to your library.
= Actor Image =
[[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>
= Experimental movie artwork =
== "extrafanart" folder ==
{{anchor|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. 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.
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Example naming convention for locally saved extrafanart::'''''
{|
|- valign="top"
| width=250px |'''''File Name'''''
| width=600px |'''''Save name & location example'''''
|- valign="top"
| width=250px |fanart0.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart0.jpg
|- valign="top"
| width=250px |fanart1.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart1.jpg
|- valign="top"
| width=250px |fanart2.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrafanart\fanart2.jpg
|}
</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.
Multiple additional fanart is named "fanart1", "fanart2", and so on with the number increasing for each artwork. The number can increase to 10 and beyond, but numbers cannot be zero-padded. This currently requires more work from skins to display than "extrafanart" and can be awkward to configure because each numbered fanart needs to be added to the artwork whitelist, but the improved performance and behavior that matches other artwork is worth it.
<div style="{{linear-gradient|left|#ffdddd, #ddffdd 50%, #ddddff}}">
'''''Example naming convention for locally saved multiple fanart:'''''
{|
|- valign="top"
| width=300px |'''''Artwork type'''''
| width=250px |'''''File Name'''''
| width=600px |'''''Save name & location example'''''
|- valign="top"
| width=300px |fanart (standard fanart)
| width=250px |fanart.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart.jpg
|- valign="top"
| width=300px |fanart1
| width=250px |fanart1.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\fanart1.jpg
|- valign="top"
| width=300px |fanart2
| width=250px |fanart2.jpg
| 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.
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}}">
'''''Example naming convention for locally saved extrathumbs::'''''
{|
|- valign="top"
| width=250px |'''''File Name'''''
| width=600px |'''''Save name & location example'''''
|- valign="top"
| width=250px |fanart0.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb0.jpg
|- valign="top"
| width=250px |fanart1.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb1.jpg
|- valign="top"
| width=250px |fanart2.jpg
| width=600px |f:\Movies\Blade Runner 2049 (2017)\extrathumbs\thumb2.jpg
|}
</div>


{{Top}}


{{top}}
{{updated|19}}


{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:Karellen]]
[[Category:Video library]]
[[Category:Video library]]
[[Category:First time user]]
[[Category:Advanced topics]]
[[Category:Quick Start Guide]]

Latest revision as of 02:20, 19 August 2021

Artwork contents

Artwork Main Page


See also:


Return to:

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


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


2 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


3 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