summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2017-02-07 17:05:17 +0100
committerwm4 <wm4@nowhere>2017-02-07 17:05:17 +0100
commit96a45a16af5594900ca94e7d4abb18d1e6d5ed4a (patch)
treed08473b07adfa7963ce6735c72af1e5d220930a9 /DOCS
parent061b752217d15d41496ca6e4777835fcd945e237 (diff)
downloadmpv-96a45a16af5594900ca94e7d4abb18d1e6d5ed4a.tar.bz2
mpv-96a45a16af5594900ca94e7d4abb18d1e6d5ed4a.tar.xz
player: add experimental stream recording feature
This is basically a WIP, but it can't remain in a branch forever. A warning is print when using it as it's still a bit "shaky".
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/options.rst23
2 files changed, 24 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index c04b62a422..a032e7c721 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -32,6 +32,7 @@ Interface changes
- "vo-drop-frame-count" to "frame-drop-count"
The old names still work, but are deprecated.
- remove the --stream-capture option and property. No replacement.
+ (--stream-record might serve as alternative)
- add --sub-justify
- add --sub-ass-justify
- internally there's a different way to enable the demuxer cache now
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 13fd4351ca..afdf5b2dd1 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -4863,6 +4863,29 @@ Miscellaneous
This does not affect playlist expansion, redirection, or other loading of
referenced files like with ordered chapters.
+``--record-stream=<file>``
+ Record the current stream to the given target file. The target file will
+ always be overwritten without asking.
+
+ This remuxes the source stream without reencoding, which makes this a
+ highly fragile and experimental feature. It's entirely possible that this
+ writes files which are broken, not standards compliant, not playable with
+ all players (including mpv), or incomplete.
+
+ The target file format is determined by the file extension of the target
+ filename. It is recommended to use the same target container as the source
+ container if possible, and preferring Matroska as fallback.
+
+ Seeking during stream recording, or enabling/disabling stream recording
+ during playback, can cut off data, or produce "holes" in the output file.
+ These are technical restrictions. In particular, video data or subtitles
+ which were read ahead can produce such holes, which might cause playback
+ problems with various players (including mpv).
+
+ The behavior of this option might changed in the future, such as changing
+ it to a template (similar to ``--screenshot-template``), being renamed,
+ removed, or anything else, until it is declared semi-stable.
+
``--lavfi-complex=<string>``
Set a "complex" libavfilter filter, which means a single filter graph can
take input from multiple source audio and video tracks. The graph can result