@@ -1106,7 +1106,8 @@ <h1>LOW LATENCY PLAYBACK</h1>
11061106this with <tt class="docutils literal"><span class="pre">--untimed</span></tt>, but it will likely break, unless the stream has no
11071107audio, and the input feeds data to the player at a constant rate.</p>
11081108<p>Another common problem is with MJPEG streams. These do not signal the correct
1109- framerate. Using <tt class="docutils literal"><span class="pre">--untimed</span></tt> or <tt class="docutils literal"><span class="pre">--no-correct-pts</span> <span class="pre">--fps=60</span></tt> might help.</p>
1109+ framerate. Using <tt class="docutils literal"><span class="pre">--untimed</span></tt> or <tt class="docutils literal"><span class="pre">--no-correct-pts</span> <span class="pre">--container-fps-override=60</span></tt>
1110+ might help.</p>
11101111<p>For livestreams, data can build up due to pausing the stream, due to slightly
11111112lower playback rate, or "buffering" pauses. If the demuxer cache is enabled,
11121113these can be skipped manually. The experimental <tt class="docutils literal"><span class="pre">drop-buffers</span></tt> command can
@@ -1798,7 +1799,7 @@ <h2>Playback Control</h2>
17981799With <tt class="docutils literal">no</tt>, playback will continue in video-only or audio-only mode if one
17991800of them fails. This doesn't affect playback of audio-only or video-only
18001801files.</dd>
1801- <dt><tt class="docutils literal"><span class="pre">--play-dir =<forward|+|backward|-></span></tt></dt>
1802+ <dt><tt class="docutils literal"><span class="pre">--play-direction =<forward|+|backward|-></span></tt></dt>
18021803<dd><p class="first">Control the playback direction (default: forward). Setting <tt class="docutils literal">backward</tt>
18031804will attempt to play the file in reverse direction, with decreasing
18041805playback time. If this is set on playback starts, playback will start from
@@ -1981,7 +1982,7 @@ <h2>Playback Control</h2>
19811982<dt><tt class="docutils literal"><span class="pre">--demuxer-backward-playback-step=<seconds></span></tt></dt>
19821983<dd><p class="first">Number of seconds the demuxer should seek back to get new packets during
19831984backward playback (default: 60). This is useful for tuning backward
1984- playback, see <tt class="docutils literal"><span class="pre">--play-dir </span></tt> for details.</p>
1985+ playback, see <tt class="docutils literal"><span class="pre">--play-direction </span></tt> for details.</p>
19851986<p>Setting this to a very low value or 0 may make the player think seeking is
19861987broken, or may make it perform multiple seeks.</p>
19871988<p class="last">Setting this to a high value may lead to quadratic runtime behavior.</p>
@@ -2276,7 +2277,7 @@ <h2>Watch Later</h2>
22762277the player with Shift+Q.</p>
22772278<p class="last">See <a class="reference internal" href="#resuming-playback">RESUMING PLAYBACK</a>.</p>
22782279</dd>
2279- <dt><tt class="docutils literal"><span class="pre">--watch-later-directory =<path></span></tt></dt>
2280+ <dt><tt class="docutils literal"><span class="pre">--watch-later-dir =<path></span></tt></dt>
22802281<dd><p class="first">The directory in which to store the "watch later" temporary files.</p>
22812282<p class="last">If this option is unset, the files will be stored in a subdirectory
22822283named "watch_later" underneath the local state directory
@@ -2416,7 +2417,7 @@ <h2>Video</h2>
24162417to drop some frames if rendering the first frame takes longer than needed.</li>
24172418</ul>
24182419</dd>
2419- <dt><tt class="docutils literal"><span class="pre">--override- display-fps=<fps></span></tt></dt>
2420+ <dt><tt class="docutils literal"><span class="pre">--display-fps-override =<fps></span></tt></dt>
24202421<dd><p class="first">Set the display FPS used with the <tt class="docutils literal"><span class="pre">--video-sync=display-*</span></tt> modes. By
24212422default, a detected value is used. Keep in mind that setting an incorrect
24222423value (even if slightly incorrect) can ruin video playback. On multi-monitor
@@ -2869,12 +2870,12 @@ <h2>Video</h2>
28692870</dd>
28702871<dt><tt class="docutils literal"><span class="pre">--correct-pts</span></tt>, <tt class="docutils literal"><span class="pre">--no-correct-pts</span></tt></dt>
28712872<dd><tt class="docutils literal"><span class="pre">--no-correct-pts</span></tt> switches mpv to a mode where video timing is
2872- determined using a fixed framerate value (either using the <tt class="docutils literal"><span class="pre">--fps</span></tt>
2873- option, or using file information). Sometimes, files with very broken
2874- timestamps can be played somewhat well in this mode. Note that video
2875- filters, subtitle rendering, seeking (including hr-seeks and backstepping),
2876- and audio synchronization can be completely broken in this mode.</dd>
2877- <dt><tt class="docutils literal"><span class="pre">--fps=<float></span></tt></dt>
2873+ determined using a fixed framerate value (either using the
2874+ <tt class="docutils literal"><span class="pre">--container-fps-override</span></tt> option, or using file information). Sometimes,
2875+ files with very broken timestamps can be played somewhat well in this mode.
2876+ Note that video filters, subtitle rendering, seeking (including hr-seeks and
2877+ backstepping), and audio synchronization can be completely broken in this mode.</dd>
2878+ <dt><tt class="docutils literal"><span class="pre">--container- fps-override =<float></span></tt></dt>
28782879<dd><p class="first">Override video framerate. Useful if the original value is wrong or missing.</p>
28792880<div class="admonition note last">
28802881<p class="first admonition-title">Note</p>
@@ -3621,14 +3622,14 @@ <h2>Subtitles</h2>
36213622loaded assuming a framerate of 23.976 at 25 FPS.</p>
36223623</div>
36233624</dd>
3624- <dt><tt class="docutils literal"><span class="pre">--sub-ass-force- style=<[Style.]Param=Value[,...]></span></tt></dt>
3625+ <dt><tt class="docutils literal"><span class="pre">--sub-ass-style-overrides =<[Style.]Param=Value[,...]></span></tt></dt>
36253626<dd><p class="first">Override some style or script info parameters.</p>
36263627<p>This is a string list option. See <a class="reference internal" href="#list-options">List Options</a> for details.</p>
36273628<div class="admonition admonition-examples">
36283629<p class="first admonition-title">Examples</p>
36293630<ul class="last simple">
3630- <li><tt class="docutils literal"><span class="pre">--sub-ass-force- style=FontName=Arial,Default.Bold=1</span></tt></li>
3631- <li><tt class="docutils literal"><span class="pre">--sub-ass-force- style=PlayResY=768</span></tt></li>
3631+ <li><tt class="docutils literal"><span class="pre">--sub-ass-style-overrides =FontName=Arial,Default.Bold=1</span></tt></li>
3632+ <li><tt class="docutils literal"><span class="pre">--sub-ass-style-overrides =PlayResY=768</span></tt></li>
36323633</ul>
36333634</div>
36343635<div class="admonition note last">
@@ -5546,7 +5547,7 @@ <h2>Screenshot</h2>
55465547<dd>Replaced with the <tt class="docutils literal">%</tt> character itself.</dd>
55475548</dl>
55485549</dd>
5549- <dt><tt class="docutils literal"><span class="pre">--screenshot-directory =<path></span></tt></dt>
5550+ <dt><tt class="docutils literal"><span class="pre">--screenshot-dir =<path></span></tt></dt>
55505551<dd><p class="first">Store screenshots in this directory. This path is joined with the filename
55515552generated by <tt class="docutils literal"><span class="pre">--screenshot-template</span></tt>. If the template filename is already
55525553absolute, the directory is ignored.</p>
@@ -6556,7 +6557,7 @@ <h2>GPU renderer options</h2>
65566557require driver-specific hacks if using multiple monitors, to ensure mpv
65576558syncs to the right one. Compositing window managers can also lead to bad
65586559results, as can missing or incorrect display FPS information (see
6559- <tt class="docutils literal"><span class="pre">--override- display-fps</span></tt>).</p>
6560+ <tt class="docutils literal"><span class="pre">--display-fps-override </span></tt>).</p>
65606561</dd>
65616562<dt><tt class="docutils literal"><span class="pre">--vulkan-device=<device</span> name|UUID></tt></dt>
65626563<dd>The name or UUID of the Vulkan device to use for rendering and presentation. Use
@@ -7648,7 +7649,7 @@ <h2>GPU renderer options</h2>
76487649frame when beneficial for performance. In particular, this is required to
76497650avoid an unnecessary FBO indirection when no advanced rendering is required
76507651otherwise. Has no effect if there already is an indirect pass, such as when
7651- advanced scaling is enabled. Defaults to on . (Only affects
7652+ advanced scaling is enabled. Defaults to no . (Only affects
76527653<tt class="docutils literal"><span class="pre">--vo=gpu-next</span></tt>, note that <tt class="docutils literal"><span class="pre">--vo=gpu</span></tt> always delays the peak.)</dd>
76537654<dt><tt class="docutils literal"><span class="pre">--hdr-peak-percentile=<0.0..100.0></span></tt></dt>
76547655<dd>Which percentile of the input image brightness histogram to consider as the
@@ -10041,7 +10042,7 @@ <h1>VIDEO FILTERS</h1>
1004110042completely broken (e.g. 0 or NaN). Even if the value is correct,
1004210043if another filter changes the real FPS (by dropping or inserting
1004310044frames), the value of this variable will not be useful. Note that
10044- the <tt class="docutils literal"><span class="pre">--fps</span></tt> command line option overrides this value.</p>
10045+ the <tt class="docutils literal"><span class="pre">--container- fps-override </span></tt> command line option overrides this value.</p>
1004510046<p class="last">Useful for some filters which insist on having a FPS.</p>
1004610047</dd>
1004710048<dt><tt class="docutils literal">display_fps</tt></dt>
0 commit comments