ffprobe is the inspection tool that ships with FFmpeg. It reads a file's container and stream headers and prints them without decoding the picture. -show_format -show_streams -of json prints everything as JSON, -show_entries picks the fields you name and -of csv=p=0 prints a bare value. Every command below ran on the same 60-second clip, and each result is what it printed.
Video info, read in your browsernothing is uploaded
139 lines of JSON: a streams array, 37 keys for the video stream and 26 for the audio, then format with duration60.000000, size17637003, bit_rate2351600 and the container tags.
Sections
streams, format
Video stream
37 keys
Run time
64 ms
Chosen fieldsRead only
You know the fields your code reads. It prints those and nothing else.
Returns immediately with a job id. Poll GET /jobs/{id} or register a webhook rather than blocking on the request.
Every variant
Pick the command for your case
Each one ran on the same input. The line under it is what came out. Run times are the best of three runs with FFmpeg 8.0 on one desktop machine, so read them as relative.
Prints 60.000000 and nothing else, ready for a script. The video stream keeps its own duration, and container vs stream duration in ffprobe shows when the two disagree.
Returns width 1280, height 720 and a side_data_list entry with rotation 90. Players show it 720x1280.
77 ms run
Gotchas
Where it goes wrong
Why does plain ffprobe print nothing to my script?
With no -show_ flag and no -show_entries, ffprobe writes its summary to stderr and leaves stdout empty:
ffprobein.mp4
0 bytes on stdout. The banner, Duration: 00:01:00.00, start: 0.000000, bitrate: 2351 kb/s and one line per stream all went to stderr, which a script reading stdout never sees.
Ask for a section and pick a writer, as every command on this page does, and the report lands on stdout. -v error then keeps stderr empty unless something is wrong.
Why does the JSON have empty programs and stream_groups arrays?
ffprobe 8.0 adds both arrays, empty, when the command uses -show_entries. The chosen-fields command above printed them. The full report from -show_format -show_streams printed only streams and format. Read the keys you asked for and ignore the rest.
Most numbers arrive as strings. duration, size, bit_rate and nb_frames are quoted ("60.000000"), while width, height, channels and nb_streams are plain integers. Parse each field to the type you need.
Picking an ffprobe output format runs json, csv, flat and default on one file, including what csv does with a comma inside a value.
Why does ffprobe return empty JSON and no error?
-v quiet hides the error along with the banner. On a text file renamed to fake.mp4:
The same empty object and exit code 1, and stderr says moov atom not found and Invalid data found when processing input.
To get the reason inside the JSON, add -show_error:
ffprobe-vquiet-show_error-ofjsonfake.mp4
An error object with code -1094995529 and stringInvalid data found when processing input.
Check the exit code before you parse anything, and use -v error in scripts so a bad file explains itself. Validating uploads with ffprobe turns these checks into one job that rejects a renamed file.
Which frame count should I trust?
On an MP4 all three agree. nb_frames, -count_packets and -count_frames each printed 1440 for the test clip. They differ in what they read and in where they work.
nb_frames comes from the container's index. Nothing is read beyond the header.
-count_packets reads every packet in the stream and counts them. No decoding.
-count_frames decodes every frame. Use it only when you need the number of frames a decoder actually produces.
Matroska has no per-stream frame count in its header, so the fast way comes back empty:
60.021000. The MP4 of the same streams says 60.000000. Matroska counts the end of the last audio frame.
The per-stream value is a tag: -show_entries stream_tags=DURATION printed 00:01:00.021000000, as text.
On MP4s with sound the container and the video stream disagree too. Container vs stream duration in ffprobe measures that gap and says which number to cut against.
Why does ffprobe say my portrait video is landscape?
width and height describe the picture as stored. Phones store most portrait video sideways and add a rotation for players to apply. FFmpeg 8.0 reports it in side data, not as the old rotate tag:
width 1280, height 720, rotation 90. Swap width and height when the rotation is 90 or -90.
You do not need to rotate anything yourself when you process the file. FFmpeg applies the rotation as it decodes: a frame extracted from phone.mp4 came out 720x1280.
Why are the values printed in a different order than I asked?
-show_entries picks which fields to print, not their order. ffprobe prints them in its own order:
1280,546. Width first, though the command asked for height first.
With -of csv, read fields by position in ffprobe's order, or switch to -of json or -of default=nw=1 and read them by name. The format section also prints after all the streams, whatever order you wrote it in.
It tells you what a media file holds before you process it: the container, and each stream's codec, resolution, frame rate, duration, bitrate, language and rotation. Scripts call it to reject files that are not real video, to pick encoder settings and to find the timestamps to cut at. It changes nothing in the file.
Is ffprobe included with FFmpeg?
Yes. ffprobe is built from the same source as ffmpeg and ships beside it, so a machine with FFmpeg has both. ffprobe -version printed ffprobe version 8.0 on the machine that ran this page. A Rendobar ffprobe job needs no install on your side: it runs the same command on our machines.
Can ffprobe read a video from a URL?
Yes. ffprobe opens http and https URLs and reads only the parts it needs. The duration command printed 60.000000 for this page's in.mp4 straight from its CDN address. A Rendobar ffprobe job takes the URL inside the command and probes it over the network the same way, and downloads the file first only when that fails, for example on a server that rejects range requests.
What does a Rendobar ffprobe job return?
The sections your command asked for, as JSON in output.data. A command that leaves flags out gets -v error, JSON output and -show_format -show_streams -show_chapters added, so a bare URL returns the full report. With format and streams present the job adds a summary. For the 5-second sample clip it read h264 at 1280x720, 24 fps, rotation 0, not HDR, with AAC stereo at 48000 Hz. A csv or flat writer returns ffprobe's text as stdout instead.
Your command. Our infrastructure.
Bring your own commands. Run them on scalable CPU and GPU infrastructure, and pay only for compute time.