FFprobe命令参数使用指南

1. ffprobe 是什么 ？

简单的说，ffprobe 是一个多媒体流分析工具。它从多媒体流中收集信息，并且以人类和机器可读的形式打印出来。

它可以用来检测多媒体流的容器类型，以及每一个多媒体流的格式和类型。它可以作为一个独立的应用来使用，也可以结合文本过滤器执行更复杂的处理。

2. ffprobe 的使用方式

命令行： ffprobe [选项] [‘输入文件’]

3. ffprobe 可使用的选项

3.1 流指示符

流指示符用来精确的指定一个给定的选项是属于哪个(些)流。

一个流指示符通常是一个字符串附加到一个选项名的后面，并且以“:”进行分割。例如：-codec:a:1 ac3 包含流指示符 a:1 ，它将匹配第二个音频流。因此，它将为第二个音频流指定 ac3 codec。

一个流指示符可以匹配多个流，这样，给定的选项会被应用到所有的匹配流上。例如：-b:a 128k 中的流指示符将匹配所有的音频流。

一个空流指示符将匹配所有的流。例如：-codec copy 或 -codec: copy 将拷贝所有的流，而不会对它们重新编码。

可能的流指示符的形式:

view sourceprint?

01.‘stream_index’  匹配具有该索引值的流。例如：-threads:1 4 将为第二个流设置线程数为4。

02.‘stream_type[:stream_index]’

03.stream_type 是下面的其中之一：’v’ 视频, ’a’ 音频, ’s’ 字幕, ’d’ 数据,

04.’t’ 附件。如果给定 stream_index ，它将匹配该类型下的索引号为

05.stream_index 的流，否则，它将匹配该类型的所有流。

06.‘p:program_id[:stream_index]’

07.如果给定 stream_index ，它将匹配 id 为 program_id 的 program 下的索

08.引号为 stream_index 的流，否则，它将匹配该 program 下的所有流。

09.‘#stream_id or i:stream_id’  使用流 id 进行匹配(例如：MPEG-TS 容器中的 PID )

3.2 通用选项

ff* 工具的通用选项是共享的。(FFplay)

view sourceprint?

01.‘-L’    显示 license

02.‘-h, -?, -help, --help [arg]’ 打印帮助信息；可以指定一个参数 arg ，如果不指定，只打印基本选项

03.可选的 arg 选项：

04.‘long’    除基本选项外，还将打印高级选项

05.‘full’    打印一个完整的选项列表，包含 encoders, decoders, demuxers, muxers, filters 等的

06.共享以及私有选项

07.‘decoder=decoder_name’    打印名称为 “decoder_name” 的解码器的详细信息

08.‘encoder=encoder_name’    打印名称为 “encoder_name” 的编码器的详细信息

09.‘demuxer=demuxer_name’    打印名称为 “demuxer_name” 的 demuxer 的详细信息

10.‘muxer=muxer_name’        打印名称为 “muxer_name” 的 muxer 的详细信息

11.‘filter=filter_name’      打印名称为 “filter_name” 的过滤器的详细信息

12. 

13.‘-version’     显示版本信息

14.‘-formats’     显示有效的格式

15.‘-codecs’      显示 libavcodec 已知的所有编解码器

16.‘-decoders’    显示有效的解码器

17.‘-encoders’    显示有效的编码器

18.‘-bsfs’        显示有效的比特流过滤器

19.‘-protocols’   显示有效的协议

20.‘-filters’     显示 libavfilter 有效的过滤器

21.‘-pix_fmts’    显示有效的像素格式

22.‘-sample_fmts’ 显示有效的采样格式

23.‘-layouts’     显示通道名称以及标准通道布局

24.‘-colors’      显示认可的颜色名称

25.‘-hide_banner’ 禁止打印欢迎语；也就是禁止默认会显示的版权信息、编译选项以及库版本信息等

3.3 一些主要选项

view sourceprint?

01.‘-f format’    强制使用的格式

02.‘-unit’        显示值的单位

03.‘-prefix’      显示的值使用标准国际单位制词头

04.‘-byte_binary_prefix’ 对字节值强制使用二进制前缀

05.‘-sexagesimal’ 时间值使用六十进位的格式 HH:MM:SS.MICROSECONDS

06.‘-pretty’      美化显示值的格式。它相当于 "-unit -prefix -byte_binary_prefix -sexagesimal"

07.‘-of, -print_format writer_name[=writer_options]’

08.设置输出打印格式。writer_name 指定打印程序 (writer) 的名称，writer_options

09.指定传递给 writer 的选项。例如：将输出打印为 JSON 格式：-print_format json

10.‘-select_streams stream_specifier’

11.只选择 stream_specifier 指定的流。该选项只影响那些与流相关的选项

12.(例如：show_streams, show_packets, 等)。

13.举例：只显示音频流，使用命令：

14.ffprobe -show_streams -select_streams a INPUT

15.‘-show_data’ 显示有效载荷数据，以十六进制和ASCII转储。与 ‘-show_packets’ 结合使用，它将

16.dump 包数据；与 ‘-show_streams’ 结合使用，它将 dump codec 附加数据。

17.‘-show_error’    显示探测输入文件时的错误信息

18.‘-show_format’   显示输入多媒体流的容器格式信息

19.‘-show_packets’  显示输入多媒体流中每一个包的信息

20.‘-show_frames’   显示输入多媒体流中的每一帧以及字幕的信息

21.‘-show_streams’  显示输入多媒体流中每一个流的信息

22.‘-show_programs’ 显示输入多媒体流中程序以及它们的流的信息

23.‘-show_chapters’ 显示格式中存储的章节信息

24.‘-count_frames’  计算每一个流中的帧数，在相应的段中进行显示

25.‘-count_packets’ 计算每一个流中的包数，在相应的段中进行显示

26.‘-show_program_version’   显示程序版本及配置相关信息

27.‘-show_library_versions’  显示库版本相关信息

28.‘-show_versions’          显示程序和库版本相关信息。相当于同时设置‘-show_program_version’ 和

29.‘-show_library_versions’

30.‘-i input_file’           指定输入文件

4. 打印程序(Writers)

一个 writer 定义了 ffprobe 所使用的输出格式。

它可以接受一个或多个参数，这些参数以 key=value 的形式指定，以“:”分隔。所有的 writers 都支持以下选项:

view sourceprint?

1.‘string_validation, sv’ 设置字符串验证模式

2.它可以接受以下值：(默认为 replace)

3.‘fail’ 当发现无效字符串(UTF-8)序列或代码点时，立即失败。这个对于验证输入 metadata 非常有用。

4.‘ignore’ 任何验证错误都将被忽略。

5.‘replace’ writer 将使用 ‘string_validation_replacement’ 所指定的字符串替代无效的UTF-8序列或者代码点。

6. 

7.‘string_validation_replacement, svr’ 设置替代字符串，当 ‘string_validation’ 设置为 ‘replace’ 时使用。

以下为目前可以使用的 writers ：

view sourceprint?

01.4.1 default

02.默认格式。按照以下形式打印每个 section ：

03.[SECTION]

04.key1=val1

05....

06.keyN=valN

07.[/SECTION]

08. 

09.4.2 compact, csv

10.紧凑与CSV格式。每个 section 打印在一个单独的行。如果不指定其他选项，其输入格式如下：

11.section|key1=val1| ... |keyN=valN

12. 

13.4.3 Flat

14.一种自由格式输出，每一行包含一个明确的 key=value 对。

15. 

16.4.4 ini

17.INI 格式输出。

18. 

19.4.5 json

20.JSON 格式输出。每一个 section 使用 JSON 符号来打印。

21. 

22.4.6 xml

23.XML 格式输出。

24. 

25.各 writer 可接受的选项，请查阅 ffprobe 文档

5. ffprobe 使用示例

view sourceprint?

01.1) 最简单的使用方式

02.ffprobe test.mp4

03. 

04.2) 不显示欢迎信息

05.ffprobe -hide_banner test.mp4

06. 

07.3) 以 JSON 格式显示每个流的信息

08.ffprobe -print_format json -show_streams test.mp4

09. 

10.4) 显示容器格式相关信息

11.ffprobe -show_format test.mp4     

更多 ffprobe 选项，可以使用 ffprobe -h 获取