ffprobe 也是FFMPEG源码编译后生成的一个可执行程序。ffprobe 是一个非常强大的多媒体分析工具,可以从媒体文件或者媒体流中获得你想要了解的媒体信息,比如音频的参数、视频的参数、媒体容器的参数信息等。
例如它可以帮助分析某个媒体容器中的音频是什么编码格式、视频是什么编码格式,同时还可以得到媒体文件中媒体的总时长、复合码率等信息。
如果在输入中指定了 url,ffprobe 将尝试打开并探测 url 内容。如果 url 无法打开或识别为多媒体文件,则返回一个肯定的退出代码。
详细使用可以参考官方提供的教程:ffprobe Documentation
一、ffprobe的选项
命令行: ffprobe [选项] [‘输入文件’]
1、通用选项
‘-L’ 显示 license
‘-h, -?, -help, --help [arg]’ 打印帮助信息;可以指定一个参数 arg ,如果不指定,只打印基本选项
可选的 arg 选项:
‘long’ 除基本选项外,还将打印高级选项
‘full’ 打印一个完整的选项列表,包含 encoders, decoders, demuxers, muxers, filters 等的
共享以及私有选项
‘decoder=decoder_name’ 打印名称为 “decoder_name” 的解码器的详细信息
‘encoder=encoder_name’ 打印名称为 “encoder_name” 的编码器的详细信息
‘demuxer=demuxer_name’ 打印名称为 “demuxer_name” 的 demuxer 的详细信息
‘muxer=muxer_name’ 打印名称为 “muxer_name” 的 muxer 的详细信息
‘filter=filter_name’ 打印名称为 “filter_name” 的过滤器的详细信息
‘-version’ 显示版本信息
‘-formats’ 显示有效的格式
‘-codecs’ 显示 libavcodec 已知的所有编解码器
‘-decoders’ 显示有效的解码器
‘-encoders’ 显示有效的编码器
‘-bsfs’ 显示有效的比特流过滤器
‘-protocols’ 显示有效的协议
‘-filters’ 显示 libavfilter 有效的过滤器
‘-pix_fmts’ 显示有效的像素格式
‘-sample_fmts’ 显示有效的采样格式
‘-layouts’ 显示通道名称以及标准通道布局
‘-colors’ 显示认可的颜色名称
‘-hide_banner’ 禁止打印欢迎语;也就是禁止默认会显示的版权信息、编译选项以及库版本信息等
2、主要选项
‘-f format’ 强制使用的格式
‘-unit’ 显示值的单位
‘-prefix’ 显示的值使用标准国际单位制词头
‘-byte_binary_prefix’ 对字节值强制使用二进制前缀
‘-sexagesimal’ 时间值使用六十进位的格式 HH:MM:SS.MICROSECONDS
‘-pretty’ 美化显示值的格式。它相当于 "-unit -prefix -byte_binary_prefix -sexagesimal"
‘-of, -print_format writer_name[=writer_options]’
设置输出打印格式。writer_name 指定打印程序 (writer) 的名称,writer_options
指定传递给 writer 的选项。例如:将输出打印为 JSON 格式:-print_format json
‘-select_streams stream_specifier’
只选择 stream_specifier 指定的流。该选项只影响那些与流相关的选项
(例如:show_streams, show_packets, 等)。
举例:只显示音频流,使用命令:
ffprobe -show_streams -select_streams a INPUT
‘-show_data’ 显示有效载荷数据,以十六进制和ASCII转储。与 ‘-show_packets’ 结合使用,它将
dump 包数据;与 ‘-show_streams’ 结合使用,它将 dump codec 附加数据。
‘-show_error’ 显示探测输入文件时的错误信息
‘-show_format’ 显示输入多媒体流的容器格式信息
‘-show_packets’ 显示输入多媒体流中每一个包的信息
‘-show_frames’ 显示输入多媒体流中的每一帧以及字幕的信息
‘-show_streams’ 显示输入多媒体流中每一个流的信息
‘-show_programs’ 显示输入多媒体流中程序以及它们的流的信息
‘-show_chapters’ 显示格式中存储的章节信息
‘-count_frames’ 计算每一个流中的帧数,在相应的段中进行显示
‘-count_packets’ 计算每一个流中的包数,在相应的段中进行显示
‘-show_program_version’ 显示程序版本及配置相关信息
‘-show_library_versions’ 显示库版本相关信息
‘-show_versions’ 显示程序和库版本相关信息。相当于同时设置‘-show_program_version’ 和
‘-show_library_versions’
‘-i input_file’ 指定输入文件
二、使用示例
1) 最简单的使用方式
ffprobe test.mp4
2) 不显示欢迎信息
ffprobe -hide_banner test.mp4
3) 以 JSON 格式显示每个流的信息
ffprobe -print_format json -show_streams test.mp4
4) 显示容器格式相关信息
ffprobe -show_format test.mp4
5) 只输出该视频的size信息(-v error 表示略去了 build 和 generic 信息,暴露 error 错误)
ffprobe -v error -show_entries format=size -of default=noprint_wrappers=1 test.mp4
三、实际用例
ffprobe -print_format json -show_format -show_streams -i test.mp4
输出结果如下:
ffprobe version 4.1.3 Copyright (c) 2007-2019 the FFmpeg developers
built with gcc 8.3.1 (GCC) 20190414
configuration: --enable-gpl --enable-version3 --enable-sdl2 --enable-fontconfig --enable-gnutls --enable-iconv --enable-libass --enable-libbluray --enable-libfreetype --enable-libmp3lame --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-libopenjpeg --enable-libopus --enable-libshine --enable-libsnappy --enable-libsoxr --enable-libtheora --enable-libtwolame --enable-libvpx --enable-libwavpack --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxml2 --enable-libzimg --enable-lzma --enable-zlib --enable-gmp --enable-libvidstab --enable-libvorbis --enable-libvo-amrwbenc --enable-libmysofa --enable-libspeex --enable-libxvid --enable-libaom --enable-libmfx --enable-amf --enable-ffnvcodec --enable-cuvid --enable-d3d11va --enable-nvenc --enable-nvdec --enable-dxva2 --enable-avisynth
libavutil 56. 22.100 / 56. 22.100
libavcodec 58. 35.100 / 58. 35.100
libavformat 58. 20.100 / 58. 20.100
libavdevice 58. 5.100 / 58. 5.100
libavfilter 7. 40.101 / 7. 40.101
libswscale 5. 3.100 / 5. 3.100
libswresample 3. 3.100 / 3. 3.100
libpostproc 55. 3.100 / 55. 3.100
{
Input #0, mov,mp4,m4a,3gp,3g2,mj2, from 'test.mp4':
Metadata:
major_brand : isom
minor_version : 512
compatible_brands: isomiso2avc1mp41
encoder : Lavf58.20.100
Duration: 00:00:05.50, start: 0.000000, bitrate: 523 kb/s
Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 720x640 [SAR 512:309 DAR 192:103], 450 kb/s, 10 fps, 10 tbr, 10240 tbn, 20 tbc (default)
Metadata:
handler_name : VideoHandler
Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, mono, fltp, 69 kb/s (default)
Metadata:
handler_name : SoundHandler
"streams": [
{
"index": 0,
"codec_name": "h264",
"codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"profile": "High",
"codec_type": "video",
"codec_time_base": "1/20",
"codec_tag_string": "avc1",
"codec_tag": "0x31637661",
"width": 720,
"height": 640,
"coded_width": 720,
"coded_height": 640,
"has_b_frames": 2,
"sample_aspect_ratio": "512:309",
"display_aspect_ratio": "192:103",
"pix_fmt": "yuv420p",
"level": 31,
"chroma_location": "left",
"refs": 1,
"is_avc": "true",
"nal_length_size": "4",
"r_frame_rate": "10/1",
"avg_frame_rate": "10/1",
"time_base": "1/10240",
"start_pts": 0,
"start_time": "0.000000",
"duration_ts": 56320,
"duration": "5.500000",
"bit_rate": "450280",
"bits_per_raw_sample": "8",
"nb_frames": "55",
"disposition": {
"default": 1,
"dub": 0,
"original": 0,
"comment": 0,
"lyrics": 0,
"karaoke": 0,
"forced": 0,
"hearing_impaired": 0,
"visual_impaired": 0,
"clean_effects": 0,
"attached_pic": 0,
"timed_thumbnails": 0
},
"tags": {
"language": "und",
"handler_name": "VideoHandler"
}
},
{
"index": 1,
"codec_name": "aac",
"codec_long_name": "AAC (Advanced Audio Coding)",
"profile": "LC",
"codec_type": "audio",
"codec_time_base": "1/44100",
"codec_tag_string": "mp4a",
"codec_tag": "0x6134706d",
"sample_fmt": "fltp",
"sample_rate": "44100",
"channels": 1,
"channel_layout": "mono",
"bits_per_sample": 0,
"r_frame_rate": "0/0",
"avg_frame_rate": "0/0",
"time_base": "1/44100",
"start_pts": 0,
"start_time": "0.000000",
"duration_ts": 232672,
"duration": "5.276009",
"bit_rate": "69929",
"max_bit_rate": "69929",
"nb_frames": "229",
"disposition": {
"default": 1,
"dub": 0,
"original": 0,
"comment": 0,
"lyrics": 0,
"karaoke": 0,
"forced": 0,
"hearing_impaired": 0,
"visual_impaired": 0,
"clean_effects": 0,
"attached_pic": 0,
"timed_thumbnails": 0
},
"tags": {
"language": "und",
"handler_name": "SoundHandler"
}
}
],
"format": {
"filename": "test.mp4",
"nb_streams": 2,
"nb_programs": 0,
"format_name": "mov,mp4,m4a,3gp,3g2,mj2",
"format_long_name": "QuickTime / MOV",
"start_time": "0.000000",
"duration": "5.500000",
"size": "359688",
"bit_rate": "523182",
"probe_score": 100,
"tags": {
"major_brand": "isom",
"minor_version": "512",
"compatible_brands": "isomiso2avc1mp41",
"encoder": "Lavf58.20.100"
}
}
}