summaryrefslogtreecommitdiffstats
path: root/DOCS/man/encode.rst
diff options
context:
space:
mode:
authorTheAMM <the.actual.amm@gmail.com>2017-12-16 14:21:18 +0200
committerKevin Mitchell <kevmitch@gmail.com>2017-12-26 03:33:19 -0700
commit8b7da7a8e50764e750a0507cc4b72687203bba89 (patch)
tree5edbdfad9652f6cac0fdb92aa6799cdff37a4dc4 /DOCS/man/encode.rst
parentc8d955571dbf15d7aa0280c439c964907ded32f4 (diff)
downloadmpv-8b7da7a8e50764e750a0507cc4b72687203bba89.tar.bz2
mpv-8b7da7a8e50764e750a0507cc4b72687203bba89.tar.xz
encode: implement --oset-metadata, and --oremove-metadata
This commit introduces a new --oset-metadata key-value-list option, allowing the user to specify output metadata when encoding (eg. --oset-metadata=title="Hello",comment="World"). A second option --oremove-metadata is added to exclude existing metadata from the output file (assuming --ocopy-metadata is enabled). Not all output formats support all tags, but luckily libavcodec simply discards unsupported keys.
Diffstat (limited to 'DOCS/man/encode.rst')
-rw-r--r--DOCS/man/encode.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/DOCS/man/encode.rst b/DOCS/man/encode.rst
index 3182f85fcd..2c5bc14ddc 100644
--- a/DOCS/man/encode.rst
+++ b/DOCS/man/encode.rst
@@ -153,3 +153,24 @@ You can encode files from one format/codec to another using this facility.
``--no-ocopy-metadata``
Turns off copying of metadata from input files to output files when
encoding (which is enabled by default).
+
+``--oset-metadata=<metadata-tag[,metadata-tag,...]>``
+ Specifies metadata to include in the output file.
+ Supported keys vary between output formats. For example, Matroska (MKV) and
+ FLAC allow almost arbitrary keys, while support in MP4 and MP3 is more
+ limited.
+
+ .. admonition:: Example
+
+ "``--oset-metadata=title="Output title",comment="Another tag"``"
+ adds a title and a comment to the output file.
+
+``--oremove-metadata=<metadata-tag[,metadata-tag,...]>``
+ Specifies metadata to exclude from the output file when copying from the
+ input file.
+
+ .. admonition:: Example
+
+ "``--oremove-metadata=comment,genre``"
+ excludes copying of the the comment and genre tags to the output
+ file.