Skip steps: Difference between revisions
No edit summary |
|||
Line 27: | Line 27: | ||
'''Skip delay:''' This is the amount of time Kodi waits for you to press the left or right key again (if using the default '''[[Keymap|keyboard and remote]]''' mapping) , before actually performing the forward or backwards skip, can be set to '''None''' and from there in '''250ms''' steps until '''3000ms'''. | '''Skip delay:''' This is the amount of time Kodi waits for you to press the left or right key again (if using the default '''[[Keymap|keyboard and remote]]''' mapping) , before actually performing the forward or backwards skip, can be set to '''None''' and from there in '''250ms''' steps until '''3000ms'''. | ||
<br /> | <br /> | ||
== Additive skipping == | == Additive skipping == | ||
Line 111: | Line 92: | ||
|} | |} | ||
== | =Customisation of skip steps= | ||
<br /> | |||
There are two types of customisation that can be done. | |||
* Changing GUI skip step values | |||
* Adding Seek built-in funtion to keymap | |||
<br /> | |||
== Changing GUI skip step values == | |||
The available '''skip step''' values can be further customised via the '''[[advancedsettings.xml]]''' file with the '''<seeksteps>''' entry. This is an optional step for users who want more granular control over what options are available. | |||
<br /> | |||
{{greenv|'''IMPORTANT:'''|This advanced setting only overrides the values to be listed in the GUI '''Skip steps''' setting , in order to activate them for use you need to select them in the GUI using the '''Skip step''' setting, otherwise Kodi will carry on using the previously selected values. The values you enter are integers, so they apply for both the negative and positive directions e.g. a value of 10 will result in '''-10 sec''' and '''10 sec''' appearing in the '''Skip step''' list.}} | |||
<br /> | |||
<u><big>'''Example:'''</big></u> | |||
<br /> | |||
<syntaxhighlight lang="xml" enclose="div"> | |||
<seeksteps>10, 20, 30, 40, 50, 60</seeksteps> | |||
</syntaxhighlight> | |||
<br /> | |||
This will result in the '''Skip step''' list in the GUI of '''-60 sec, -50 sec, -40 sec, -30 sec, -20 sec, -10 sec, 10 sec, 20 sec, 30 sec, 40 sec, 50 sec, 60 sec''' | |||
<br /> | |||
==Adding Seek built-in funtion to keymap== | |||
<br /> | |||
The built-in function <code>Seek(seconds)</code> is used to add custom seek (skip) values the keymap, so that when a particular key is pressed an instant seek (skip) of the specified value is performed. You are able to specify a relative amount of seconds to seek (skip) within the current playing media, where a negative value will seek (skip) backwards and a positive value will seek (skip) forwards. | The built-in function <code>Seek(seconds)</code> is used to add custom seek (skip) values the keymap, so that when a particular key is pressed an instant seek (skip) of the specified value is performed. You are able to specify a relative amount of seconds to seek (skip) within the current playing media, where a negative value will seek (skip) backwards and a positive value will seek (skip) forwards. | ||
<br /> | <br /> | ||
Line 133: | Line 134: | ||
<br /> | <br /> | ||
=See also= | |||
* [[Video playback]] | * [[Video playback]] | ||
* [[HOW-TO:Modify time seeking]] | * [[HOW-TO:Modify time seeking]] |
Revision as of 14:31, 4 May 2015
NOTICE: Kodi v15 (Isengard) final has not been released yet. As such, these changes is for the current Kodi mainline which is a work in progress and are still subject to change. |
Video library | Video playback | Skip steps |
Skip steps is a new seeking function that has been implemented into Kodi v15 and is a method of additive skipping (also known as additive seeking) that applies to both videos and music, it allows you 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 you can skip with increasingly larger steps.
The following Action ID's are for now forwarded to the new seeking function:
- StepForward
- StepBack
- SmallStepBack - note this action is going to be removed as it is now redundant with the new seeking behaviour.
Configuration
The settings can be found in the Videos -> Playback section and Music -> Playback
Skip steps - This allows you to set the number of skip steps and the value for each step, the default values available here are -30 min, -15 min, -10 min, -5 min, -60 sec, -30 sec, -15 sec, -7 sec, 7 sec, 15 sec, 30 sec, 60 sec, 5 min, 10 min, 15 min, 30 min.
Skip delay: This is the amount of time Kodi waits for you to press the left or right key again (if using the default keyboard and remote mapping) , before actually performing the forward or backwards skip, can be set to None and from there in 250ms steps until 3000ms.
Additive skipping
Additive skipping (additive seeking) is a method of having increasingly larger skip steps the more times you press either the left or right key, you need at least one skip step configured for either the positive or negative direction together with having a skip delay set. Note - If you press either the left or right key more times than there are configured steps for that direction, then the last configured skip size value will be summed up for each subsequent key press.
Example 1
Skip Steps: -30 sec, -15sec, -7 sec, 15 sec, 30 sec, 60 sec
Skip Delay: 750ms
This table shows what happens with multiple presses of either the left key or the right key:
Key Presses | Left x 5 | Left x 4 | Left x 3 | Left x 2 | Left | Right | Right x 2 | Right x 3 | Right x 4 | Right x 5 |
Time to be skipped | 90 seconds backwards | 60 seconds backwards | 30 seconds backwards | 15 seconds backwards | 7 seconds backwards | 15 seconds forwards | 30 seconds forwards | 60 seconds forwards | 120 seconds forwards | 180 seconds forwards |
Example 2
Skip Steps: -7 sec, 30 sec
Skip Delay: 750ms
This table shows what happens with multiple presses of either the left key or the right key:
Key Presses | Left x 3 | Left x 2 | Left | Right | Right x 2 | Right x 3 |
Time to be skipped | 21 seconds backwards | 14 seconds backwards | 7 seconds backwards | 30 seconds forwards | 60 seconds forwards | 90 seconds forwards |
It is worth experimenting with Skip Delay to find the optimal setting for your hardware and the type of response you wish, for 250ms allows use of the additive function while retaining an almost instant response however this needs very quick presses for multiple presses to be registered.
Instant skipping
With no more than a single negative or positive step configured, together with Skip Delay set to none, then Kodi will instantly skip without a delay.
Example
Skip Steps: -7 sec, 30 sec
Skip Delay: None
Key Presses | Left | Right |
Time to be skipped | 7 seconds backwards | 30 seconds forwards |
Customisation of skip steps
There are two types of customisation that can be done.
- Changing GUI skip step values
- Adding Seek built-in funtion to keymap
Changing GUI skip step values
The available skip step values can be further customised via the advancedsettings.xml file with the <seeksteps> entry. This is an optional step for users who want more granular control over what options are available.
Example:
<seeksteps>10, 20, 30, 40, 50, 60</seeksteps>
This will result in the Skip step list in the GUI of -60 sec, -50 sec, -40 sec, -30 sec, -20 sec, -10 sec, 10 sec, 20 sec, 30 sec, 40 sec, 50 sec, 60 sec
Adding Seek built-in funtion to keymap
The built-in function Seek(seconds)
is used to add custom seek (skip) values the keymap, so that when a particular key is pressed an instant seek (skip) of the specified value is performed. You are able to specify a relative amount of seconds to seek (skip) within the current playing media, where a negative value will seek (skip) backwards and a positive value will seek (skip) forwards.
See also: How to customize my keymap.
Example
This maps a -7 sec seek to the key b and a +15 sec seek to the key n
<keymap> <FullscreenVideo> <keyboard> <b>Seek(-7)</b> <n>Seek(15)</n> </keyboard> </FullscreenVideo> </keymap>