summaryrefslogtreecommitdiffstats
path: root/DOCS/man/encode.rst
blob: 4c885ea168c99fad223db857ff41ba6b3bab521d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
ENCODING
========

You can encode files from one format/codec to another using this facility.

``--o=<filename>``
    Enables encoding mode and specifies the output file name.

``--of=<format>``
    Specifies the output format (overrides autodetection by the file name
    extension of the file specified by ``-o``). See ``--of=help`` for a full
    list of supported formats.

``--ofopts=<options>``
    Specifies the output format options for libavformat.
    See ``--ofopts=help`` for a full list of supported options.

    Options are managed in lists. There are a few commands to manage the
    options list.

    ``--ofopts-add=<options1[,options2,...]>``
        Appends the options given as arguments to the options list.

    ``--ofopts=""``
        Completely empties the options list.

``--oac=<codec>``
    Specifies the output audio codec. See ``--oac=help`` for a full list of
    supported codecs.

``--oaoffset=<value>``
    Shifts audio data by the given time (in seconds) by adding/removing
    samples at the start. Deprecated.

``--oacopts=<options>``
    Specifies the output audio codec options for libavcodec.
    See ``--oacopts=help`` for a full list of supported options.

    .. admonition:: Example

        "``--oac=libmp3lame --oacopts=b=128000``"
            selects 128 kbps MP3 encoding.

    Options are managed in lists. There are a few commands to manage the
    options list.

    ``--oacopts-add=<options1[,options2,...]>``
        Appends the options given as arguments to the options list.

    ``--oacopts=""``
        Completely empties the options list.

``--oafirst``
    Force the audio stream to become the first stream in the output.
    By default, the order is unspecified. Deprecated.

``--ovc=<codec>``
    Specifies the output video codec. See ``--ovc=help`` for a full list of
    supported codecs.

``--ovoffset=<value>``
    Shifts video data by the given time (in seconds) by shifting the pts
    values. Deprecated.

``--ovcopts=<options>``
    Specifies the output video codec options for libavcodec.
    See --ovcopts=help for a full list of supported options.

    .. admonition:: Examples

        ``"--ovc=mpeg4 --ovcopts=qscale=5"``
            selects constant quantizer scale 5 for MPEG-4 encoding.

        ``"--ovc=libx264 --ovcopts=crf=23"``
            selects VBR quality factor 23 for H.264 encoding.

    Options are managed in lists. There are a few commands to manage the
    options list.

    ``--ovcopts-add=<options1[,options2,...]>``
        Appends the options given as arguments to the options list.

    ``--ovcopts=""``
        Completely empties the options list.

``--ovfirst``
    Force the video stream to become the first stream in the output.
    By default, the order is unspecified. Deprecated.

``--orawts``
    Copies input pts to the output video (not supported by some output
    container formats, e.g. AVI). In this mode, discontinuities are not fixed
    and all pts are passed through as-is. Never seek backwards or use multiple
    input files in this mode!

``--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.