Settings/Media/Videos: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{bigger|This category contains the settings for how information for videos is collected, stored, shown and navigated.}}
{{mininav| [[Settings]] | [[Settings/Media|Media]]  }}
 
 
__TOC__
__TOC__
{{-}}
 
== All ==
 
[[File:SettingsMediaVideos-leia1.jpg|500px]]
 
=== Default select action ===
= All =
[[File:Settings-Media-Videos-01.jpg|600px|Image 1]]
 
 
== Default select action ==
{|
{|
|- valign="top"
|- valign="top"
Line 11: Line 17:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Lets you toggle between '''Choose''', '''Play''', '''Resume''' and '''Show information'''
|
Allows you to change the default action when clicking on a library item.


'''Choose''', will select item, eg open a directory in files mode.
Available options are: '''Choose''', '''Play''', '''Resume''', '''Show information''' and '''Queue item'''


On '''Resume''' Kodi will automatically resume videos from the last position that you were viewing them, even after restarting the system.
* '''Choose'''- A pop-up box with various actions you can ''choose'' from.
 
* '''Play'''- Play the item immediately
Default is '''Play'''
* '''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
|}
|}




=== Use video tags ===
== Use video tags ==
{|
{|
|- valign="top"
|- valign="top"
Line 28: Line 37:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| If *.mp4 or *.mkv files do have tags, enable this setting to use them for the library metadata.
| 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 video information from files ===
== Extract video information from files ==
{|
{|
|- valign="top"
|- valign="top"
Line 39: Line 51:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Extract metadata information such as codec and aspect ratio from videos.
| Extract file metadata such as audio and video codecs, audio stream languages, audio channel layout, aspect ratio, subtitle languages, duration.
|}
|}




=== Extract thumbnails from video files ===
== Extract chapter thumbnails ==
{|
{|
|- valign="top"
|- valign="top"
Line 50: Line 62:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Extract thumbnails to display in library mode
| Capture a frame of the video stream. This frame will be displayed in chapter timeline displays used by some skins.
|}
|}




=== Extract chapter thumbnails ===
 
{|
= Files =
|- valign="top"
[[File:Settings-Media-Videos-02.jpg|600px|Image 2]]
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| Extract chapter thummbnails for presentation in the chapters/bookmarks dialogue. This might increase CPU load
|}




== Files ==
== Combine split video items ==
[[File:Settings_media_videos_files.JPG|500px]]
=== Combine split video items ===
{|
{|
|- valign="top"
|- valign="top"
Line 74: Line 78:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Combines multi-part video files, DVD folders or movie folders, down to a single item in the non-library views
| Combines multi-part video files and DVD/Bluray folders into a single item in '''Files view'''.
Has no affect on library lists.
|}
|}




=== Replace file names with library titles ===
== Replace file names with library titles ==
{|
{|
|- valign="top"
|- valign="top"
Line 85: Line 90:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| When a file is scanned into the library it will display the metadata title instead of the filename
| 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.
|}
|}
{{-}}
{{-}}


== Library ==
 
[[File:SettingsMediaVideos-leia2.jpg|500px]]
 
=== Show all items entry ===
= Library =
[[File:Settings-Media-Videos-03.jpg|600px|Image 3]]
 
 
== Show all items entry ==
{|
{|
|- valign="top"
|- valign="top"
Line 98: Line 107:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Show "All items" entry in directory, e.g. "All Albums" or "All seasons"
| Show "All items" entry in library lists e.g. ''All Albums'' or ''All seasons''
|}
|}




=== Show plot for unwatched items ===
== Show information for unwatched items ==
{|
{|
|- valign="top"
|- valign="top"
Line 109: Line 118:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Show information for unwatched media in the video library or hide them if not selected to prevent spoilers. Available options are: "Movie plot", "Episode plot" and "Episode thumb".
| Hide informamtion to prevent spoilers. All information is shown by default. Remove an item from the list to hide information and avoid spoilers
''Movie plot, Episode plot'' and ''Episode thumb'' can be hidden.
|}
|}




=== Show movie sets ===
== Show movie sets ==
<section begin="Show movie sets" />
<section begin="Show movie sets" />
{|
{|
Line 121: Line 131:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| When enabled, movies that are tagged with a "Movie set" are grouped together under one entry in the movie library. This entry can then be opened to display the individual movies. When disabled, each movie will have its own entry in the movie library, even if it belongs to a set. It has no affect on the Movie Sets node.
|  
When disabled, all movies in are shown individually in library lists
When enabled, movies that are part of a "Movie set" are grouped together and the Collection is displayed instead of the individual movies in the set. Clicking the collection will display the movies.
This setting has no effect on the Movie Sets node.
{{See|Movie sets}}
|}
|}
<section end="Show movie sets" />
<section end="Show movie sets" />




==== Include sets containing a single movie ====
== Include sets containing a single movie ==
<section begin="Show movie sets SingleMovie" />
<section begin="Show movie sets SingleMovie" />
{|
{|
Line 134: Line 148:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Can work with, or independently of the previous setting. It is recommended that this setting is enabled
| 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 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 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
*This setting has no affect on the Movie Sets node
{{see|Movie sets}}
|}
|}
<section end="Show movie sets SingleMovie" />
<section end="Show movie sets SingleMovie" />
{{see|Movie sets}}




=== Flatten hierarchy ===
 
== Flatten hierarchy ==
{|
{|
|- valign="top"
|- valign="top"
Line 151: Line 166:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Romeves 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 TV show seasons ===
== Flatten TV show seasons ==
{|
{|
|- valign="top"
|- valign="top"
Line 162: Line 177:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Removes the TV show season node, toggles between "If only one season" (default), "Always" and "Never".
| 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
|}
|}




=== Show empty TV shows ===
== Show empty TV shows ==
{|
{|
|- valign="top"
|- valign="top"
Line 173: Line 191:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Shows TV shows with no episodes when browsing through the library
| Show TV shows with no episodes when browsing through the library.
|}  
|}  




=== Select first unwatched TV show season / episode ===
== 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 etering 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"
|- valign="top"
Line 184: Line 226:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| When entering TV show season or episode views, automatically selects the first unwatched item.
| Nominate the location of the Movie Set artwork.<ref>https://github.com/xbmc/xbmc/pull/16970</ref>
If viewing seasons, selects the first season with unwatched episodes.
{{See|Movie set information folder}}
If viewing episodes, selects the first unwatched episode. Only applies if sort method is set to Episode
|}
|}




==== Include "All seasons" and "Specials" ====
== Show all performers for music videos ==
{|
{|
|- valign="top"
|- valign="top"
Line 197: Line 238:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Whether or not consider the items from "All season" and "Specials in the unwatched item selection
| When enabled, shows all contributors in addition to the artists. <ref>https://github.com/xbmc/xbmc/pull/18386</ref>
|}
|}




=== Download actor thumbnails ===
 
= 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>
 
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>
 
 
== Artwork level ==
{|
{|
|- valign="top"
|- valign="top"
Line 208: Line 259:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Gets thumbnails for actors when scanning media.
| 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.
* '''Basic'''- For users with low powered and low storage devices, scrape the minimum of ''poster, fanart'' and ''episode thumbnails'' only.
* '''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}}
* '''None'''- No artwork will be scanned or scraped.
|}
|}


{{updated|18}}
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 equivelant for Movie Sets. eg, ''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.
|}
 
 
== 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 equivelant for Seasons. eg, ''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.
|}
 
 
== 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. 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.
|}
 
 
== 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. 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.
|}
 
 
== 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.
|}
 
 
 
= References =
<references />
 
 
 
 
{{top}}
{{updated|19}}
 
[[Category:Settings]]

Revision as of 21:45, 8 August 2022

Home icon grey.png   ▶ 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.

Available options are: Choose, Play, Resume, Show information and Queue item

  • Choose- A pop-up box with various actions you can choose from.
  • Play- Play the item immediately
  • 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 Information Page
  • Queue item- Add selected items to a temporary playlist. Use the Sideblade menu to then access the playlist


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.
Stop hand.png ••• 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. VideoTags.jpg


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.

Has no affect on library lists.


Replace file names with library titles

Settings level: Standard
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.



Library

Image 3


Show all items entry

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


Show information for unwatched items

Settings level: Basic
Description: Hide informamtion to prevent spoilers. All information is shown by default. Remove an item from the list to hide information and avoid spoilers

Movie plot, Episode plot and Episode thumb can be hidden.


Show movie sets

Settings level: Standard
Description:

When disabled, all movies in are shown individually in library lists When enabled, movies that are part of a "Movie set" are grouped together and the Collection is displayed instead of the individual movies in the set. Clicking the collection will display the movies. This setting has no effect on the Movie Sets node.

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.
  • This setting has no affect on the Movie Sets node
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 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


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 etering 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.[1]
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. [2]


Artwork

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.[3]


Artwork level

Settings level: Advanced
Description: 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.
  • Basic- For users with low powered and low storage devices, scrape the minimum of poster, fanart and episode thumbnails only.
  • 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
  • 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 equivelant for Movie Sets. eg, 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.


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 equivelant for Seasons. eg, 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.


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


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


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.


References



Return to top