RepoMirrors
/
mpv
mirror of https://github.com/mpv-player/mpv
1
0
Fork 0
Code Issues Releases Wiki Activity
mpv/DOCS/man/encode.rst

107 lines
3.6 KiB
ReStructuredText
Raw Normal View History

encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
ENCODING
========
You can encode files from one format/codec to another using this facility.
encode: don't apply default config options Often, user configs set options that are not suitable for encoding. Usually, playback and encoding are pretty different things, so it makes sense to keep them strictly separate. There are several possible solutions. The approach taken by this commit is to basically ignore the default config settings, and switch to an [encoding] config profile section instead. This also makes it impossible to have --o in a config file, because --o enables encode mode. See github issue #727 for discussion.
2014-04-19 20:05:17 +00:00
``--o=<filename>``
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
Enables encoding mode and specifies the output file name.
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
``--of=<format>``
Specifies the output format (overrides autodetection by the file name
DOCS/man: replace legacy option syntax usage They are replaced by --option=value.
2024-04-17 04:27:25 +00:00
extension of the file specified by ``--o``). See ``--of=help`` for a full
encode: rewrite half of it The main change is that we wait with opening the muxer ("writing headers") until we have data from all streams. This fixes race conditions at init due to broken assumptions in the old code. This also changes a lot of other stuff. I found and fixed a few API violations (often things for which better mechanisms were invented, and the old ones are not valid anymore). I try to get away from the public mutex and shared fields in encode_lavc_context. For now it's still needed for some timestamp-related fields, but most are gone. It also removes some bad code duplication between audio and video paths.
2018-04-22 17:40:36 +00:00
list of supported formats.
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
``--ofopts=<options>``
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
Specifies the output format options for libavformat.
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
See ``--ofopts=help`` for a full list of supported options.
encode: video encoding now supported using mencoder-like 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.
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: explain deprecated usage of multiple items with *-add
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.)
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: -pre, -del etc. does not work on some options anymore With the internal change from stringlist to keyvaluelist, these sub-options stop working. I don't really care enough to bring them back. (Order doesn't matter, -del always seemed annoying.)
2018-04-29 00:21:59 +00:00
``--ofopts=""``
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
Completely empties the options list.
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
``--oac=<codec>``
encode: rewrite half of it The main change is that we wait with opening the muxer ("writing headers") until we have data from all streams. This fixes race conditions at init due to broken assumptions in the old code. This also changes a lot of other stuff. I found and fixed a few API violations (often things for which better mechanisms were invented, and the old ones are not valid anymore). I try to get away from the public mutex and shared fields in encode_lavc_context. For now it's still needed for some timestamp-related fields, but most are gone. It also removes some bad code duplication between audio and video paths.
2018-04-22 17:40:36 +00:00
Specifies the output audio codec. See ``--oac=help`` for a full list of
supported codecs.
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
``--oacopts=<options>``
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
Specifies the output audio codec options for libavcodec.
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
See ``--oacopts=help`` for a full list of supported options.
.. admonition:: Example
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
"``--oac=libmp3lame --oacopts=b=128000``"
man: fix a whole bunch of typos
2014-09-01 02:25:57 +00:00
selects 128 kbps MP3 encoding.
encode: video encoding now supported using mencoder-like 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.
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: explain deprecated usage of multiple items with *-add
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.)
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: -pre, -del etc. does not work on some options anymore With the internal change from stringlist to keyvaluelist, these sub-options stop working. I don't really care enough to bring them back. (Order doesn't matter, -del always seemed annoying.)
2018-04-29 00:21:59 +00:00
``--oacopts=""``
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
Completely empties the options list.
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
``--ovc=<codec>``
encode: rewrite half of it The main change is that we wait with opening the muxer ("writing headers") until we have data from all streams. This fixes race conditions at init due to broken assumptions in the old code. This also changes a lot of other stuff. I found and fixed a few API violations (often things for which better mechanisms were invented, and the old ones are not valid anymore). I try to get away from the public mutex and shared fields in encode_lavc_context. For now it's still needed for some timestamp-related fields, but most are gone. It also removes some bad code duplication between audio and video paths.
2018-04-22 17:40:36 +00:00
Specifies the output video codec. See ``--ovc=help`` for a full list of
supported codecs.
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: -pre, -del etc. does not work on some options anymore With the internal change from stringlist to keyvaluelist, these sub-options stop working. I don't really care enough to bring them back. (Order doesn't matter, -del always seemed annoying.)
2018-04-29 00:21:59 +00:00
``--ovcopts=<options>``
encode: video encoding now supported using mencoder-like 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.
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
.. admonition:: Examples
manpage: Fix typo. oacopts -> ovcopts
2015-06-23 19:49:46 +00:00
``"--ovc=mpeg4 --ovcopts=qscale=5"``
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
selects constant quantizer scale 5 for MPEG-4 encoding.
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
``"--ovc=libx264 --ovcopts=crf=23"``
selects VBR quality factor 23 for H.264 encoding.
encode: video encoding now supported using mencoder-like 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.
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: explain deprecated usage of multiple items with *-add
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.)
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
manpage: -pre, -del etc. does not work on some options anymore With the internal change from stringlist to keyvaluelist, these sub-options stop working. I don't really care enough to bring them back. (Order doesn't matter, -del always seemed annoying.)
2018-04-29 00:21:59 +00:00
``--ovcopts=""``
encode: video encoding now supported using mencoder-like options
2012-09-14 15:51:26 +00:00
Completely empties the options list.
encode: add options --ovfirst and --oafirst This allows to define which stream is to be used as first output stream. This is useful because dvdauthor refuses VOB files where the audio stream is the first stream.
2012-09-29 13:04:40 +00:00
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
``--orawts``
encode: add options --ovfirst and --oafirst This allows to define which stream is to be used as first output stream. This is useful because dvdauthor refuses VOB files where the audio stream is the first stream.
2012-09-29 13:04:40 +00:00
Copies input pts to the output video (not supported by some output
manpage: proofread and fix formatting
2013-07-08 16:02:14 +00:00
container formats, e.g. AVI). In this mode, discontinuities are not fixed
encode: add options --ovfirst and --oafirst This allows to define which stream is to be used as first output stream. This is useful because dvdauthor refuses VOB files where the audio stream is the first stream.
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!
New option --no-ometadata to opt out of including metadata when encoding. This re-allows the previous behaviour of being able to reencode with metadata removed, which is useful when encoding "inconsistently" tagged data for a device/player that shows file names when tags are not present.
2014-04-14 18:29:23 +00:00
DOCS/man: unify flag option descriptions In many places, flags options have duplicate descriptions like --break-player and --no-break-player. This is redundant since the equivalence of this syntax to --break-player=<yes|no> is already documented, and the =<yes|no> syntax is more in line with the syntax of other option types. This replaces all usage of --no-foobar with --foobar=no, and use --foobar=<yes|no> when possible.
2024-04-04 00:27:19 +00:00
``--ocopy-metadata=<yes|no>``
Copy metadata from input files to output files when encoding (default: yes).
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.
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.
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.
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.
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.
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.