Settings/Media/Videos: Difference between revisions
No edit summary |
Update for v22 |
||
| (30 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
[[ | {{mininav| [[Settings]] | [[Settings/Media|Media]] }} | ||
__TOC__ | __TOC__ | ||
= All = | |||
[[File:Settings-Media-Videos-01.jpg|600px|Image 1]] | |||
Default | == Default select action == | ||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Basic | | Basic | ||
|- valign="top" | |||
| '''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 '''''[[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> | |||
* '''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 == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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.<br>This feature is limited in the tags that are read and does not match the amount of metadata that can be scraped. | |||
{{warning|••• '''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. | |||
[[File:VideoTags.jpg|700px]] | |||
|} | |} | ||
Extract | == Extract video information from files == | ||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''Description:''' | |||
| Extract file metadata such as audio and video codecs, audio stream languages, audio channel layout, aspect ratio, subtitle languages, duration. | |||
|} | |||
{| | == Extract chapter thumbnails == | ||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
|- | | Advanced | ||
|- valign="top" | |||
| | | '''Description:''' | ||
| Capture a frame of the video stream. This frame will be displayed in chapter timeline displays used by some skins. | |||
|} | |||
= Files = | |||
[[File:Settings-Media-Videos-02.jpg|600px|Image 2]] | |||
== Combine split video items == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Standard | | Standard | ||
|- | |- valign="top" | ||
| Replace file names with library titles | | '''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 == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Standard | | Standard | ||
|- | |- valign="top" | ||
| '''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 = | ||
{| | [[File:Settings-Media-Videos-03.jpg|600px|Image 3]] | ||
== Show all items entry == | |||
| | {| | ||
|- valign="top" | |||
| | | width=120px | {{nowrap|'''Settings level:'''}} | ||
| Advanced | |||
|- valign="top" | |||
| '''Description:''' | |||
| Show the "All items" entry in library lists e.g. ''All Albums'' or ''All seasons'' | |||
|} | |||
== Show information for unwatched items == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Basic | |||
|- valign="top" | |||
| '''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 == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Basic | | 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> | |||
|} | |||
== Show movie sets == | |||
<section begin="Show movie sets" /> | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Standard | | Standard | ||
|- | |- valign="top" | ||
| | | '''Description:''' | ||
| When enabled, a "Movie set | | | ||
* 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}} | |||
|} | |||
<section end="Show movie sets" /> | |||
== Include sets containing a single movie == | |||
<section begin="Show movie sets SingleMovie" /> | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Standard | | Standard | ||
|- valign="top" | |||
| '''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.<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. | |||
{{note|The separate ''Movie Sets'' node is not affected by this setting.}} | |||
{{see|Movie sets}} | |||
|} | |||
<section end="Show movie sets SingleMovie" /> | |||
== Flatten hierarchy == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''Description:''' | |||
| Removes the title, genre, etc. nodes from the library view. Selecting a category takes you straight to the title view | |||
|} | |} | ||
Show | == 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]]''' | |||
== Flatten TV show seasons == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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 == | ||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
|- | | Advanced | ||
| | |- valign="top" | ||
| | | '''Description:''' | ||
| Show TV shows with no episodes when browsing through the library. | |||
|} | |||
== Select first unwatched TV show season / episode == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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" === | |||
::{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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 == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''Description:''' | |||
| Nominate the location of the Movie Set artwork.<ref>https://github.com/xbmc/xbmc/pull/16970</ref> | |||
{{See|Movie set information folder}} | |||
|} | |||
== Show all performers for music videos == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''Description:''' | |||
| When enabled, shows all contributors in addition to the artists. <ref>https://github.com/xbmc/xbmc/pull/18386</ref> | |||
|} | |||
= Artwork = | |||
<gallery mode="packed" widths="600px" heights="337px"> | |||
File:Settings-Media-Videos-04.jpg| Image 4 - Available settings for '''Maximum''' artwork level | |||
File:Settings-Media-Videos-05.jpg| Image 5 - Avaialble settings for the '''Custom''' artwork level | |||
</gallery> | |||
== Artwork level == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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.<br> | |||
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 == | |||
::{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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 == | |||
::{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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 == | |||
::{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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 == | |||
::{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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 == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''Description:''' | |||
| Also download actor artwork when scanning/scraping media. | |||
|} | |||
== Extract thumbnails from video files == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''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 == | |||
{| | |||
|- 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] | |||
|} | |} | ||
= References = | |||
<references /> | |||
{{top}} | |||
{{updated|22}} | |||
[[Category:Settings]] | |||
Latest revision as of 23:59, 16 October 2026
All
Default select action
| Settings level: | Basic |
| Description: |
Allows you to change the default action when clicking on a library item.
|
Default play action
| Settings level: | Advanced |
| Description: |
Control what to do if a video contains a Resume point. [1]
|
Use video tags
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
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
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. |
Show movie sets
| Settings level: | Standard |
| Description: |
Note: The separate Movie Sets node is not affected by this setting.
|
Include sets containing a single movie
| Settings level: | Standard |
| Description: | Can work with, or independently of the previous setting.
Note: The separate Movie Sets node is not affected by this setting.
|
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. |
- 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:
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:
|
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] |
Show all performers for music videos
| Settings level: | Advanced |
| Description: | When enabled, shows all contributors in addition to the artists. [6] |
Artwork
-
Image 4 - Available settings for Maximum artwork level
-
Image 5 - Avaialble settings for the Custom artwork level
Artwork level
| Settings level: | Advanced |
| Description: | Allows you to choose the types of artwork to be added to Kodi. Options are:
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.
|
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.
|
References
| Return to top |
|---|





