path: root/DOCS
diff options
authorwm4 <wm4@nowhere>2018-01-03 21:48:42 +0100
committerKevin Mitchell <>2018-01-03 15:43:51 -0800
commitf798bc3c2542b4c3e7b4cb1483d41ce309b4fb51 (patch)
tree5f9ea0d63d0f2861d8950e041e3fc366af579aa1 /DOCS
parent9c22108fec447183a85f8775e92d7c19ea251d75 (diff)
player: add --cache-pause-initial option to start in buffering state
Reasons why you'd want this see manpage additions. Disabled by default, because it would increase latency of live streams by default. (Or well, at least it would be another problem when trying getting lower latency.)
Diffstat (limited to 'DOCS')
1 files changed, 14 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 3d1c2ade2d..20f48ebc93 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -3865,6 +3865,20 @@ Cache
ends before that for some other reason (like file end), playback resumes
+ Enter "buffering" mode before starting playback (default: no). This can be
+ used to ensure playback starts smoothly, in exchange for waiting some time
+ to prefetch network data (as controlled by ``--cache-pause-wait``). For
+ example, some common behavior is that playback starts, but network caches
+ immediately underrun when trying to decode more data as playback progresses.
+ Another thing that can happen is that the network prefetching is so CPU
+ demanding (due to demuxing in the background) that playback drops frames
+ at first. In these cases, it helps enabling this option, and setting
+ ``--cache-secs`` and ``--cache-pause-wait`` to roughly the same value.
+ This option also triggers when playback is restarted after seeking.