diff options
author | Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com> | 2020-08-17 00:46:13 +0300 |
---|---|---|
committer | wm4 <1387750+wm4@users.noreply.github.com> | 2020-08-19 17:22:53 +0200 |
commit | ffa9aaa2e458dcac3658a16c4d1fb14755de0ebd (patch) | |
tree | 1350515bedf81ad65ba4dea43999429009e55ed2 /DOCS/man | |
parent | 19aa5659f6293aacb498fd3e8057289a69dd7391 (diff) | |
download | mpv-ffa9aaa2e458dcac3658a16c4d1fb14755de0ebd.tar.bz2 mpv-ffa9aaa2e458dcac3658a16c4d1fb14755de0ebd.tar.xz |
stream: Implement slice:// for reading slices of streams
Add support for reading a byte range from a stream via
the `slice://` protocol.
Syntax is `slice://start[-end]@URL` where end is a maximum
(read until end or eof).
Size suffixes support in `m_option` is reused so they can
be used with start/end.
This can be very useful with e.g. large MPEGTS streams with
corruption or time-stamp jumps or other issues in them.
Signed-off-by: Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>
Diffstat (limited to 'DOCS/man')
-rw-r--r-- | DOCS/man/mpv.rst | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index b5739d7707..dc61394ff7 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -1194,6 +1194,27 @@ PROTOCOLS Stitch together parts of multiple files and play them. +``slice://start[-end]@URL`` + + Read a slice of a stream. + + ``start`` and ``end`` represent a byte range and accept + suffixes such as ``KiB`` and ``MiB``. ``end`` is optional. + + Only works with seekable streams. + + Examples:: + + mpv slice://1g-2g@cap.ts + + This starts reading from cap.ts after seeking 1 GiB, then + reads until reaching 2 GiB or end of file. + + mpv slice://100m@appending://cap.ts + + This starts reading from cap.ts after seeking 100MiB, then + reads until end of file. + ``null://`` Simulate an empty file. If opened for writing, it will discard all data. |