Video Metadata Analysis Guide: Understanding Video Info with FFprobe

What is Video Metadata

Video metadata is data that describes video file properties and content. It contains various technical parameters and information tags about the video. Unlike the actual content such as video frames and audio, metadata is "data about data" — it records key information like the video's encoding method, resolution, duration, bitrate, and more.

Understanding video metadata is crucial for video processing, transcoding, streaming transmission, and other tasks. Whether you're a video editor, streaming engineer, or regular user, mastering metadata analysis skills helps us better understand and process video files.

Main Categories of Metadata

• Container Metadata: File format, creation time, file size, overall bitrate, etc.
• Video Stream Metadata: Codec format, resolution, frame rate, bitrate, color space, etc.
• Audio Stream Metadata: Codec format, sample rate, channel count, bitrate, etc.
• Subtitle Stream Metadata: Subtitle format, language, encoding method, etc.
• Descriptive Metadata: Title, artist, album, cover image, etc.

Container Information Analysis

A video container is a file format that encapsulates data streams like video, audio, and subtitles. Common container formats include MP4, MKV, AVI, MOV, WebM, etc. Different container formats support different codecs and functional features.

Common Container Format Comparison

• MP4: The most universal format with the best compatibility, supports H.264/H.265 video and AAC audio
• MKV: Open-source container format, supports almost all codecs, most feature-rich
• MOV: Format developed by Apple, commonly used in professional software like Final Cut Pro
• WebM: Open format by Google, mainly used for web video
• AVI: Older format, gradually being phased out

Video Stream Information Explained

The video stream is the core part of a video file, containing the encoded frame data. Understanding various parameters of the video stream is very important for video quality assessment and transcoding optimization.

Key Video Parameters

• Codec Format: H.264(AVC), H.265(HEVC), VP9, AV1, etc.
• Resolution: Video width and height, e.g., 1920x1080, 3840x2160
• Frame Rate: Frames displayed per second, common values: 24fps, 25fps, 30fps, 60fps
• Bitrate: Data volume per second, directly affects video quality and file size
• Color Space: e.g., BT.709, BT.2020, affects color representation range
• Bit Depth: 8bit, 10bit, 12bit, determines smoothness of color transitions

Audio Stream Information Analysis

The audio stream carries the sound information in a video, and its quality directly affects the viewing experience. A video file can contain multiple audio streams for different languages or tracks.

Common Audio Codec Formats

• AAC: The most commonly used lossy audio codec, standard for MP4 containers
• MP3: Classic audio format with excellent compatibility
• AC-3: Dolby Digital codec, commonly used in DVD and Blu-ray
• DTS: Another cinema-level audio codec
• FLAC: Lossless audio codec, larger files but perfect sound quality
• Opus: Efficient open-source audio codec, suitable for network transmission

Subtitle Stream Information

Subtitle streams are used to store subtitle data and support multiple languages and formats. Subtitles can be hard subtitles embedded in video frames, or independent soft subtitle streams.

Common Subtitle Formats

• SRT: The most commonly used text subtitle format, simple and easy to use
• ASS/SSA: Subtitle format supporting advanced styling
• VobSub: Graphic subtitle format from DVDs
• WebVTT: Subtitle format dedicated to web video
• PGS: Graphic subtitles used on Blu-ray discs

FFprobe Basic Commands

FFprobe is a powerful tool in the FFmpeg suite, specifically designed for analyzing and viewing metadata information of multimedia files. It supports almost all common video and audio formats and is an essential tool for video professionals.

Basic Information Viewing

The simplest way to use it is to directly type ffprobe followed by the filename in the command line:

ffprobe input.mp4

This command outputs basic information about the video file, including container format, duration, bitrate, and detailed parameters of each stream.

View Specific Stream Information

Use the -show_streams parameter to view detailed information of all streams:

ffprobe -show_streams input.mp4

View Only Video Stream

Use -select_streams v to display only video stream information:

ffprobe -select_streams v -show_streams input.mp4

JSON/CSV Output Formats

FFprobe supports multiple output formats for easy program parsing and data processing. JSON and CSV are the two most commonly used structured output formats.

JSON Format Output

Use the -print_format json parameter to output information in JSON format:

ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

JSON format output is easy for programming languages to parse and is very suitable for automated script processing.

CSV Format Output

Use -print_format csv to output comma-separated CSV format:

ffprobe -v quiet -print_format csv -show_streams input.mp4

CSV format can be directly imported into spreadsheet software like Excel for data analysis.

Common Analysis Scenarios

Scenario 1: Batch Get Video Duration

Using FFprobe combined with scripts can batch retrieve duration information of video files:

ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 input.mp4

Scenario 2: Detect Video Codec Format

Quickly determine which codec format a video uses, to decide whether transcoding is needed:

ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of default=noprint_wrappers=1:nokey=1 input.mp4

Scenario 3: Get Video Resolution

Extract video width and height information:

ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0 input.mp4

Scenario 4: Analyze Video Bitrate Distribution

Use -show_frames to analyze the size of each frame, thus understanding the bitrate distribution:

ffprobe -v error -show_frames -select_streams v:0 -print_format json input.mp4

Summary

Video metadata analysis is a fundamental skill for video processing, and FFprobe is the best tool for this task. Through this article, I believe you have mastered the basic usage of FFprobe and can analyze container, video stream, audio stream, and subtitle stream information of video files.

If you want to quickly view video metadata without installing FFmpeg, you can use our Video Metadata Viewer — simply upload a video file in your browser to get detailed metadata information.