From 1d1d1fbff9648e9adf7acf571514abf618ffc40f Mon Sep 17 00:00:00 2001 From: Guido Cella Date: Wed, 21 Jul 2021 11:06:41 +0200 Subject: options: add watch-later-options This allows configuring which options are saved by quit-watch-later. Fixes #4126, #4641 and #5567. Toggling a video or audio filter twice would treat the option as changed because the backup value is NULL, and the current value of vf/af is a list with one empty item, so obj_settings_list_equal had to be changed. --- DOCS/man/options.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'DOCS/man/options.rst') diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index c1b0ba03af..0745eba0e9 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -851,6 +851,28 @@ Program Behavior - ``--reset-on-next-file=all`` Try to reset all settings that were changed during playback. +``--watch-later-options=option1,option2,...`` + The options that are saved in "watch later" files if they have been changed + since when mpv started. These values will be restored the next time the + files are played. The playback position is always saved as ``start``, so + adding ``start`` to this list has no effect. + + When removing options, existing watch later data won't be modified and will + still be applied fully, but new watch later data won't contain these + options. + + This is a string list option. See `List Options`_ for details. + + .. admonition:: Examples + + - ``--watch-later-options-remove=fullscreen`` + Resuming a file won't restore the fullscreen state. + - ``--watch-later-options-remove=volume,mute`` + Resuming a file won't restore the volume or mute state. + - ``--watch-later-options=`` + Resuming a file won't restore any option except the starting + position. + ``--write-filename-in-watch-later-config`` Prepend the watch later config files with the name of the file they refer to. This is simply written as comment on the top of the file. -- cgit v1.2.3