From 8b7da7a8e50764e750a0507cc4b72687203bba89 Mon Sep 17 00:00:00 2001 From: TheAMM Date: Sat, 16 Dec 2017 14:21:18 +0200 Subject: 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. --- DOCS/man/encode.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'DOCS/man') 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=`` + 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=`` + 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. -- cgit v1.2.3