diff options
author | wm4 <wm4@nowhere> | 2018-02-21 17:02:18 +0100 |
---|---|---|
committer | Kevin Mitchell <kevmitch@gmail.com> | 2018-02-21 22:57:39 -0800 |
commit | fc76d41194813754fb687189a312f564c941e5fa (patch) | |
tree | 3e4f93a4fc3c02960120ea92e366c32bd6184d57 /DOCS | |
parent | 4527409c8d968564de53e4dcf4021ff3ae2843b5 (diff) | |
download | mpv-fc76d41194813754fb687189a312f564c941e5fa.tar.bz2 mpv-fc76d41194813754fb687189a312f564c941e5fa.tar.xz |
stream_file: add mode for reading appended files
Do this because retrying reading on higher levels (like the demuxer)
usually causes tons of problems. A hack like this is simpler and could
allow to remove some of the higher level retry behavior.
This works by trying to detect whether the file is appended. If we reach
EOF, check if the file size changed compared to the initial value. If it
did, it means the file was appended at least once, and we set the
p->appending flag. If that flag is set, we simply retry reading more
data every time we encounter EOF. The only way to do this is polling,
and we poll for at most 10 times, after waiting for 200ms every time.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/mpv.rst | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index ec68d9a9da..5ce5d43e25 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -803,6 +803,19 @@ PROTOCOLS ``PATH`` itself should start with a third ``/`` to make the path an absolute path. +``appending://PATH`` + + Play a local file, but assume it's being appended to. This is useful for + example for files that are currently being downloaded to disk. This will + block playback, and stop playback only if no new data was appended after + a timeout of about 2 seconds. + + Using this is still a bit of a bad idea, because there is no way to detect + if a file is actually being appended, or if it's still written. If you're + trying to play the output of some program, consider using a pipe + (``something | mpv -``). If it really has to be a file on disk, use tail to + make it wait forever, e.g. ``tail -f -c +0 file.mkv | mpv -``. + ``fd://123`` Read data from the given file descriptor (for example 123). This is similar |