Settings/Media/Videos: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
LGoosens (talk | contribs)
m Structured markup + changed wording for clarity
Update for v22
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{mininav| [[Settings]] | [[Settings/Media|Media]]  }}
{{mininav| [[Settings]] | [[Settings/Media|Media]]  }}


__TOC__
__TOC__
Line 20: Line 19:
Allows you to change the default action when clicking on a library item.
Allows you to change the default action when clicking on a library item.


Available options are: '''Choose''', '''Play''', '''Resume''', '''Show information''' and '''Queue item'''
* '''Choose''' - Always offer a pop-up box with several options ('''Resume''', '''Play''', '''Show information''', '''More...''')
* '''Play''' - ''Offer the option'' to '''Resume''' or '''Play from beginning''' if applicable, otherwise just play the item from the start
* '''Resume''' - ''Immediately'' resume videos from the last watched position if applicable, otherwise just play the item from the start
* '''Show information''' - Display the '''''[[Basic_controls#Information_Page|Information Page]]'''''
* '''Queue item''' - Add selected items to a temporary playlist (accessed through the '''''[[Basic_controls#Sideblade_Menu|Sideblade menu]]''''')
|}
 
 
 
== Default play action ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
|
Control what to do if a video contains a Resume point. <ref>https://github.com/xbmc/xbmc/pull/23863</ref>


* '''Choose'''- A pop-up box with various actions you can ''choose'' from.
* '''Ask if resumable''' - Offer the option to either ''Resume'' or ''Play from beginning''
* '''Play'''- Play the item immediately
* '''Resume''' - Continue playback from the last saved resume point.
* '''Resume'''- Kodi will resume videos from the last watched position. If there is no last watched position, playback will commence from the start of the movie
* '''Show information'''- Display the '''''[[Basic_controls#Information_Page|Information Page]]'''''
* '''Queue item'''- Add selected items to a temporary playlist. Use the '''''[[Basic_controls#Sideblade_Menu|Sideblade menu]]''''' to then access the playlist
|}
|}


Line 79: Line 92:
| '''Description:'''
| '''Description:'''
| Combines multi-part video files and DVD/Bluray folders into a single item in '''Files view'''.  
| Combines multi-part video files and DVD/Bluray folders into a single item in '''Files view'''.  
Has no affect on library lists.
{{note|Library lists are not affected by this setting.}}
|}
|}


Line 90: Line 103:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| When a file is scanned into the library it will display the scanned title instead of the filename. Disable this setting to display the filename instead.
| When a file is scanned into the library the '''file''' list will display the scanned title instead of the filename. Disable this setting to display the filename instead.
|}
|}
{{-}}




Line 107: Line 119:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Show "All items" entry in library lists e.g. ''All Albums'' or ''All seasons''
| Show the "All items" entry in library lists e.g. ''All Albums'' or ''All seasons''
|}
|}


Line 118: Line 130:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Hide informamtion to prevent spoilers. All information is shown by default. Remove an item from the list to hide information and avoid spoilers
| Hide information to prevent spoilers. All information is shown by default. ''Movie plot, Episode plot'' and ''Episode thumb'' can be removed from the list.
''Movie plot, Episode plot'' and ''Episode thumb'' can be hidden.
|}
 
 
== Language details to display ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Basic
|- valign="top"
| '''Description:'''
| The language and codec icons displayed by skins in library listings normally show the media default. This media default may be different to your needs. For example, your preference is for French audio tracks, but the codecs for the English track are displayed.<br>
This setting allows you to choose which audio language flags are shown in the library listings for a title.<br>
'''Player''' - Displays the audio language codecs based on the setting '''[[Settings/Player/Language#Preferred_audio_Language| Preferred audio language]]''' with a fallback to media default if the language is not available.<br>
'''Media''' - The track marked as default in the media file, or the best quality track if no default is marked.<br>
'''Best''' - Always display the best quality track, regardless of language. <ref>https://github.com/xbmc/xbmc/pull/29238</ref> <ref>https://github.com/xbmc/xbmc/pull/29007</ref>
|}
|}


Line 139: Line 165:
|}
|}
<section end="Show movie sets" />
<section end="Show movie sets" />


== Include sets containing a single movie ==
== Include sets containing a single movie ==
Line 152: Line 179:
*When the previous setting is enabled and this setting is disabled, a "Movie set" entry is used only if the movie library contains two or more movies from the set.<br>
*When the previous setting is enabled and this setting is disabled, a "Movie set" entry is used only if the movie library contains two or more movies from the set.<br>
*When this setting is enabled with or without the previous setting, sets that contain a single movie become visible in the Movie Set Editor.  
*When this setting is enabled with or without the previous setting, sets that contain a single movie become visible in the Movie Set Editor.  
*This setting has no affect on the Movie Sets node
 
{{note|The separate ''Movie Sets'' node is not affected by this setting.}}
{{see|Movie sets}}
{{see|Movie sets}}
|}
|}
<section end="Show movie sets SingleMovie" />
<section end="Show movie sets SingleMovie" />




Line 168: Line 195:
| Removes the title, genre, etc. nodes from the library view. Selecting a category takes you straight to the title view
| Removes the title, genre, etc. nodes from the library view. Selecting a category takes you straight to the title view
|}
|}
== Flatten movie versions ==
<section begin="FlattenVersions" />
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| Settings ► Media ► Library ► Video Library ► '''Flatten movie versions'''<br>
This is the same concept as the setting ''Show movie sets'' above.<br>
'''Disabled''' - (default) Movies part of a version are grouped and shown as a single item in the library. Selecting the item reveals all the movies and extras of the Version group.<br>
'''Enabled''' - The grouping is removed. All movies are shown in the library listing.<ref>https://github.com/xbmc/xbmc/pull/28673</ref>
|}<section end="FlattenVersions" />
: See: '''[[Video_versions|Video Versions]]'''




Line 184: Line 228:
{{note|Cover art for individual seasons will also be hidden.}}
{{note|Cover art for individual seasons will also be hidden.}}
|}
|}


== Show empty TV shows ==
== Show empty TV shows ==
Line 205: Line 250:
| When enabled:
| When enabled:
* When entering the seasons list, selects the first season with unwatched episodes.
* When entering the seasons list, selects the first season with unwatched episodes.
* When etering the episode list, selects the first unwatched episode.  
* When entering the episode list, selects the first unwatched episode.  
|}
|}


Line 250: Line 295:
</gallery>
</gallery>


These are '''new artwork settings for v19'''. These settings replace the artwork settings in scrapers and the artwork tags in the advancedsettings.xml file which are no longer needed.<ref>https://github.com/xbmc/xbmc/pull/18072</ref>




Line 261: Line 305:
| '''Description:'''
| '''Description:'''
| Allows you to choose the types of artwork to be added to {{kodi}}. Options are:
| Allows you to choose the types of artwork to be added to {{kodi}}. Options are:
* '''Maximum'''- Scan or scrape all available '''[[Artwork types]]'''. When scanning local artwork, this setting is indiscriminate and will add ''all'' artwork found, even artwork that does not conform to {{kodi}}'s naming scheme, which will not be displayed unless you have modified the skin to do so. Users with messy folders should use the Custom option instead.
* '''Maximum''' - (image 4) Scan or scrape all available '''[[Artwork types]]'''. When scanning local artwork, this setting is indiscriminate and will add ''all'' artwork found.
* '''Basic'''- For users with low powered and low storage devices, scrape the minimum of ''poster, fanart'' and ''episode thumbnails'' only.  
{{note|This includes artwork that does not conform to {{kodi}}'s naming scheme, which will not be displayed unless you have modified the skin to do so.<br>
* '''Custom'''- (image 2) Create a whitelist of artwork to be scanned or scraped. If artwork tags are available in the advancedsettings.xml file, these will be read and added to the custom settings on first run of {{kodi}}
Users with messy folders should use the Custom option instead.}}
* '''None'''- No artwork will be scanned or scraped.
* '''Basic''' - For users with low powered and low storage devices, scrape the minimum of ''poster, fanart'' and ''episode thumbnails'' only.  
* '''Custom''' - (image 5) Create a whitelist of artwork to be scanned or scraped. If the now deprecated artwork tags are available in the advancedsettings.xml file, these will be read and added to the custom settings on first run of {{kodi}}
* '''None''' - No artwork will be scanned or scraped.
|}
|}


Line 279: Line 325:
| Relates to the '''Custom''' artwork level.
| Relates to the '''Custom''' artwork level.
Add to the whitelist the artwork to be scanned or scraped for movies.  
Add to the whitelist the artwork to be scanned or scraped for movies.  
The listed Movie artwork also extends to the equivelant for Movie Sets. eg, ''poster'' includes Movie poster and Movie Set poster.
* The listed Movie artwork also extends to the equivalent for Movie Sets. E. g., ''poster'' includes Movie poster and Movie Set poster.
{{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button. Before adding a new art type, check it is used by the skin as adding a new art type does not mean it will be displayed.
* {{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button.
{{note|Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.}}
|}
|}


Line 293: Line 340:
| Relates to the '''Custom''' artwork level.
| Relates to the '''Custom''' artwork level.
Add to the whitelist the artwork to be scanned or scraped for TV Shows.  
Add to the whitelist the artwork to be scanned or scraped for TV Shows.  
The listed TV show artwork also extends to the equivelant for Seasons. eg, ''poster'' includes TV show poster and Season posters.
* The listed TV show artwork also extends to the equivalent for Seasons. E. g., ''poster'' includes TV show poster and Season posters.
{{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button. Before adding a new art type, check it is used by the skin as adding a new art type does not mean it will be displayed.
* {{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button.
{{note|Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.}}
|}
|}


Line 307: Line 355:
| Relates to the '''Custom''' artwork level.
| Relates to the '''Custom''' artwork level.
Add to the whitelist the artwork to be scanned or scraped for episodes.  
Add to the whitelist the artwork to be scanned or scraped for episodes.  
{{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button. Before adding a new art type, check it is used by the skin as adding a new art type does not mean it will be displayed.
* {{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button.
{{note|Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.}}
|}
|}


Line 320: Line 369:
| Relates to the '''Custom''' artwork level.
| Relates to the '''Custom''' artwork level.
Add to the whitelist the artwork to be scanned or scraped for Music Videos.  
Add to the whitelist the artwork to be scanned or scraped for Music Videos.  
{{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button. Before adding a new art type, check it is used by the skin as adding a new art type does not mean it will be displayed.
* {{kodi}} standard artwork is available for selection. Additional types can be added using the ''Add art type'' button.
{{note|Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.}}
|}
|}


Line 343: Line 393:
| '''Description:'''
| '''Description:'''
| Capture a frame of the video stream. This frame will be displayed when episode artwork or when movie poster or fanart are missing.
| Capture a frame of the video stream. This frame will be displayed when episode artwork or when movie poster or fanart are missing.
|}
== Retrieve art ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- valign="top"
| '''Description:'''
| Previously, some artwork was scraped but never cached in {{kodi}} until it was first accessed by the user, normally by viewing the item on-screen while browsing. For users that liked to backup their library by using the export facility in {{kodi}} this caused export issues as some artwork was missing from the cache and therefore could not be exported.<br>
The caching behaviour has changed in v22 so all artwork is queued for caching.<br>
This setting controls when the caching occurs:<br>
'''After scrape''' - (default) Art is retrieved in the background after scanning or scraping. Users will not notice any changes to the duration of the scraping process, but may notice hardware activity as the caching process completes after the scraping process has completed.<br>
'''During scrape''' - Art is retrieved and cached immediately for that item. This means the scanning/scraping process is not complete until all artwork for that item is cached. This may significantly increase the scanning/scraping time.<ref>https://github.com/xbmc/xbmc/pull/28443</ref><br><br>
'''Note:''' Cached artwork is modified from the original. It may be reduced in resolution depending on your advancedsettings.xml file. If artwork quality is important, you should not export artwork using the Export function of {{kodi}}. Instead use one of the following addons that downloads and stores the original artwork in your file system folders:
* '''Skin Info Services''' - A toolbox of features [https://forum.kodi.tv/showthread.php?tid=384016 Forum thread]
* '''Artwork Dump''' - A dedicated artwork downloader [https://forum.kodi.tv/showthread.php?tid=360078 Forum thread]
|}
|}


Line 354: Line 422:


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


[[Category:Settings]]
[[Category:Settings]]

Latest revision as of 23:59, 16 October 2026

  ▶ Settings ▶ Media ▶ Videos


All

Image 1


Default select action

Settings level: Basic
Description:

Allows you to change the default action when clicking on a library item.

  • Choose - Always offer a pop-up box with several options (Resume, Play, Show information, More...)
  • Play - Offer the option to Resume or Play from beginning if applicable, otherwise just play the item from the start
  • Resume - Immediately resume videos from the last watched position if applicable, otherwise just play the item from the start
  • Show information - Display the Information Page
  • Queue item - Add selected items to a temporary playlist (accessed through the Sideblade menu)


Default play action

Settings level: Advanced
Description:

Control what to do if a video contains a Resume point. [1]

  • Ask if resumable - Offer the option to either Resume or Play from beginning
  • Resume - Continue playback from the last saved resume point.


Use video tags

Settings level: Advanced
Description: Same concept as embedded tags in music files. The video library can read tags in *.mp4 or *.mkv files when this setting is enabled.
This feature is limited in the tags that are read and does not match the amount of metadata that can be scraped.
••• Do not enable this setting unless you have deliberately set proper and correct tags in your video files. Incorrect tags will cause the scraper to fail on all movies containing bad embedded tags.

The below image is a typical example of why scraping fails in most cases. The Title usually contains junk data and the scraper will be unable to find the correct title.


Extract video information from files

Settings level: Advanced
Description: Extract file metadata such as audio and video codecs, audio stream languages, audio channel layout, aspect ratio, subtitle languages, duration.


Extract chapter thumbnails

Settings level: Advanced
Description: Capture a frame of the video stream. This frame will be displayed in chapter timeline displays used by some skins.


Files

Image 2


Combine split video items

Settings level: Standard
Description: Combines multi-part video files and DVD/Bluray folders into a single item in Files view.

Note: Library lists are not affected by this setting.


Replace file names with library titles

Settings level: Standard
Description: When a file is scanned into the library the file list will display the scanned title instead of the filename. Disable this setting to display the filename instead.


Library

Image 3


Show all items entry

Settings level: Advanced
Description: Show the "All items" entry in library lists e.g. All Albums or All seasons


Show information for unwatched items

Settings level: Basic
Description: Hide information to prevent spoilers. All information is shown by default. Movie plot, Episode plot and Episode thumb can be removed from the list.


Language details to display

Settings level: Basic
Description: The language and codec icons displayed by skins in library listings normally show the media default. This media default may be different to your needs. For example, your preference is for French audio tracks, but the codecs for the English track are displayed.

This setting allows you to choose which audio language flags are shown in the library listings for a title.
Player - Displays the audio language codecs based on the setting Preferred audio language with a fallback to media default if the language is not available.
Media - The track marked as default in the media file, or the best quality track if no default is marked.
Best - Always display the best quality track, regardless of language. [2] [3]


Show movie sets

Settings level: Standard
Description:
  • When disabled, all movies are shown individually in library lists.
  • When enabled, movies that are part of a "Movie set" are always grouped together and displayed as a Collection, not separately. Clicking the collection will in turn display the individual movies.

Note: The separate Movie Sets node is not affected by this setting.

See: Movie sets


Include sets containing a single movie

Settings level: Standard
Description: Can work with, or independently of the previous setting.
  • When the previous setting is enabled and this setting is enabled, a "Movie set" entry is used even if the movie set contains only a single movie from the set.
  • When the previous setting is enabled and this setting is disabled, a "Movie set" entry is used only if the movie library contains two or more movies from the set.
  • When this setting is enabled with or without the previous setting, sets that contain a single movie become visible in the Movie Set Editor.

Note: The separate Movie Sets node is not affected by this setting.

See: Movie sets


Flatten hierarchy

Settings level: Advanced
Description: Removes the title, genre, etc. nodes from the library view. Selecting a category takes you straight to the title view


Flatten movie versions

Settings level: Advanced
Description: Settings ► Media ► Library ► Video Library ► Flatten movie versions

This is the same concept as the setting Show movie sets above.
Disabled - (default) Movies part of a version are grouped and shown as a single item in the library. Selecting the item reveals all the movies and extras of the Version group.
Enabled - The grouping is removed. All movies are shown in the library listing.[4]

See: Video Versions


Flatten TV show seasons

Settings level: Advanced
Description: Adjusts when Season lists are removed from TV Show views. Instead a list of episodes from all seasons is displayed.

Options are:

  • Never- Season lists are always displayed
  • If only one season- (default) Season lists are displayed only when two or more seasons exist
  • Always- Hide season lists always

Note: Cover art for individual seasons will also be hidden.


Show empty TV shows

Settings level: Advanced
Description: Show TV shows with no episodes when browsing through the library.


Select first unwatched TV show season / episode

Settings level: Advanced
Description: When enabled:
  • When entering the seasons list, selects the first season with unwatched episodes.
  • When entering the episode list, selects the first unwatched episode.


Include "All seasons" and "Specials"

Settings level: Advanced
Description: Works with the previous setting. Whether or not consider the items from "All season" and "Specials" in the unwatched item selection


Movie set information folder

Settings level: Advanced
Description: Nominate the location of the Movie Set artwork.[5]
See: Movie set information folder


Show all performers for music videos

Settings level: Advanced
Description: When enabled, shows all contributors in addition to the artists. [6]


Artwork


Artwork level

Settings level: Advanced
Description: Allows you to choose the types of artwork to be added to Kodi. Options are:
  • Maximum - (image 4) Scan or scrape all available Artwork types. When scanning local artwork, this setting is indiscriminate and will add all artwork found.

Note: This includes artwork that does not conform to Kodi's naming scheme, which will not be displayed unless you have modified the skin to do so.
Users with messy folders should use the Custom option instead.

  • Basic - For users with low powered and low storage devices, scrape the minimum of poster, fanart and episode thumbnails only.
  • Custom - (image 5) Create a whitelist of artwork to be scanned or scraped. If the now deprecated artwork tags are available in the advancedsettings.xml file, these will be read and added to the custom settings on first run of Kodi
  • None - No artwork will be scanned or scraped.

The following four settings relate to the Custom setting.


Movie art types whitelist

Settings level: Advanced
Description: Relates to the Custom artwork level.

Add to the whitelist the artwork to be scanned or scraped for movies.

  • The listed Movie artwork also extends to the equivalent for Movie Sets. E. g., poster includes Movie poster and Movie Set poster.
  • Kodi standard artwork is available for selection. Additional types can be added using the Add art type button.

Note: Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.


TV show art types whitelist

Settings level: Advanced
Description: Relates to the Custom artwork level.

Add to the whitelist the artwork to be scanned or scraped for TV Shows.

  • The listed TV show artwork also extends to the equivalent for Seasons. E. g., poster includes TV show poster and Season posters.
  • Kodi standard artwork is available for selection. Additional types can be added using the Add art type button.

Note: Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.


Episode art types whitelist

Settings level: Advanced
Description: Relates to the Custom artwork level.

Add to the whitelist the artwork to be scanned or scraped for episodes.

  • Kodi standard artwork is available for selection. Additional types can be added using the Add art type button.

Note: Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.


Music Video art types whitelist

Settings level: Advanced
Description: Relates to the Custom artwork level.

Add to the whitelist the artwork to be scanned or scraped for Music Videos.

  • Kodi standard artwork is available for selection. Additional types can be added using the Add art type button.

Note: Before adding a new art type, check it is used by the skin, as adding a new art type does not necessarily mean it will be displayed.


Download actor thumbnails

Settings level: Advanced
Description: Also download actor artwork when scanning/scraping media.


Extract thumbnails from video files

Settings level: Advanced
Description: Capture a frame of the video stream. This frame will be displayed when episode artwork or when movie poster or fanart are missing.


Retrieve art

Settings level: Expert
Description: Previously, some artwork was scraped but never cached in Kodi until it was first accessed by the user, normally by viewing the item on-screen while browsing. For users that liked to backup their library by using the export facility in Kodi this caused export issues as some artwork was missing from the cache and therefore could not be exported.

The caching behaviour has changed in v22 so all artwork is queued for caching.
This setting controls when the caching occurs:
After scrape - (default) Art is retrieved in the background after scanning or scraping. Users will not notice any changes to the duration of the scraping process, but may notice hardware activity as the caching process completes after the scraping process has completed.
During scrape - Art is retrieved and cached immediately for that item. This means the scanning/scraping process is not complete until all artwork for that item is cached. This may significantly increase the scanning/scraping time.[7]

Note: Cached artwork is modified from the original. It may be reduced in resolution depending on your advancedsettings.xml file. If artwork quality is important, you should not export artwork using the Export function of Kodi. Instead use one of the following addons that downloads and stores the original artwork in your file system folders:


References



Return to top