From 96a45a16af5594900ca94e7d4abb18d1e6d5ed4a Mon Sep 17 00:00:00 2001 From: wm4 Date: Tue, 7 Feb 2017 17:05:17 +0100 Subject: 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". --- DOCS/man/options.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) (limited to 'DOCS/man') 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=`` + 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=`` 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 -- cgit v1.2.3