summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorChris Down <chris@chrisdown.name>2019-11-09 18:24:16 +0000
committerwm4 <1387750+wm4@users.noreply.github.com>2019-11-20 15:11:33 +0100
commite143966a76a259e4e83fce1b816c8adf86898ab0 (patch)
treed8261a5c7c0c5be7f91d7be9bd3a3d962dfc3ac4 /DOCS
parent1649ba15ab60a99db4ee6bd914d614848d8ed044 (diff)
downloadmpv-e143966a76a259e4e83fce1b816c8adf86898ab0.tar.bz2
mpv-e143966a76a259e4e83fce1b816c8adf86898ab0.tar.xz
player: Optionally validate st_mtime when restoring playback state
I often watch sporting events. On many occasions I get files with the same filename for each session. For example, for F1 I might have the following directory structure: F1/ FP1.mkv FP2.mkv FP3.mkv Qualification.mkv Race.mkv Since usually one simply watches one race after the other, I usually just rsync the new event's files over the old ones, so, for example, Race.mkv will be replaced from the file for the last event with the file from the new event. One problem with this is that I like to use --resume-playback for other kinds of media, so I have it on by default. That works great for, say, a movie, but doesn't work so well with this scheme, because you can trivially forget to pass --no-resume-playback on the command line and end up 2 hours in, watching spoilers as the race results scroll down the screen :-) This patch adds a new option, --resume-playback-check-mtime, which validates that the file's mtime hasn't changed since the watch_later configuration was saved. It does this by setting the watch_later configuration to have the same mtime as the file after it is saved. Switching back and forth between checking mtime and not checking mtime works fine, as we only choose whether to compare based on it, but we update the watch_later configuration mtime regardless of its value.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst2
-rw-r--r--DOCS/man/options.rst7
2 files changed, 9 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 26337e9713..3a399fb265 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -25,6 +25,8 @@ Interface changes
::
--- mpv 0.31.0 ---
+ - add `--resume-playback-check-mtime` to check consistent mtime when
+ restoring playback state.
- add `--d3d11-output-csp` to enable explicit selection of a D3D11
swap chain color space.
- the --sws- options and similar now affect vo_image and screenshot
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 3c52acec00..b2ba69ff26 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -714,6 +714,13 @@ Program Behavior
subdirectory (usually ``~/.config/mpv/watch_later/``).
See ``quit-watch-later`` input command.
+``--resume-playback-check-mtime``
+ Only restore the playback position from the ``watch_later`` configuration
+ subdirectory (usually ``~/.config/mpv/watch_later/``) if the file's
+ modification time is the same as at the time of saving. This may prevent
+ skipping forward in files with the same name which have different content.
+ (Default: ``no``)
+
``--profile=<profile1,profile2,...>``
Use the given profile(s), ``--profile=help`` displays a list of the
defined profiles.