HOW-TO:Modify automatic watch and resume points: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
Line 30: Line 30:
<playcountminimumpercent>90</playcountminimumpercent>
<playcountminimumpercent>90</playcountminimumpercent>
</syntaxhighlight>
</syntaxhighlight>
|| {{huge|'''How much must be viewed to be marked as watched.'''}}
|| {{huge|'''How much must be viewed to be marked as watched'''}}


Since a lot of people don't watch credits at the end of a movie or TV show, this value allows us to skip those parts while still automatically marking something as watched. This setting is defined in a percentage with the default being 90 percent.
Since a lot of people don't watch credits at the end of a movie or TV show, this value allows us to skip those parts while still automatically marking something as watched. This setting is defined in a percentage with the default being 90 percent.

Revision as of 01:07, 24 May 2014

Home icon grey.png   ▶ advancedsettings.xml
▶ Video library
▶ HOW-TO:Modify automatic watch and resume points

This page describes three advancedsettings.xml settings that can be used to modify when "watched" and "resume" marks are saved. These settings can also be used to prevent automatically recording watched and resume points. A watched point records if a video has been watched or not. A resume point records where in a video file playback has stopped, so it can be resumed later.

How-to

If you don't already have an advancedsettings.xml file, it's very simple to make. XBMC 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, etc.

  1. 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 not ".txt" or ".xml.txt".
  2. Cut and paste this into your new plain text file:
    <advancedsettings>
      <video>
        <playcountminimumpercent>90</playcountminimumpercent> <!-- Percent of video to be played before marking as watched -->
        <ignoresecondsatstart>180</ignoresecondsatstart> <!-- Seconds to ignore at the start of a video for making a resume mark -->
        <ignorepercentatend>8</ignorepercentatend> <!-- Percent at end of video to ignore for resume point -->
      </video>
    </advancedsettings>
  3. Change the two percentage values between the tags to fit your situation.
  4. Save this file in your userdata folder:
    If you have an existing file, make sure the <video></video> tags, and settings we'll add between them, are between the main <advancedsettings></advancedsettings> tags.

The Userdata folder is a subfolder of the Kodi Data Folder and is located as shown in the table below.

Operating system Userdata Folder
Android Android/data/org.xbmc.kodi/files/.kodi/userdata/ (see note)
iOS /private/var/mobile/Library/Preferences/Kodi/userdata/
LibreELEC /storage/.kodi/userdata/
Linux ~/.kodi/userdata/
macOS /Users/<your_user_name>/Library/Application Support/Kodi/userdata/
Nvidia Shield (SMB) smb://<nvidiashieldurl>/internal/Android/data/org.xbmc.kodi/files/.kodi/userdata
OSMC /home/osmc/.kodi/userdata/
tvOS /private/var/mobile/Library/Preferences/Kodi/userdata/
Windows %APPDATA%\Kodi\userdata
Windows Portable <Install location chosen by you>\portable_data\userdata\
Windows via Microsoft Store %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\
Windows Xbox %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\
Note: In some Android setups the path may be slightly different to the one stated above.


Note: A file can be marked both as watched and as being in-progress/resumable. When this happens, either because a watched video was rewatched partially, or because the video was watched between 90 and 92 percent (by default), most XBMC interface skins will show the resume mark rather than the watched mark. However, since the file is still marked has having been watched once, then using functions such as "hide watch" will still hide the video, etc.

Settings explained

advancedsettings.xml tag what it does
<playcountminimumpercent>90</playcountminimumpercent>
How much must be viewed to be marked as watched

Since a lot of people don't watch credits at the end of a movie or TV show, this value allows us to skip those parts while still automatically marking something as watched. This setting is defined in a percentage with the default being 90 percent.

<ignoresecondsatstart>180</ignoresecondsatstart>
Time to ignore the start of a video before making a resume point

This setting allows someone to start a video, only watch a couple of minutes, and then stop it without recording a resume point. This allows someone to do things such as check to see if the video is one they've seen or not, or to not mark a video if all you have seen is just the opening credits, etc. This setting is defined in seconds with the default being 180 seconds. For whole minutes simply multiply by 60.

<ignorepercentatend>8</ignorepercentatend>
Percent at the end of a video to ignore to prevent making a resume point

This setting prevents a resume point from being recorded if it is within a certain percentage at the end of the video. The logic here is similar to <playcountminimumpercent>, where most people will probably want to skip end credits and not have a resume point made, as they are done watching the video. The setting is defined in a percentage in relation to the end of the video, and the default is 8 percent. For an hour movie this would ignore a little under 5 minutes from the end of the video.

Examples

More agressive settings

This example also prevents the small gap between being marked as watched and still resumable.

advancedsettings.xml
<advancedsettings>
  <video>
    <playcountminimumpercent>85</playcountminimumpercent> <!-- Percent of video to be played before marking as watched -->
    <ignoresecondsatstart>60</ignoresecondsatstart> <!-- Seconds to ignore at the start of a video for making a resume mark -->
    <ignorepercentatend>15</ignorepercentatend> <!-- Percent at end of video to ignore for resume point -->
  </video>
</advancedsettings>

How-to prevent watch and resume points from being recorded

If you don't want watched or resume points/marks saved automatically then you can use these values. Since it is impossible to playback a video at 101 percent, no mark is made. Watched marks can still be manually recorded using W on a keyboard, the context menu, or an add-on such as Add-on:Trakt. This only prevents new marks from being recorded and won't get rid of existing marks in the database.

<advancedsettings>
  <video>
    <playcountminimumpercent>101</playcountminimumpercent>
    <ignorepercentatend>101</ignorepercentatend>
  </video>
</advancedsettings>

See also

  • Video playback
  • HOW-TO:Backup the video library - How to backup the video library metadata, including watched and resume points, and how to make sure XBMC includes those watched/resume points when importing to a new XBMC install.