2012-09-14 15:51:26 +00:00
|
|
|
ENCODING
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
You can encode files from one format/codec to another using this facility.
|
|
|
|
|
|
2014-04-19 20:05:17 +00:00
|
|
|
``--o=<filename>``
|
2012-09-14 15:51:26 +00:00
|
|
|
Enables encoding mode and specifies the output file name.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--of=<format>``
|
|
|
|
|
Specifies the output format (overrides autodetection by the file name
|
2018-04-22 17:40:36 +00:00
|
|
|
extension of the file specified by ``-o``). See ``--of=help`` for a full
|
|
|
|
|
list of supported formats.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--ofopts=<options>``
|
2012-09-14 15:51:26 +00:00
|
|
|
Specifies the output format options for libavformat.
|
2013-07-08 16:02:14 +00:00
|
|
|
See ``--ofopts=help`` for a full list of supported options.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
options: increase consistency between list options and document them
Whenever I deal with this, I have to look at the code to make sense of
this. And beyond that, there are some strange inconsistencies. (I think
this code is cursed. It always was, and maybe always will be.)
Although the manpage claimed that using multiple items for -add etc. is
deprecated, string list options didn't warn against it. So add the
warning, and add something in the changelog (even though nobody will
ever read this).
The manpage mentioned --vf-append, but this didn't even exist. So add
it, I guess. We encourage using -append for the other option types, so
for consistency, it should work on filter options. (And I already
tricked me into believing it existed when I mentioned it in the
manpage.)
Make the "operations" table separate for all option types, and mention
the option type on every single of the top-level list options.
2019-12-18 04:11:57 +00:00
|
|
|
This is a key/value list option. See `List Options`_ for details.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2020-01-04 22:47:49 +00:00
|
|
|
``--ofopts-add=<option>``
|
|
|
|
|
Appends the option given as an argument to the options list. (Passing
|
|
|
|
|
multiple options is currently still possible, but deprecated.)
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2018-04-29 00:21:59 +00:00
|
|
|
``--ofopts=""``
|
2012-09-14 15:51:26 +00:00
|
|
|
Completely empties the options list.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--oac=<codec>``
|
2018-04-22 17:40:36 +00:00
|
|
|
Specifies the output audio codec. See ``--oac=help`` for a full list of
|
|
|
|
|
supported codecs.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--oaoffset=<value>``
|
2012-09-14 15:51:26 +00:00
|
|
|
Shifts audio data by the given time (in seconds) by adding/removing
|
2018-04-19 17:34:52 +00:00
|
|
|
samples at the start. Deprecated.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--oacopts=<options>``
|
2012-09-14 15:51:26 +00:00
|
|
|
Specifies the output audio codec options for libavcodec.
|
2013-07-08 16:02:14 +00:00
|
|
|
See ``--oacopts=help`` for a full list of supported options.
|
|
|
|
|
|
|
|
|
|
.. admonition:: Example
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
"``--oac=libmp3lame --oacopts=b=128000``"
|
2014-09-01 02:25:57 +00:00
|
|
|
selects 128 kbps MP3 encoding.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
options: increase consistency between list options and document them
Whenever I deal with this, I have to look at the code to make sense of
this. And beyond that, there are some strange inconsistencies. (I think
this code is cursed. It always was, and maybe always will be.)
Although the manpage claimed that using multiple items for -add etc. is
deprecated, string list options didn't warn against it. So add the
warning, and add something in the changelog (even though nobody will
ever read this).
The manpage mentioned --vf-append, but this didn't even exist. So add
it, I guess. We encourage using -append for the other option types, so
for consistency, it should work on filter options. (And I already
tricked me into believing it existed when I mentioned it in the
manpage.)
Make the "operations" table separate for all option types, and mention
the option type on every single of the top-level list options.
2019-12-18 04:11:57 +00:00
|
|
|
This is a key/value list option. See `List Options`_ for details.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2020-01-04 22:47:49 +00:00
|
|
|
``--oacopts-add=<option>``
|
|
|
|
|
Appends the option given as an argument to the options list. (Passing
|
|
|
|
|
multiple options is currently still possible, but deprecated.)
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2018-04-29 00:21:59 +00:00
|
|
|
``--oacopts=""``
|
2012-09-14 15:51:26 +00:00
|
|
|
Completely empties the options list.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--oafirst``
|
2015-12-19 08:26:27 +00:00
|
|
|
Force the audio stream to become the first stream in the output.
|
2018-04-19 17:34:52 +00:00
|
|
|
By default, the order is unspecified. Deprecated.
|
2012-09-29 13:04:40 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--ovc=<codec>``
|
2018-04-22 17:40:36 +00:00
|
|
|
Specifies the output video codec. See ``--ovc=help`` for a full list of
|
|
|
|
|
supported codecs.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--ovoffset=<value>``
|
2012-09-14 15:51:26 +00:00
|
|
|
Shifts video data by the given time (in seconds) by shifting the pts
|
2018-04-19 17:34:52 +00:00
|
|
|
values. Deprecated.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2018-04-29 00:21:59 +00:00
|
|
|
``--ovcopts=<options>``
|
2012-09-14 15:51:26 +00:00
|
|
|
Specifies the output video codec options for libavcodec.
|
|
|
|
|
See --ovcopts=help for a full list of supported options.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
.. admonition:: Examples
|
|
|
|
|
|
2015-06-23 19:49:46 +00:00
|
|
|
``"--ovc=mpeg4 --ovcopts=qscale=5"``
|
2013-07-08 16:02:14 +00:00
|
|
|
selects constant quantizer scale 5 for MPEG-4 encoding.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``"--ovc=libx264 --ovcopts=crf=23"``
|
|
|
|
|
selects VBR quality factor 23 for H.264 encoding.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
options: increase consistency between list options and document them
Whenever I deal with this, I have to look at the code to make sense of
this. And beyond that, there are some strange inconsistencies. (I think
this code is cursed. It always was, and maybe always will be.)
Although the manpage claimed that using multiple items for -add etc. is
deprecated, string list options didn't warn against it. So add the
warning, and add something in the changelog (even though nobody will
ever read this).
The manpage mentioned --vf-append, but this didn't even exist. So add
it, I guess. We encourage using -append for the other option types, so
for consistency, it should work on filter options. (And I already
tricked me into believing it existed when I mentioned it in the
manpage.)
Make the "operations" table separate for all option types, and mention
the option type on every single of the top-level list options.
2019-12-18 04:11:57 +00:00
|
|
|
This is a key/value list option. See `List Options`_ for details.
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2020-01-04 22:47:49 +00:00
|
|
|
``--ovcopts-add=<option>``
|
|
|
|
|
Appends the option given as an argument to the options list. (Passing
|
|
|
|
|
multiple options is currently still possible, but deprecated.)
|
2012-09-14 15:51:26 +00:00
|
|
|
|
2018-04-29 00:21:59 +00:00
|
|
|
``--ovcopts=""``
|
2012-09-14 15:51:26 +00:00
|
|
|
Completely empties the options list.
|
2012-09-29 13:04:40 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--ovfirst``
|
2015-12-19 08:26:27 +00:00
|
|
|
Force the video stream to become the first stream in the output.
|
2018-04-19 17:34:52 +00:00
|
|
|
By default, the order is unspecified. Deprecated.
|
2012-09-29 13:04:40 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``--orawts``
|
2012-09-29 13:04:40 +00:00
|
|
|
Copies input pts to the output video (not supported by some output
|
2013-07-08 16:02:14 +00:00
|
|
|
container formats, e.g. AVI). In this mode, discontinuities are not fixed
|
2012-09-29 13:04:40 +00:00
|
|
|
and all pts are passed through as-is. Never seek backwards or use multiple
|
|
|
|
|
input files in this mode!
|
2014-04-14 18:29:23 +00:00
|
|
|
|
2017-12-16 12:14:26 +00:00
|
|
|
``--no-ocopy-metadata``
|
2014-04-14 18:29:23 +00:00
|
|
|
Turns off copying of metadata from input files to output files when
|
|
|
|
|
encoding (which is enabled by default).
|
2017-12-16 12:21:18 +00:00
|
|
|
|
|
|
|
|
``--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.
|
|
|
|
|
|
options: increase consistency between list options and document them
Whenever I deal with this, I have to look at the code to make sense of
this. And beyond that, there are some strange inconsistencies. (I think
this code is cursed. It always was, and maybe always will be.)
Although the manpage claimed that using multiple items for -add etc. is
deprecated, string list options didn't warn against it. So add the
warning, and add something in the changelog (even though nobody will
ever read this).
The manpage mentioned --vf-append, but this didn't even exist. So add
it, I guess. We encourage using -append for the other option types, so
for consistency, it should work on filter options. (And I already
tricked me into believing it existed when I mentioned it in the
manpage.)
Make the "operations" table separate for all option types, and mention
the option type on every single of the top-level list options.
2019-12-18 04:11:57 +00:00
|
|
|
This is a key/value list option. See `List Options`_ for details.
|
|
|
|
|
|
2017-12-16 12:21:18 +00:00
|
|
|
.. 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.
|
|
|
|
|
|
options: increase consistency between list options and document them
Whenever I deal with this, I have to look at the code to make sense of
this. And beyond that, there are some strange inconsistencies. (I think
this code is cursed. It always was, and maybe always will be.)
Although the manpage claimed that using multiple items for -add etc. is
deprecated, string list options didn't warn against it. So add the
warning, and add something in the changelog (even though nobody will
ever read this).
The manpage mentioned --vf-append, but this didn't even exist. So add
it, I guess. We encourage using -append for the other option types, so
for consistency, it should work on filter options. (And I already
tricked me into believing it existed when I mentioned it in the
manpage.)
Make the "operations" table separate for all option types, and mention
the option type on every single of the top-level list options.
2019-12-18 04:11:57 +00:00
|
|
|
This is a string list option. See `List Options`_ for details.
|
|
|
|
|
|
2017-12-16 12:21:18 +00:00
|
|
|
.. admonition:: Example
|
|
|
|
|
|
|
|
|
|
"``--oremove-metadata=comment,genre``"
|
|
|
|
|
excludes copying of the the comment and genre tags to the output
|
|
|
|
|
file.
|
