HOW-TO:Modify time seeking: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(Redirected page to Skip steps)
Line 1: Line 1:
{{mininav| [[advancedsettings.xml]] {{l2| [[Video library]] }} }}
#REDIRECT [[Skip steps]]
<section begin="intro" />This page describes various '''[[advancedsettings.xml]] settings''' that can be used to modify the default seek "steps" in {{kodi}}, commonly mapped to the directional keys during playback (left, right, up, down). By default, up/down is "BigStepForward/Back" +/- 10 minutes, and left/right is "StepForward/Back" +/- 30 seconds. There is also "SmallStepBack", which is -7 seconds. All of these options can be modified.<section end="intro" />
 
 
{{Future note|15|In the upcoming version 15 release, smallstepbackseconds, timeseekback, and timeseekforward will be removed and replaced with '''[[Skip steps]]''' support, which has settings the user can change from the GUI.}}
 
{{TOC limit|2}}
 
== Steps ==
If you don't already have an [[advancedsettings.xml]] file, it's very simple to make. Kodi uses this file for advanced settings and features that normal users shouldn't modify without first knowing what they do, as well as for experimental features.
 
{{how-to
| Step1 = Create a '''plain text file''' (no rich text formatting, don't use .doc, etc) and save it as '''advancedsettings.xml'''. Make sure that the file extension is ".xml" and {{color|red|'''not'''}} ".txt" or ".xml.txt".
 
| Step2 = Cut and paste this into your new plain text file:
:<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
  <video>
    <usetimeseeking>true</usetimeseeking>
    <smallstepbackseconds>7</smallstepbackseconds>
    <timeseekforward>30</timeseekforward>
    <timeseekbackward>-30</timeseekbackward>
    <timeseekforwardbig>600</timeseekforwardbig>
    <timeseekbackwardbig>-600</timeseekbackwardbig>
    <percentseekforward>2</percentseekforward>
    <percentseekbackward>-2</percentseekbackward>
    <percentseekforwardbig>10</percentseekforwardbig>
    <percentseekbackwardbig>-10</percentseekbackwardbig>
  </video>
</advancedsettings>
</syntaxhighlight>
 
| Step3 = Change the values between the tags to fit your situation. See '''[[#Settings explained]]''' for details.
 
| Step4 = Save this file in your [[userdata folder]]:
:{{#lst:userdata|location all}}
{{note|If you have an existing advancedsettings.xml file, make sure the <video></video> tags, and settings we'll add between them, are between the main <advancedsettings></advancedsettings> tags.}}
 
}}
 
== Settings explained ==
{| class="prettytable"
! advancedsettings.xml tag !! what it does
|-
| <code><usetimeseeking>'''true'''</usetimeseeking></code>
 
| {{big|'''Use time or percentages'''}}
 
By default, Kodi uses the time tags for videos above 20 minutes, and videos below 20 minutes will use the percentage tags. Set this to '''false''' to only use the percent tags regardless of video length (except for smallstepbackseconds, which has no percent counterpart).
 
|-
| <code><smallstepbackseconds>'''7'''</smallstepbackseconds></code>
 
| {{big|'''Small step back'''}}
 
SmallStepBack is the only "step" in Kodi that doesn't have a forward option. This is because the idea behind SmallStepBack is to quickly jump back and hear a line of dialogue or some quick action that was missed.
|-
| <code><timeseekforward>'''30'''</timeseekforward><br /><timeseekbackward>'''-30'''</timeseekbackward></code>
 
| {{big|'''Normal time jumps'''}} {{small|''Videos longer than 20 minutes''}}
 
This is set in seconds. For minutes simply multiply by 60. A - (minus) sign is used when you want to go backward in the video. The default setting is 30 seconds.
 
|-
| <code><timeseekforwardbig>'''600'''</timeseekforwardbig><br /><timeseekbackwardbig>'''-600'''</timeseekbackwardbig></code>
 
| {{big|'''Big time jumps'''}} {{small|''Videos longer than 20 minutes''}}
 
This is set in seconds. For minutes simply multiply by 60. A - (minus) sign is used when you want to go backward in the video. The default setting is 10 minutes.
 
|-
| <code><percentseekforward>'''2'''</percentseekforward><br /><percentseekbackward>'''-2'''</percentseekbackward></code>
 
| {{big|'''Normal percentage jumps'''}} {{small|''Videos shoter than 20 minutes''}}
 
This is set in percentage of the video length. A - (minus) sign is used when you want to go backward in the video. The default setting is 2 percent.
 
For example, a 1 minute video will seek slightly more than 1 second (1.2, to be exact) if seeking back/forward by 2 percent.
 
|-
| <code><percentseekforwardbig>'''10'''</percentseekforwardbig><br /><percentseekbackwardbig>'''-10'''</percentseekbackwardbig></code>
 
| {{big|'''Big percentage jumps'''}} {{small|''Videos shorter than 20 minutes''}}
 
This is set in percentage of the video length. A - (minus) sign is used when you want to go backward in the video. The default setting is 10 percent.
 
For example, a 10 minute video will seek 1 minute if seeking back/forward by 10 percent.
 
|}
 
== Examples ==
 
=== Example 1 ===
In this example we have set Kodi to always use percent seeks, so there is no need to include the time seek tags. The percentages used are smaller for more fine-grained control, but anyone who wants truly fine-grain control will most likely want to use time-based seeking rather than percentage-based seeking.
 
;advancedsettings.xml
<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
  <video>
    <usetimeseeking>false</usetimeseeking>
    <percentseekforward>1</percentseekforward>
    <percentseekbackward>-1</percentseekbackward>
    <percentseekforwardbig>5</percentseekforwardbig>
    <percentseekbackwardbig>-5</percentseekbackwardbig>
  </video>
</advancedsettings>
</syntaxhighlight>
 
=== Example 2 ===
This example shows a simple adjustment of the seeks, which a person might use depending on their own personal preferences. <code><usetimeseeking></code> is excluded here since this person is okay with using time-based tags for videos longer than 20 minutes, and percentage-based tags for videos shorter than 20 minutes (the default).
 
;advancedsettings.xml
<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
  <video>
    <smallstepbackseconds>5</smallstepbackseconds>
    <timeseekforward>15</timeseekforward>
    <timeseekbackward>-15</timeseekbackward>
    <timeseekforwardbig>60</timeseekforwardbig>
    <timeseekbackwardbig>-60</timeseekbackwardbig>
    <percentseekforward>3</percentseekforward>
    <percentseekbackward>-3</percentseekbackward>
    <percentseekforwardbig>20</percentseekforwardbig>
    <percentseekbackwardbig>-20</percentseekbackwardbig>
  </video>
</advancedsettings>
</syntaxhighlight>
 
=== Example 3 ===
This example is the same as '''[[#Example 2|Example 2]]''', but without the percent-based tags. When any tag is not included it will simply use the default value. If this were a situation were we only wanted to change the time-based seeking, then we would only need to include those tags.
 
;advancedsettings.xml
<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
  <video>
    <smallstepbackseconds>5</smallstepbackseconds>
    <timeseekforward>15</timeseekforward>
    <timeseekbackward>-15</timeseekbackward>
    <timeseekforwardbig>60</timeseekforwardbig>
    <timeseekbackwardbig>-60</timeseekbackwardbig>
  </video>
</advancedsettings>
</syntaxhighlight>
 
=== Example 4 ===
In this example things get ''weird''. Despite the name of the tags, we can actually use either "forward" or "back" for both forward and backwards seeking, depending on if we use the - (minus) sign or not. While not actually practical, this is one example of how these settings could be used. When using default [[keymaps]] we get the following behavior:
 
* '''Left:''' forward 10 seconds
* '''Right:''' forward 20 seconds
* '''Up:''' forward 30 seconds
* '''Down:''' forward 40 seconds
 
;advancedsettings.xml
<syntaxhighlight lang="xml" enclose="div">
<advancedsettings>
  <video>
    <timeseekforward>10</timeseekforward>
    <timeseekbackward>20</timeseekbackward>
    <timeseekforwardbig>30</timeseekforwardbig>
    <timeseekbackwardbig>40</timeseekbackwardbig>
  </video>
</advancedsettings>
</syntaxhighlight>
 
== Other ways to seek ==
This page simply covers the [[advancedsettings.xml]] values, which typically relate to how the directional keys jump in a video. However, there are many other ways that one can seek back or forward in time when playing a video. See the topics below for some of those methods:
 
* [[Remote controls]]
* [[Keymaps]]
 
{{Helix updated}}
 
[[Category:Advanced topics]]
[[Category:How-to]]
[[Category:Video library]]
[[Category:Remotes]]

Revision as of 07:06, 5 August 2016

Redirect to:

Retrieved from "https://kodi.wiki/index.php?title=HOW-TO:Modify_time_seeking&oldid=123816"