summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-04-10 21:06:00 +0200
committerwm4 <wm4@nowhere>2013-04-10 21:32:46 +0200
commit9df2260506f825a05ecd500496260292ef2481aa (patch)
treed17e38880cf9d54272dc0de153ff8a0713598493 /DOCS
parent62daa08d3b9e32f6d7f81bae4407faab4347c90d (diff)
downloadmpv-9df2260506f825a05ecd500496260292ef2481aa.tar.bz2
mpv-9df2260506f825a05ecd500496260292ef2481aa.tar.xz
core: add --reset-on-next-file option
This option can be used to selectively reset settings when playing the next file in the playlist (i.e. restore mplayer and mplayer2 behavior). Might remove this option again should it turn out that nobody uses it.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/options.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index b99c2428fb..fab682fdd5 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1739,6 +1739,30 @@
--referrer=<string>
Specify a referrer path or URL for HTTP requests.
+--reset-on-next-file=<all|option1,option2,...>
+ Normally, mpv will try to keep all settings when playing the next file on
+ the playlist, even if they were changed by the user during playback. (This
+ behavior is the opposite of MPlayer's, which tries to reset all settings
+ when starting next file.)
+
+ This can be changed with this option. It accepts a list of options, and
+ mpv will reset the value of these options on playback start to the initial
+ value. The initial value is either the default value, or as set by the
+ config file or command line.
+
+ In some cases, this might not work as expected. For example, ``--volume``
+ will only be reset the volume if it's explicitly set in the config file
+ or the command line.
+
+ The special name ``all`` resets as many options as possible.
+
+ *EXAMPLE*:
+
+ - ``--reset-on-next-file=fullscreen,speed`` Reset fullscreen and playback
+ speed settings if they were changed during playback.
+ - ``--reset-on-next-file=all`` Try to reset all settings that were changed
+ during playback.
+
--reuse-socket
(udp:// only)
Allows a socket to be reused by other processes as soon as it is closed.