FFmpeg命令行

FFmpeg 命令行

基础语法与流程

ffmpeg [gl-opt] {[input-file-opt] -i input-url} ... {[output-file-opt] output-url} ...

_______              ______________
|       |            |              |
| input |  demuxer   | encoded data |   decoder
| file  | ---------> | packets      | -----+
|_______|            |______________|      |
                                           v
                                       _________
                                      |         |
                                      | decoded |
                                      | frames  |
                                      |_________|
 ________             ______________       |
|        |           |              |      |
| output | <-------- | encoded data | <----+
| file   |   muxer   | packets      |   encoder
|________|           |______________|

• 流（stream）：视频文件中，一般具有视频流与音频流，有的具有字幕流。它们需要不同的解码/编码器。想要混合/分离视频与音频，就需要混流/分流器。

• 流复制（stream）：如果某种数据流的内容不需要任何改动，那么可以直接跳过该数据流的解码与编码步骤。分离出该数据流后，直接等待参与混流即可。

主要参数

1. 以 <> 包裹的表示由用户具体指定；以 [] 包裹的表示是可选参数，可以指定也可以省略。

2. 括号内的 i 表示该参数用于输入流，o 表示用于输出流，i/o 表示均可，global 表示全局参数。

3. 关键字 duration, position 或 offset 满足：[-][HH:]MM:SS[.m...] 这种时间戳格式。或者以秒为单位的 SS[.m...] 格式。

• -b[:stream_specifier] (o)：输出比特率。

• -f <fmt> (i/o)：指定 fmt 作为输入或输出的视频格式。一般会根据文件扩展名自动选择，但有时需要手动指定。

• -i <filename> (i)：指定 filename 作为源文件。

• -y (global)：文件存在时直接覆盖。

• -n (global)：文件存在时不覆盖并立即退出。

• -bsf[:stream_specifier] <bitstream_filters> (o)：设置比特流滤镜。bitstream_filters 是一个逗号分隔的滤镜列表。

• -stream_loop <num> (i)：指定输入流的循环次数。0 表示不循环，-1 表示无限循环。

• -c[:stream_specifier] <codec> (i/o)：-c可写为-codec。选择一个 codec ，即编码器（输出时）或一个解码器（输入时），参与到 stream_specifier 指定的一个或多个流的编码/解码中。在输出时，<codec> 可以被指定为 copy，表示复制数据流。

• -t <duration> (i/o)：（在参数 -i 之前指定）工作持续 duration 时长。一般用于指定剪辑数据流的范围。 它与 -to 参数相互冲突，但本参数优先。

• -to <position> (o)：到 position 位置后，终止输出。与 -t 参数冲突，本参数优先级低。

• -fs <limit_size> (o)：输出文件大小达到 limit_size 后停止输出，单位是 byte.

• -ss <position> (i/o)：（在参数 -i 之前指定）从 position 指定的位置开始工作。注意：大多数情形下，工作起始位置是不精确的。ffmpeg会找到其前部的一个点作为真正的起始，并在结束工作后将该点与用户指定点之间的内容抛弃。然而，如果你使用了 copy 参数，这部分内容却会被保留。

• -sseof <position> (i/o)：类似 -ss 参数，只不过是从数据流末端向前寻找 position。此时 0 表示数据流末。

• -itsoffset <offset> (i)：指定输入流以原时间戳加上 offset 作为其输入时间戳。

• -metadata[:metadata_specifier] key=value (o)：以键值对的形式设置元数据。

• -frames[:stream_specifier] <num> (o)：在输出 num 帧后停止写入。

• -qscale[:stream_specifier] q (o)：使用固定质量(VBR)。

• stats (global)：输出编码过程，是系统默认值。可以使用 -nostats 关闭。

• -attach <filename> (o)：将 filename 文件附加到输出文件。附件流作为文件的最后一个流，只有很少的文件类型被支持（例如字体）。

视频参数

• -vframes <num>：文件的总帧数。-frames:v 的别名。

• -r[:steam_specifier] <fps> (i/o)：文件的帧率。

• -s[:steam_specifier] <size> (i/o)：帧尺寸。参数 size 需要满足格式 <width>x<height>，例如320x240。 -aspect[:steam_specifier] <asp> (o)：宽高比，例如 4:3。如果使用了 -vcodec copy，那么指定容器的宽高比而不是视频的。

• -vn (o)：禁止输出视频。

• -vcodec <codec> (o)：设置视频编码器。-codec:v 的别名。

• -pass[:stream_specifier] <n>：选择当前编码数（1或者2），常用于二次编码的情况。在第一次编码中，音频输出往往被设置为 NULL，对于 Windows 与 Unix 系统分别是：

ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y NUL
ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y /dev/null

音频参数

• -aframes <num> (o)：文件的总帧数。-frames:a 的别名。

• -ar[:stream_specifier] <freq> (i/o)：采样率。默认输出等于输入。仅当输入文件为真实设备或者 raw 数据时，该参数才能用于输入过程。

• -aq <q> (o)：音频品质（VBR）。 -q:a 的别名。

• -ac[:stream_specifier] <channel> (i/o)：设置音频通道数。默认输出等于输入。仅当输入文件为真实设备或者 raw 数据时，该参数才能用于输入过程。

• -an (o)：禁止输出音频。

• -acode <codec> (i/o)：设置音频的解码器或编码器。-codec:a 的别名。

字幕参数

• -scodec <codec> (i/o)：字幕解码器或编码器。codec:s 的别名。

• -sn (o)：禁止输出字幕。

• canvas_size <size>：设置字幕渲染区域的尺寸。

其他参数

• -bsfs：可用的比特流滤镜。

• -h [arg]：帮助。arg 的内容可以是：
• decoders：可用的解码器。或特指：decoder=<name>。
• encoders：可用的编码器。或特指：encoder=<name>。
• filters：所有滤镜。或特指：filter=<name>。
• formats：可用的分流器与混流器。或特指分流器：demuxer=<name>，或特指混流器：muxer=<name>。

• -protocols：支持的协议。

• -version：版本信息。

FFmpeg 实用例子

合并视频

(for %i in (*.flv) do @echo file '%i') > mylist.txt
ffmpeg -f concat -i mylist.txt -c copy output.flv

ffmpeg -i "1.flv" -c copy -bsf:v h264_mp4toannexb -f mpegts 1.ts
ffmpeg -i "2.flv" -c copy -bsf:v h264_mp4toannexb -f mpegts 2.ts
ffmpeg -i "concat:1.ts|2.ts" -c copy -bsf:a aac_adtstoasc "All.mp4"

分割视频

ffmpeg -i "input.mp4" -ss 00:00:00 -t 5 -c copy "output.mp4"

批量格式转换

ffmpeg -i "input.flv" -c copy "output.mp4"

for %i in (*.mp4) do ffmpeg -i "%i" -c copy "%~ni.flv"

ffmpeg -i input.mp4 -i wm.png -filter_complex "overlay=20:40" output.mp4

ffmpeg -i input.mp4 -i wm.png -filter_complex "[1:v]scale=384:216[wm];[0:v][wm]overlay=0:0" output.mp4

GIF 水印

• 需要将 ignore_loop 参数指明为 0，表示 gif 无限循环。

• 需要用到复合过滤器 filter_complex。

• 需要过滤器的 shortest=1 选项，表示至少在一个视频流循环一次后，再终止输出。如果不加该选项，输出将无法自行停止。

ffmpeg -y -i input.mp4 -ignore_loop 0 -i wm.gif -filter_complex "[1:v]scale=50:50[wm];[0:v][wm]overlay=0:0:shortest=1" output.mp4

外挂字幕

ffmpeg -i input.mp4 -i input.srt -c:v copy -c:a copy -c:s ass output.mkv

• 字幕文件请用 UTF-8 编码。

• Windows 系统缺少一个字体接口，因此需要自己配置 fonts.conf 文件，放在 %FONTCONFIG_PATH% 这个环境用户变量里（往往需要你自己新建）。该变量应该指向C:\Users\用户名\。

内嵌字幕

ffmpeg -i input.mp4 -vf subtitles=input.srt output.mp4

ffmpeg -i input.mkv -vf subtitles=input.mkv output.mp4

附录：Windows 的 fonts.conf

<?xml version="1.0"?>
<fontconfig>

<dir>C:\WINDOWS\Fonts</dir>

<match target="pattern">
<test qual="any" name="family"><string>mono</string></test>
<edit name="family" mode="assign"><string>monospace</string></edit>
</match>

<match target="pattern">
<test qual="all" name="family" compare="not_eq"><string>sans-serif</string></test>
<test qual="all" name="family" compare="not_eq"><string>serif</string></test>
<test qual="all" name="family" compare="not_eq"><string>monospace</string></test>
<edit name="family" mode="append_last"><string>sans-serif</string></edit>
</match>

<alias>
<family>Times</family>
<prefer><family>Times New Roman</family></prefer>
<default><family>serif</family></default>
</alias>
<alias>
<family>Helvetica</family>
<prefer><family>Arial</family></prefer>
<default><family>sans</family></default>
</alias>
<alias>
<family>Courier</family>
<prefer><family>Courier New</family></prefer>
<default><family>monospace</family></default>
</alias>
<alias>
<family>serif</family>
<prefer><family>Times New Roman</family></prefer>
</alias>
<alias>
<family>sans</family>
<prefer><family>Arial</family></prefer>
</alias>
<alias>
<family>monospace</family>
<prefer><family>Andale Mono</family></prefer>
</alias>
<match target="pattern">
<test name="family" compare="eq">
<string>Courier New</string>
</test>
<edit name="family" mode="prepend">
<string>monospace</string>
</edit>
</match>
<match target="pattern">
<test name="family" compare="eq">
<string>Courier</string>
</test>
<edit name="family" mode="prepend">
<string>monospace</string>
</edit>
</match>

</fontconfig>