Video playback: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Part update to v18)
(48 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{mininav|[[General topics]]|[[Video library|Videos]] {{l2| [[Settings]] }} }}
{{mininav|[[Video library]]}}
[[File:OSD.videos.Confluence.png|500px|right]]
<section begin="intro" />The main feature of XBMC is playing back videos. This page describes the controls, features, and settings related to video playback.<section end="intro" />


__TOC__
 
= Introduction =
This page will detail how to select and play a title from your video library. It will alse describe the settings and options that are available for, and during, playback of the title.
 
 
 
= Navigation =
This page assumes that you understand how to navigate {{Kodi}} and are familiar with the various screens.
 
{{see|Basic controls}}
 
 
 
= Keyboard Controls =
{{kodi}} is primarily designed to be used with a correctly programmed remote control.
 
Using a keyboard is possible. Using a mouse is also possible but can be awkward at times as {{kodi}} was not designed to be used with a mouse. If you are using a keyboard, shortcuts can be found here...
 
{{see|Keyboard controls}}
 
 
 
= Play =
Navigate to the Movies, TV Shows or Music Videos main menu item and enter it to view a listing of all available titles in your library. Once you have Highlighted the title for playback, there are numerous methods to commence playback:
 
*Press {{keypress|Enter/OK}} on a remote control, or Press {{keypress|Enter}} on a keyboard or left click with a mouse
*Using the '''''[[Basic_controls#Context_Menu|Context Menu]]''''', select '''''Play'''''
*From the '''''[[Basic_controls#Information_Page|Information page]]''''', select '''''Play'''''
 
If a Resume Point is available, additional options will be '''''Play from beginning''''' and '''''Resume from hh:mm:ss'''''
 
The default option for the above keypresses can be modified to open the Information Page instead of play. See here... '''''[[Settings/Media/Videos#Default_select_action|1.1 Default select action]]'''''
 
 
 
= Video Player OSD =
This image shows the main OSD (On Screen Display) for the Video Player during playback. It has been overlayed with labels for illustrative purposes.
 
Most of the OSD is self-explanatory. This page will cover the four icons in the bottom right corner, along with other available OSD examples which are separate to the below image.
 
Note that all OSD's are skin dependant and may show more or less information, and in a different format, than the default skin Estuary.
 
[[File:Video Playback OSD 01.jpg|center|900px]]
{{-}}
{{-}}


== On screen display (OSD) ==
[[File:OSD.videos.Confluence_zoom.png|500px|right]]
{{anchor|OSD (On Screen Display)|OSD|On screen display}}{{see also|Keyboard controls}}


When playing a video full screen you can bring up the on-screen-display controls by pressing {{keypress|enter}} or {{keypress|M}} or on remote the {{button|OK}} (or the equivalent button on your remote control).


{|
== Information ==
| valign="top" width="50%"|
[[File:Video Playback OSD 02.jpg|right|500px]]
# Previous
The Information icon will display available data for the title currently playing. Amongst other information, it shows the Tagline, Plot and Poster. Selecting '''Cast''' will list the Actors.
# Rewind
 
# Play/Pause
The two methods to display this screen are:
# Stop
*Using the icon described in the image
# Fast Forward
*Press {{keypress|i}} on a remote control, or Press {{keypress|i}} on a keyboard
# Next
# Scrub bar (touch/clickable)
| valign="top" width="50%"|
A. Subtitle downloader (via add-on)<br />
B. [[#OSD video settings|Video settings]]<br />
C. [[#OSD audio and subtitle settings|Audio and subtitle settings]]<br />
D. [[#Video bookmarks|Bookmarks]]<br />
E. DVD Menu (if playing back a DVD disc or ISO)
|}
{{-}}
{{-}}


== Mini player controls ==
While in the GUI you are able to browse all of XBMC and even look at pictures while playing music or videos. During GUI playback you can call up the ''Mini player controls'' at any time. In the default skin [[Confluence]], you can do this two ways:


=== Sidebar ===
 
[[File:Mini player sidebar-video.png|x400px|right]]
== Bookmarks ==
While the sidebar tab is present and while media is playing, bringing up the sidebar/blade menu by navigating to the left will reveal a small selection of player controls.
[[File:Video Playback OSD 03.jpg|right|500px]]
Displays a graphical listing of Chapters along a time-line. The listing will populate with Screenshots if the setting '''''[[Settings/Media/Videos#All|Extract thumbnail]]''''' is enabled.
 
This screen also allows the creation of Bookmarks which can then be accessed from this screen when required.
 
{{See|Bookmarks and chapters}}
{{-}}
{{-}}


=== Window ===
 
[[File:Mini player window-video-cropped.png|500px|right]]
 
A pop-up window with mini player controls can be brought up in [[Confluence]] while media is playing. For a keyboard press {{keypress|M}} while video is playing in the background.
== Subtitles ==
[[File:Video Playback OSD 04.jpg|right|500px]]
Allows the control of Subtitles for the currently playing title. If no internal or external subtitles are found, all options except '''Download''' will be inaccessible.
 
<section begin="OSD subs"/>Available options are:
;Enable subtitles
:Allows subtitles to be displayed during playback of the current title. Subtitle tracks with the '''forced''' flag are unaffected by this and should always display.
;Subtitle offset
:If the sync between the display and the subtitles is not correct, adjustments can be made here in milliseconds
;Subtitle
:Select which subtitle stream to display. If only one subtitle track is available, this option will not be available.
:Kodi will auto select subtitle language based on your global settings. To set a default subtitle language for all videos '''''see: [[Settings/Player/Language#Subtitles|2.1 Preferred Subtitle Language]]'''''
;Browse for subtitle
:Allows you to browse the filesystem for locally saved subtitle files
;Download subtitle
:Download subtitle files from the provider. Requires configuring add-ons. '''''See: [[HOW-TO:Setup_subtitle_services|Setup Subtitle Services]]''''' and '''''[[Settings/Player/Language#Download_Services|Download Services]]'''''
;Set as default for all videos
:Selecting this will make the current settings the default for all videos <section end="OSD subs"/>
 
 
{{see|Subtitles}}
{{-}}
 
 
 
== Settings ==
[[File:Video Playback OSD 05.jpg|right|500px]]
The '''cog''' icon in the bottom right corner will display the Settings menu detailed in the image.
 
The following items are available
 
*'''Audio settings'''- ''See [[Video_playback#Audio_Settings|5.5 Audio Settings]]''
*'''Subtitle settings'''- ''See [[Video_playback#Subtitles|5.3 Subtitles]]''
*'''Video settings'''- ''See [[Video_playback#Video_Settings|5.6 Video Settings]]''
*'''Colour management'''- Configure LUT files
*'''Toggle audio stream'''- Allows selection of an alternate language track if more than one is available.
{{-}}
{{-}}


== OSD audio and subtitle settings ==
 
{{see also|Subtitles|Settings/Videos#Subtitles}}
 
<section begin="OSD_subs"/>
== Audio Settings ==
[[File:AudioSubtitleSettings.png|500px|right]]
[[File:Video Playback OSD 06.jpg|right|500px]]
The following settings can be used to modify the behaviour of the currently playing title. There is an option to save the settings as the default for all video media.
 
 
;Volume
;Volume
:Allows you to adjust the playback volume
:Allows you to adjust the playback volume. If audio passthrough is in use, this option will have no effect
;Volume Amplification (Dynamic Range Compression)
;Volume amplification
:Allows you to adjust how much the audio range is compressed, making the loud and soft sounds closer in volume. This is useful when watching movies with loud sound effects such as explosions at night.
:Additional audio amplification that is then limited/compressed at a certain threshold to prevent clipping. If audio passthrough is in use, this option will have no effect
;Audio Offset
;Downmix- Center Mix level
:If dialogue volume is too low, use this setting to boost the volume of the dialogue (centre) channel
:Only available when:
::Audio Passthrough is disabled, '''and'''
::When the setting ''[[Settings/System/Audio#Number_of_channels|1.2 Number of channels]]'' is different to the number of channels in the stream. ie your setup only uses two speakers, but the audio stream is 5.1
;Audio offset
:Adjusts how long that the audio is delayed in relation to the video. This is useful when viewing poorly synced videos.
:Adjusts how long that the audio is delayed in relation to the video. This is useful when viewing poorly synced videos.
;Audio Stream
;Audio stream
:If the video file contains more than one audio stream you can select them here.
:If the video file contains more than one audio stream you can select them here.
* As of v12 Frodo, XBMC will auto select audio language based on your global settings. See: [[Settings/Appearance#International]].
:Kodi will auto select audio language based on your global settings. '''''See: [[Settings/Player/Language#Audio|1.1 Preferred Audio Language]]'''''
;Output stereo to all speakers
;Allow passthrough
:Outputs stereo to all speakers
:When enabled, {{kodi}} will not decode the audio. The RAW audio stream is sent to a compatible AVR or TV that will decode the stream.
;Audio output
:Select output device for the current stream
 
;Enable Subtitles
:Enable or disables subtitles. Subtitle tracks with the '''"forced"''' flag are unaffected by this and should always display.
;Subtitle Offset
:Adjusts how long that the subtitles are delayed in relation to the video
;Subtitle
:Allows you select which subtitles are displayed
* As of v12, XBMC will auto select subtitle language based on your global settings. Also - Set as default for all '''Movies''' is now Set as default for all '''Videos'''. See: [[Settings/Appearance#International]].
;Browse for Subtitle
:Allows you to browse the filesystem for the file used to display the subtitles
;Set as default for all videos
;Set as default for all videos
:Selecting this will make the current settings the default
:Selecting this will make the current settings the default


{{see|Subtitles}}
:{{see also|Settings/Player/Language#Subtitles}}
{{-}}
{{-}}
<section end="OSD_subs"/>


== OSD video settings ==
[[File:VideoSettings.jpg|500px|right]]


;Deinterlace settings
 
: Auto / On / Off
== Video Settings ==
[[File:Video Playback OSD 07.jpg|right|500px]]
The following settings can be used to modify the behaviour of the currently playing title.
 
Starting in v13, Kodi supports a number of active/passive 3D video formats such as SBS, TAB, anaglyph or interlaced
 
Some settings are hardware dependant. Not all options may be shown on your system, and there may be newer options not yet listed here.
 
 
;Video stream
:If more than one video stream is available, this option becomes accessible and allows selection of an alternate video stream.
 
 
;Deinterlace method
;Deinterlace method
* ''Auto Select'' - Tries to guess the best method.
:Set the method used to convert ''[[wikipedia:Deinterlacing|interlaced]]'' video into a non-interlaced format
* ''DeInterlace'' -  
:The methods available here are hardware dependant
* ''Sync Odd'' - (Only for HQ Pixel rendermethod, also NEEDS an interlaced display: PAL* or NTSC*.)
* ''Sync Even'' - (Only for HQ Pixel rendermethod, also NEEDS an interlaced display: PAL* or NTSC*.)
* ''None''
;Video scaling method
;Video scaling method
:Changes the size of a video frame in order to match the resolution of the display device. All methods here are non-adaptive so they may produce different amount of aliasing, blurring and edge halos. There are no best methods it’s up to personal taste what method you should use. The methods are:
:Changes the size of a video frame in order to match the resolution of the display device. All methods here are non-adaptive so they may produce different amount of aliasing, blurring and edge halos. There are no best methods it’s up to personal taste what method you should use. The methods are:
* ''Auto'' - If supported uses '''Lanczos3 Optimized''' when video resolution is lower than 720p (1280x720) and video FPS is lower than 30, otherwise it uses '''Bilinear'''.
:* ''Auto'' - If supported uses '''Lanczos3 Optimized''' when video resolution is lower than 720p (1280x720) and video FPS is lower than 30, otherwise it uses '''Bilinear'''.
* ''Bilinear'' - fairly simple and fast method (video resized with this method may appear slightly smoothed/blurred but with no edge halos also called ringing artifacts).
:* ''Bilinear'' - fairly simple and fast method (video resized with this method may appear slightly smoothed/blurred but with no edge halos also called ringing artifacts).
* ''Bicubic'' - more sophisticated method than '''Bilinear''' (more precise and slightly sharper video than '''Bilinear''', but can introduce some ringing artifacts).
:* ''Bicubic'' - more sophisticated method than '''Bilinear''' (more precise and slightly sharper video than '''Bilinear''', but can introduce some ringing artifacts).
* ''Lanczos2'' - 4-tap filter that uses a 2-lobe Lanczos windowed sinc function (sharper than '''Bicubic''' with less aliasing).
:* ''Lanczos2'' - 4-tap filter that uses a 2-lobe Lanczos windowed sinc function (sharper than '''Bicubic''' with less aliasing).
* ''Spline36 Optimized'' - 4-tap + 3-lobe filter, more precise than '''Lanczos2''', which tries to produce the sharpest image with slightly less ringing artifacts then '''Lanczos3 Optimized''' (differences only noticeable with high resizing factors or when downsizing).
:* ''Spline36 Optimized'' - 4-tap + 3-lobe filter, more precise than '''Lanczos2''', which tries to produce the sharpest image with slightly less ringing artifacts then '''Lanczos3 Optimized''' (differences only noticeable with high resizing factors or when downsizing).
* ''Lanczos3 Optimized'' - 4-tap filter that uses a 3-lobe Lanczos windowed sinc function (comparable results to '''Spline36 Optimized''', with less aliasing and more sharpness, but more ringing artifacts).
:* ''Lanczos3 Optimized'' - 4-tap filter that uses a 3-lobe Lanczos windowed sinc function (comparable results to '''Spline36 Optimized''', with less aliasing and more sharpness, but more ringing artifacts).
* ''Spline36, Lanczos3<sup>1</sup>'' - 6-tap filters that are more precise variants of above "Optimized" versions (they are sharper but might produce more ringing artifacts in some situations).
:* ''Spline36, Lanczos3<sup>1</sup>'' - 6-tap filters that are more precise variants of above "Optimized" versions (they are sharper but might produce more ringing artifacts in some situations).
:'''Characteristics of different methods''':
:'''Characteristics of different methods''':
* ''Sharpness'' - Bilinear < Bicubic < Lanczos2 < Spline36 Optim < Lanczos3 Optim < Spline36 < Lanczos3
:* ''Sharpness'' - Bilinear < Bicubic < Lanczos2 < Spline36 Optim < Lanczos3 Optim < Spline36 < Lanczos3
* ''Aliasing artifacts'' - Lanczos3 < Spline36 < Lanczos3 Optim < Spline36 Optim < Lanczos2 < Bicubic < Bilinear
:* ''Aliasing artifacts'' - Lanczos3 < Spline36 < Lanczos3 Optim < Spline36 Optim < Lanczos2 < Bicubic < Bilinear
* ''Ringing artifacts'' - Bilinear (no ringing) | Bicubic < Lanczos2 < Spline36 Optim < Lanczos3 Optim < Spline36 < Lanczos3
:* ''Ringing artifacts'' - Bilinear (no ringing) - Bicubic < Lanczos2 < Spline36 Optim < Lanczos3 Optim < Spline36 < Lanczos3
:<sup>1</sup> On GL builds these methods are slower than the optimized versions; this is the reason why they are not available by default but can be activated by advanced users in '''[[advancedsettings.xml]]'''
:::''<sup>1</sup> On GL builds these methods are slower than the optimized versions; this is the reason why they are not available by default but can be activated by advanced users in '''[[advancedsettings.xml]]'''''
:::''<sup>2</sup> <dxvaallowhqscaling>true</dxvaallowhqscaling> for <video> (may) need to be added to an '''[[advancedsettings.xml]]''' in order to use all high quality scalers available - Hardware dependent.''


;Crop Black Bars
;View mode
:Choosing this will crop any black bars encoded at the top, bottom or sides of your video. This will fix some issues with videos being displayed at the incorrect aspect ratio.
;View Mode
:Allows you to choose how the video is displayed. The options are:
:Allows you to choose how the video is displayed. The options are:
* ''Normal'' - Movie is displayed so that at least 1 dimension fills the screen. No cropping will occur. Aspect ratio is unaffected.
:* ''Normal'' - Movie is displayed so that at least 1 dimension fills the screen. No cropping will occur. Aspect ratio is unaffected.
* ''Zoom'' - Movie is zoomed in, and the movie cropped so that there are no black bars on screen. Aspect ratio is unaffected.
:* ''Zoom'' - Movie is zoomed in, and the movie cropped so that there are no black bars on screen. Aspect ratio is unaffected.
* ''Stretch 4x3'' - Movie is stretched to fill a 4x3 frame. Aspect ratio is changed.
:* ''Stretch 4x3'' - Movie is stretched to fill a 4x3 frame. Aspect ratio is changed.
* ''Stretch 14x9'' - Movie is stretched to fill a 14x9 frame. Aspect ratio is changed.
:* ''Stretch 14x9'' - Movie is stretched to fill a 14x9 frame. Aspect ratio is changed.
* ''Stretch 16x9'' - Movie is stretched to fill a 16x9 frame. Aspect ratio is changed.
:* ''Stretch 16x9'' - Movie is stretched to fill a 16x9 frame. Aspect ratio is changed.
* ''Original Size'' - Movie is displayed so that the height (in pixels) displayed is the height of the movie exactly. No zooming is performed. Aspect ratio is unaffected.
:* ''Original Size'' - Movie is displayed so that the height (in pixels) displayed is the height of the movie exactly. No zooming is performed. Aspect ratio is unaffected.
* ''Custom'' - Movie is displayed using the Zoom and Pixel Ratio settings as defined in the video On Screen Display. See below for more details.
:* ''Custom'' - Movie is displayed using the Zoom and Pixel Ratio settings as defined in the video On Screen Display. See below for more details.
;Zoom Amount
;Zoom amount
:Allows you to control how much that the view is zoomed into the video.
:Allows you to control how much that the view is zoomed into the video.
;Vertical shift
;Vertical shift
: Determines the amount a the video is shifted up on vertical axys on current display (helpful for projectors)
:Used to move the video image up or down the screen (helpful for projectors)
;Pixel Ratio
;Pixel ratio
:Allows you to adjust the pixel ratio that the video is displayed at. This can be used to adjust videos that are not displaying at the proper aspect ratio.
:Allows you to adjust the pixel ratio that the video is displayed at. This can be used to adjust videos that are not displaying at the proper aspect ratio.
;Postprocessing
;Orientation
:  
:Used to rotate the image in 90° steps. Useful for videos created on a smart phone in Portrait mode.
;Post-processing
:Basically puts an unsharpen mask over the image to reduce pixellation/macroblocking on low-res/low-bitrate videos
;Brightness
;Brightness
:Adjust brightness
:Adjust brightness
;Contrast
;Contrast
:Adjust contrast
:Adjust contrast
;[VDPAU] Noise reduction (only visible when VDPAU is in use)
;Non-linear stretch
:Will stretch the video to fill a 16x9 display when using 4:3 video WITHOUT disturbing aspect ratio (View mode options would disturb AR).
;Tone mapping
:The algorithm method used for enhancing UHD high dynamic range (HDR) video to UHD standard dynamic range (SDR) video.  Passthrough is not available using Kodi VideoPlayer.  Currently Reinhard is the only option until other methods are introduced.  This expands the tone curve producing a brighter picture.
;Tone mapping parameter
:Raises and lowers luminance based on your display capabilities (NIT Value).  Displayed by scale and not actual NIT values.  1.00 is default.  Higher or lower value may improve perceived image based on viewing environment and display capabilities.
;[VDPAU] Noise reduction
:''Only visible when VDPAU is in use''
:Select level of noise reduction for video content
:Select level of noise reduction for video content
;[VDPAU] Sharpness (only visible when VDPAU is in use)
;[VDPAU] Sharpness
:''Only visible when VDPAU is in use''
:Select sharpness amount to apply to video content
:Select sharpness amount to apply to video content
;Non-linear stretch
 
:When enabled the stretching method doesn't look so wide in middle of video area {{?}}
 
----
;Stereoscopic 3D mode of video
:Auto, Side by side, Over / Under. Same as Settings/System/Display/Preferred mode with fewer options.  Auto is preferred.  Can be changed on the fly here should your display fail to enter the correct corresponding 3D mode automatically.
;Invert stereoscopic 3D mode (flip eyes)
:Left and right overlapped frames are either left over right or vice versa depending how the 3D video was processed.
:Commonly used for 3D SBS video when Left side first needs to be changed to Right side first so field of depth is corrected.  Placing glasses upside down will quickly reveal if the 3D video is LSF or RSF because objects that should be in the front depth field may be in the rear for example.  This setting will correct rather than wear your glasses upside down should it be necessary
 
 
;Set as default for all videos
;Set as default for all videos
:Selecting this will make the current settings the default
:Selecting this will make the current settings the default
;Video Calibration
;Video calibration
:Opens the [[#Video calibration|Video Calibration Window]]
:Opens the '''[[Settings/System/Display#Calibration|Video calibration window]]'''
{{-}}
 
 
 
== Colour Management ==
[[File:Video-Playback-OSD-11.jpg|right|500px]]
 
;Colour management
:Allows the use of '''''[[wikipedia:3D_lookup_table|3D LUT file(s)]]''''' or '''''[[wikipedia:ICC_profile|ICC mode profiles]]''''' created from light meter calibrated measurements especially for HDR titles converted to SDR.  Multiple files can be stored and selected based on a particular environment change such as a well lit room becoming dark.
;Colour management mode
:'''''[[wikipedia:3D_lookup_table|3D LUT file(s)]]''''' or '''''[[wikipedia:ICC_profile|ICC mode profiles]]'''''.  See above.
;3D LUT
:Navigate and select where your 3D LUT file(s) is stored
 
{{-}}
 
 
 
= Player Process Info =
[[File:Video Playback OSD 08.jpg|right|500px]]
The Player Process Information OSD details the Audio and Video codecs in use, along with system memory and cpu usage.
 
The OSD can be activated using one of the following methods...
*Pressing {{keypress|o}} on a keyboard
*Pressing the equiveland key on your remote control. This is not a standard button press and will need to be mapped to your remote control. '''''See: [[Add-on:Keymap_Editor|Keymap Editor]]'''''
*Using one of the remote control Apps, special functions are available to activate and deactivate this OSD
 
 
{{see also|Codecinfo}}
 


== Video bookmarks ==
[[File:VideoOSDBookmarks.jpg|360px|right]]
This feature allows you to create bookmarks within your videos in order to be able to return to a certain point in them. This could be compared to chapters in DVD videos. In order to create them, go to the point in your video that you wish to bookmark, select the button with the folded paper (from the [[#OSD (On Screen Display)|Videos OSD]]), and select ''Create Bookmark''. To  jump to a previously stored bookmark, simply highlight and select it through the [[#OSD (On Screen Display)|Videos OSD]].<br />
You can clear all the saved bookmarks by selecting ''Clear Bookmarks''.
{{-}}
{{-}}


== Subtitles ==
{{main|Subtitles}}
{{#lst:Subtitles|intro}}


==Internet video and audio streams==
 
{{Main|Internet video and audio streams}}
= Player Debug Info =
{{#lst:Internet video and audio streams|intro}}
[[File:Video Playback OSD 09.jpg|right|500px]]
The Player Debug Info screen displays dynamic data of the current audio/video stream.
 
The OSD can be activated using one of the following methods...
*Pressing {{keypress|ctrl|shift|o}} on a keyboard
*Pressing the equiveland key on your remote control. This is not a standard button press and will need to be mapped to your remote control. '''''See: [[Add-on:Keymap_Editor|Keymap Editor]]'''''
*Using one of the remote control Apps, special functions are available to activate and deactivate this OSD
 
 
;VSyncOff
:Indicates the offset between the vertical sync signal of the display and the timestamps of the video frames.
:This offset is used for audio visual synchronisation.
::If ''VSyncOff'' is greater than zero and constant, then synchronisation is all good.
::If the value shows 0.0, the framerate (fps) of the video does not match the refresh rate (Hz) of the display which may cause micro-stuttering of the video, especially during panning shots.
 
 
<!-- https://forum.kodi.tv/showthread.php?tid=275260&pid=2526006#pid2526006
https://forum.kodi.tv/showthread.php?tid=332156&pid=2737399#pid2737399 -->
{{see also|Codecinfo}}
{{-}}
{{-}}


== Playlists ==
 
{{Main|Playlists}}
 
{{#lst:Basic playlists|intro}}
= Display Info =
[[File:Video Playback OSD 10.jpg|right|500px]]
The Display Information screen displays the View Mode, Aspect Ratio and other display related data.
 
The OSD can be activated using one of the following methods...
*Pressing {{keypress|z}} on a keyboard
*Pressing the equiveland key on your remote control. This is not a standard button press and will need to be mapped to your remote control. '''''See: [[Add-on:Keymap_Editor|Keymap Editor]]'''''
*Using one of the remote control Apps, special functions are available to activate and deactivate this OSD
 
 
The following data is displayed
 
;View Mode
:The zoom/crop/stretch mode currently in use. For available options '''''See: [[Video_playback#Video_Settings|Video Settings]]''''' above.
 
;Sizing
:Information about the output display of the video stream
::('''720,576''')->('''1920,1080''') '''=''' (Resolution of video)->(Output resolution) Reveals any upscaling or downscaling. The image shows upscaling by {{kodi}}. Your TV may further upscale.
::('''Zoom x1.00''') Reveals if any zoom has been applied
::'''AR:1.78:1''' Aspect Ratio of video
::('''Pixels: 1.00:1''') Pixel ratio in use
::('''VShift: 0.00''') Amount of Vertical Shift applied
:''See: [[Video_playback#Video_Settings|Video Settings]]'' above.
 
;Screen resolution:
:Reported resolution to {{kodi}}. Usually the resolution set on the graphics card, and the TV may then further upscale. Also displays the type of Full Screen in use.
{{-}}
{{-}}


== UPnP ==
 
{{main|UPnP}}
 
{{#lst:UPnP|intro}}
= See Also =
Other useful links related to playback
 
 
 
== 3D ==
{{main|3D}}
{{#lst:3D|intro}}
 
 


== AirPlay ==
== AirPlay ==
Line 165: Line 325:
{{#lst:AirPlay|intro}}
{{#lst:AirPlay|intro}}


== On-Screen Video Diagnostics ==
{{main|Codecinfo}}
[[File:Video.codecinfo.jpg|360px|right|thumb|Video playback with Codec Info enabled]]
On Screen Video Diagnostics, or Codec Info, can be displayed when a video is playing by pressing {{keypress|O}}, or the corresponding control on your remote.


A detailed explanation of the displayed values can be found on the [[Codecinfo]] page.


[[Category:Settings]]
== Playlists ==
[[Category:Video Library]]
{{Main|Playlists}}
[[Category:XBMC Manual]]
These playlists are created by the user for specific requirements. The two types of playlists available for user creation are:
{{frodo updated}}
 
* {{big|'''[[Basic playlists]] -'''}} {{#lst:Basic playlists|intro}}
 
* {{big|'''[[Smart playlists]] -'''}} {{#lst:Smart playlists|intro}}
 
 
 
== Skip steps ==
{{main|Skip steps}}
{{#lst:Skip steps|intro}}
 
 
 
 
{{top}}
 
 
{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:How-to]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:Video library]]
[[Category:General topics]]
[[Category:First time user]]
[[Category:Quick Start Guide]]

Revision as of 23:48, 19 May 2019

Home icon grey.png   ▶ Video library ▶ Video playback


Introduction

This page will detail how to select and play a title from your video library. It will alse describe the settings and options that are available for, and during, playback of the title.


Navigation

This page assumes that you understand how to navigate Kodi and are familiar with the various screens.

See: Basic controls


Keyboard Controls

Kodi is primarily designed to be used with a correctly programmed remote control.

Using a keyboard is possible. Using a mouse is also possible but can be awkward at times as Kodi was not designed to be used with a mouse. If you are using a keyboard, shortcuts can be found here...

See: Keyboard controls


Play

Navigate to the Movies, TV Shows or Music Videos main menu item and enter it to view a listing of all available titles in your library. Once you have Highlighted the title for playback, there are numerous methods to commence playback:

  • Press Enter/OK on a remote control, or Press  Enter on a keyboard or left click with a mouse
  • Using the Context Menu, select Play
  • From the Information page, select Play

If a Resume Point is available, additional options will be Play from beginning and Resume from hh:mm:ss

The default option for the above keypresses can be modified to open the Information Page instead of play. See here... 1.1 Default select action


Video Player OSD

This image shows the main OSD (On Screen Display) for the Video Player during playback. It has been overlayed with labels for illustrative purposes.

Most of the OSD is self-explanatory. This page will cover the four icons in the bottom right corner, along with other available OSD examples which are separate to the below image.

Note that all OSD's are skin dependant and may show more or less information, and in a different format, than the default skin Estuary.

Video Playback OSD 01.jpg



Information

Video Playback OSD 02.jpg

The Information icon will display available data for the title currently playing. Amongst other information, it shows the Tagline, Plot and Poster. Selecting Cast will list the Actors.

The two methods to display this screen are:

  • Using the icon described in the image
  • Press i on a remote control, or Press i on a keyboard



Bookmarks

Video Playback OSD 03.jpg

Displays a graphical listing of Chapters along a time-line. The listing will populate with Screenshots if the setting Extract thumbnail is enabled.

This screen also allows the creation of Bookmarks which can then be accessed from this screen when required.

See: Bookmarks and chapters



Subtitles

Video Playback OSD 04.jpg

Allows the control of Subtitles for the currently playing title. If no internal or external subtitles are found, all options except Download will be inaccessible.

Available options are:

Enable subtitles
Allows subtitles to be displayed during playback of the current title. Subtitle tracks with the forced flag are unaffected by this and should always display.
Subtitle offset
If the sync between the display and the subtitles is not correct, adjustments can be made here in milliseconds
Subtitle
Select which subtitle stream to display. If only one subtitle track is available, this option will not be available.
Kodi will auto select subtitle language based on your global settings. To set a default subtitle language for all videos see: 2.1 Preferred Subtitle Language
Browse for subtitle
Allows you to browse the filesystem for locally saved subtitle files
Download subtitle
Download subtitle files from the provider. Requires configuring add-ons. See: Setup Subtitle Services and Download Services
Set as default for all videos
Selecting this will make the current settings the default for all videos


See: Subtitles



Settings

Video Playback OSD 05.jpg

The cog icon in the bottom right corner will display the Settings menu detailed in the image.

The following items are available

  • Audio settings- See 5.5 Audio Settings
  • Subtitle settings- See 5.3 Subtitles
  • Video settings- See 5.6 Video Settings
  • Colour management- Configure LUT files
  • Toggle audio stream- Allows selection of an alternate language track if more than one is available.



Audio Settings

Video Playback OSD 06.jpg

The following settings can be used to modify the behaviour of the currently playing title. There is an option to save the settings as the default for all video media.


Volume
Allows you to adjust the playback volume. If audio passthrough is in use, this option will have no effect
Volume amplification
Additional audio amplification that is then limited/compressed at a certain threshold to prevent clipping. If audio passthrough is in use, this option will have no effect
Downmix- Center Mix level
If dialogue volume is too low, use this setting to boost the volume of the dialogue (centre) channel
Only available when:
Audio Passthrough is disabled, and
When the setting 1.2 Number of channels is different to the number of channels in the stream. ie your setup only uses two speakers, but the audio stream is 5.1
Audio offset
Adjusts how long that the audio is delayed in relation to the video. This is useful when viewing poorly synced videos.
Audio stream
If the video file contains more than one audio stream you can select them here.
Kodi will auto select audio language based on your global settings. See: 1.1 Preferred Audio Language
Allow passthrough
When enabled, Kodi will not decode the audio. The RAW audio stream is sent to a compatible AVR or TV that will decode the stream.
Set as default for all videos
Selecting this will make the current settings the default


See: Subtitles



Video Settings

Video Playback OSD 07.jpg

The following settings can be used to modify the behaviour of the currently playing title.

Starting in v13, Kodi supports a number of active/passive 3D video formats such as SBS, TAB, anaglyph or interlaced

Some settings are hardware dependant. Not all options may be shown on your system, and there may be newer options not yet listed here.


Video stream
If more than one video stream is available, this option becomes accessible and allows selection of an alternate video stream.


Deinterlace method
Set the method used to convert interlaced video into a non-interlaced format
The methods available here are hardware dependant
Video scaling method
Changes the size of a video frame in order to match the resolution of the display device. All methods here are non-adaptive so they may produce different amount of aliasing, blurring and edge halos. There are no best methods it’s up to personal taste what method you should use. The methods are:
  • Auto - If supported uses Lanczos3 Optimized when video resolution is lower than 720p (1280x720) and video FPS is lower than 30, otherwise it uses Bilinear.
  • Bilinear - fairly simple and fast method (video resized with this method may appear slightly smoothed/blurred but with no edge halos also called ringing artifacts).
  • Bicubic - more sophisticated method than Bilinear (more precise and slightly sharper video than Bilinear, but can introduce some ringing artifacts).
  • Lanczos2 - 4-tap filter that uses a 2-lobe Lanczos windowed sinc function (sharper than Bicubic with less aliasing).
  • Spline36 Optimized - 4-tap + 3-lobe filter, more precise than Lanczos2, which tries to produce the sharpest image with slightly less ringing artifacts then Lanczos3 Optimized (differences only noticeable with high resizing factors or when downsizing).
  • Lanczos3 Optimized - 4-tap filter that uses a 3-lobe Lanczos windowed sinc function (comparable results to Spline36 Optimized, with less aliasing and more sharpness, but more ringing artifacts).
  • Spline36, Lanczos31 - 6-tap filters that are more precise variants of above "Optimized" versions (they are sharper but might produce more ringing artifacts in some situations).
Characteristics of different methods:
  • Sharpness - Bilinear < Bicubic < Lanczos2 < Spline36 Optim < Lanczos3 Optim < Spline36 < Lanczos3
  • Aliasing artifacts - Lanczos3 < Spline36 < Lanczos3 Optim < Spline36 Optim < Lanczos2 < Bicubic < Bilinear
  • Ringing artifacts - Bilinear (no ringing) - Bicubic < Lanczos2 < Spline36 Optim < Lanczos3 Optim < Spline36 < Lanczos3
1 On GL builds these methods are slower than the optimized versions; this is the reason why they are not available by default but can be activated by advanced users in advancedsettings.xml
2 <dxvaallowhqscaling>true</dxvaallowhqscaling> for <video> (may) need to be added to an advancedsettings.xml in order to use all high quality scalers available - Hardware dependent.
View mode
Allows you to choose how the video is displayed. The options are:
  • Normal - Movie is displayed so that at least 1 dimension fills the screen. No cropping will occur. Aspect ratio is unaffected.
  • Zoom - Movie is zoomed in, and the movie cropped so that there are no black bars on screen. Aspect ratio is unaffected.
  • Stretch 4x3 - Movie is stretched to fill a 4x3 frame. Aspect ratio is changed.
  • Stretch 14x9 - Movie is stretched to fill a 14x9 frame. Aspect ratio is changed.
  • Stretch 16x9 - Movie is stretched to fill a 16x9 frame. Aspect ratio is changed.
  • Original Size - Movie is displayed so that the height (in pixels) displayed is the height of the movie exactly. No zooming is performed. Aspect ratio is unaffected.
  • Custom - Movie is displayed using the Zoom and Pixel Ratio settings as defined in the video On Screen Display. See below for more details.
Zoom amount
Allows you to control how much that the view is zoomed into the video.
Vertical shift
Used to move the video image up or down the screen (helpful for projectors)
Pixel ratio
Allows you to adjust the pixel ratio that the video is displayed at. This can be used to adjust videos that are not displaying at the proper aspect ratio.
Orientation
Used to rotate the image in 90° steps. Useful for videos created on a smart phone in Portrait mode.
Post-processing
Basically puts an unsharpen mask over the image to reduce pixellation/macroblocking on low-res/low-bitrate videos
Brightness
Adjust brightness
Contrast
Adjust contrast
Non-linear stretch
Will stretch the video to fill a 16x9 display when using 4:3 video WITHOUT disturbing aspect ratio (View mode options would disturb AR).
Tone mapping
The algorithm method used for enhancing UHD high dynamic range (HDR) video to UHD standard dynamic range (SDR) video. Passthrough is not available using Kodi VideoPlayer. Currently Reinhard is the only option until other methods are introduced. This expands the tone curve producing a brighter picture.
Tone mapping parameter
Raises and lowers luminance based on your display capabilities (NIT Value). Displayed by scale and not actual NIT values. 1.00 is default. Higher or lower value may improve perceived image based on viewing environment and display capabilities.
[VDPAU] Noise reduction
Only visible when VDPAU is in use
Select level of noise reduction for video content
[VDPAU] Sharpness
Only visible when VDPAU is in use
Select sharpness amount to apply to video content


Stereoscopic 3D mode of video
Auto, Side by side, Over / Under. Same as Settings/System/Display/Preferred mode with fewer options. Auto is preferred. Can be changed on the fly here should your display fail to enter the correct corresponding 3D mode automatically.
Invert stereoscopic 3D mode (flip eyes)
Left and right overlapped frames are either left over right or vice versa depending how the 3D video was processed.
Commonly used for 3D SBS video when Left side first needs to be changed to Right side first so field of depth is corrected. Placing glasses upside down will quickly reveal if the 3D video is LSF or RSF because objects that should be in the front depth field may be in the rear for example. This setting will correct rather than wear your glasses upside down should it be necessary


Set as default for all videos
Selecting this will make the current settings the default
Video calibration
Opens the Video calibration window



Colour Management

Video-Playback-OSD-11.jpg
Colour management
Allows the use of 3D LUT file(s) or ICC mode profiles created from light meter calibrated measurements especially for HDR titles converted to SDR. Multiple files can be stored and selected based on a particular environment change such as a well lit room becoming dark.
Colour management mode
3D LUT file(s) or ICC mode profiles. See above.
3D LUT
Navigate and select where your 3D LUT file(s) is stored



Player Process Info

Video Playback OSD 08.jpg

The Player Process Information OSD details the Audio and Video codecs in use, along with system memory and cpu usage.

The OSD can be activated using one of the following methods...

  • Pressing o on a keyboard
  • Pressing the equiveland key on your remote control. This is not a standard button press and will need to be mapped to your remote control. See: Keymap Editor
  • Using one of the remote control Apps, special functions are available to activate and deactivate this OSD





Player Debug Info

Video Playback OSD 09.jpg

The Player Debug Info screen displays dynamic data of the current audio/video stream.

The OSD can be activated using one of the following methods...

  • Pressing ctrl+ Shift+o on a keyboard
  • Pressing the equiveland key on your remote control. This is not a standard button press and will need to be mapped to your remote control. See: Keymap Editor
  • Using one of the remote control Apps, special functions are available to activate and deactivate this OSD


VSyncOff
Indicates the offset between the vertical sync signal of the display and the timestamps of the video frames.
This offset is used for audio visual synchronisation.
If VSyncOff is greater than zero and constant, then synchronisation is all good.
If the value shows 0.0, the framerate (fps) of the video does not match the refresh rate (Hz) of the display which may cause micro-stuttering of the video, especially during panning shots.




Display Info

Video Playback OSD 10.jpg

The Display Information screen displays the View Mode, Aspect Ratio and other display related data.

The OSD can be activated using one of the following methods...

  • Pressing z on a keyboard
  • Pressing the equiveland key on your remote control. This is not a standard button press and will need to be mapped to your remote control. See: Keymap Editor
  • Using one of the remote control Apps, special functions are available to activate and deactivate this OSD


The following data is displayed

View Mode
The zoom/crop/stretch mode currently in use. For available options See: Video Settings above.
Sizing
Information about the output display of the video stream
(720,576)->(1920,1080) = (Resolution of video)->(Output resolution) Reveals any upscaling or downscaling. The image shows upscaling by Kodi. Your TV may further upscale.
(Zoom x1.00) Reveals if any zoom has been applied
AR:1.78:1 Aspect Ratio of video
(Pixels: 1.00:1) Pixel ratio in use
(VShift: 0.00) Amount of Vertical Shift applied
See: Video Settings above.
Screen resolution
Reported resolution to Kodi. Usually the resolution set on the graphics card, and the TV may then further upscale. Also displays the type of Full Screen in use.



See Also

Other useful links related to playback


3D

Starting in v13, Kodi supports a number of passive 3D video formats such as SBS, TAB, anaglyph or interlaced. This support extends to the Kodi GUI including subtitles and on-screen-controls.


AirPlay

As of v11 (Eden), Kodi has very limited support for being an AirPlay target, allowing any device/platform that can run Kodi to receive some AirPlay content.


Playlists

These playlists are created by the user for specific requirements. The two types of playlists available for user creation are:

  • Basic playlists - The Basic Playlist is a user created list of music or video that does not require a correctly scraped library as it uses the folder paths to the media files. As the playlist is based on paths, different classes of media can be mixed, like movies and episodes. The list can be created within Kodi or transferred from another media player.
  • Smart playlists - Smart Playlists are a versatile feature that allow you to create customised lists of media that may be more suited to your browsing preference. They are a set of rules/filters that allow you to display a sub set of the media in your library.


Skip steps

Skip steps is a new seeking function that has been implemented into Kodi as of v15, and is a method of additive skipping (also known as additive seeking) that applies to both videos and music. This allows the user to skip backwards and forwards with the left and right cursor keys (this is the default keyboard and remote mapping), and by pressing these keys multiple times they can skip with increasingly larger steps.



Return to top