What is FFprobe?

ffprobe is a command-line tool that ships with FFmpeg and reports what is inside a media file: its format, duration, codecs, resolution, frame rate and bitrate. It does not change the file.

How FFprobe works

ffprobe opens a file the same way FFmpeg does, reads the container’s headers and the first packets of each stream, and prints what it finds. Because it does not decode the whole file, it is fast even on large videos. The output can be plain text, JSON, CSV or XML, and you can limit it to the fields you need.

Key facts

  1. ffprobe -v error -show_format -show_streams -of json input.mp4 prints everything about a file as JSON.
  2. ffprobe -v error -show_entries format=duration -of csv=p=0 input.mp4 prints only the duration in seconds.
  3. ffprobe is installed together with FFmpeg, so if the ffmpeg command works, ffprobe normally does too.

When FFprobe matters

Run ffprobe to check a file before processing it, or to read values such as duration and resolution in a script. Ask for JSON output when another program will read the result.

Turn media knowledge into a working pipeline

Connect uploads, processing, AI, storage, and delivery through one declarative API — with the encoding stack, scaling, and format churn handled for you.

Try Transloadit for free