summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorMohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>2020-08-17 00:46:13 +0300
committerwm4 <1387750+wm4@users.noreply.github.com>2020-08-19 17:22:53 +0200
commitffa9aaa2e458dcac3658a16c4d1fb14755de0ebd (patch)
tree1350515bedf81ad65ba4dea43999429009e55ed2 /DOCS/man
parent19aa5659f6293aacb498fd3e8057289a69dd7391 (diff)
downloadmpv-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.rst21
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.