Guides

How to Inspect a Saved Video with ffprobe

Run ffprobe on a saved local video file to inspect container format, video resolution, audio codecs, and stream counts in JSON.

Last updated
2026-11-16
Author
AnyVidDL content team

Run ffprobe with -show_format, -show_streams, and -of json against your local video file to inspect its container format, codecs, resolution, duration, and audio channels. Use -select_streams a to isolate audio tracks when troubleshooting silent playback.

Concept diagram separating video and audio streams from playback checks
Concept illustration of video and audio components; not a software screenshot or a measured outcome.

When to inspect a local file with ffprobe

When a downloaded or exported video file shows a black screen, plays without sound, or ends earlier than expected, the file extension alone (.mp4 or .mkv) will not tell you what is inside. ffprobe—part of the FFmpeg toolset—reads the file headers and stream descriptors so you can see whether an audio track is actually missing or just encoded in a format your media player refuses to play.

Before starting, make sure ffprobe is installed in your system PATH and that you are inspecting a local media file you have permission to use. Full command flag references are available in the Official ffprobe options documentation.

Run a full container and stream inspection

Open your terminal or command prompt and run the following command, replacing saved-video.mp4 with the path to your local file:

ffprobe -v error -show_format -show_streams -of json "saved-video.mp4"

Each flag serves a specific purpose:

  • -v error hides standard startup banners and only prints errors alongside the requested data.
  • -show_format outputs container-level details such as total duration, file size, and muxing format.
  • -show_streams lists every individual video, audio, or subtitle track inside the container.
  • -of json formats the output as structured JSON so it is easy to read or save.

Key JSON fields to check

A typical response contains a streams array followed by a format object:

{
  "streams": [
    {
      "index": 0,
      "codec_name": "h264",
      "codec_type": "video",
      "width": 1920,
      "height": 1080,
      "duration": "42.080000"
    },
    {
      "index": 1,
      "codec_name": "aac",
      "codec_type": "audio",
      "sample_rate": "48000",
      "channels": 2,
      "channel_layout": "stereo"
    }
  ],
  "format": {
    "filename": "saved-video.mp4",
    "nb_streams": 2,
    "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
    "duration": "42.105000",
    "size": "15482910",
    "bit_rate": "2941771"
  }
}

Use this table to interpret the most important fields when diagnosing a file:

JSON field Location What it tells you
nb_streams format Total number of tracks inside the container. If nb_streams is 1 on a video file, there is likely no audio track mixed in.
format_name format The actual container family (mov,mp4... or matroska,webm), regardless of what filename extension was used.
duration & size format Total reported runtime in seconds and byte size. Compare these against the expected length to spot truncated transfers.
codec_type streams[] Identifies whether a track is video, audio, or subtitle.
codec_name streams[] The compression format, such as h264, hevc, vp9, av1 for video, or aac, opus, ac3 for audio.
width & height streams[] (video) Pixel dimensions of the video stream, confirming whether a clip is actually 1080p or 720p.
channels & sample_rate streams[] (audio) Audio channel count (e.g., 2 for stereo, 6 for 5.1 surround) and sampling frequency in Hz.

Isolate audio streams when troubleshooting silent video

If a video plays with picture but no sound, filter the output to audio tracks only by adding -select_streams a:

ffprobe -v error -select_streams a -show_streams -of json "saved-video.mp4"

Why header metadata is not a substitute for playback

ffprobe inspects container headers and stream metadata without decoding the entire media timeline. A file whose header reports a 60-second duration and a valid aac stream can still fail halfway through playback if the download was cut off abruptly or if audio frames are silent or corrupted. Always follow up an ffprobe check by scrubbing through the beginning, middle, and end of the file in a media player.

FAQ

What does an empty streams array mean when running -select_streams a?

An empty `"streams": []` result means the container has no audio track at all. The file is video-only, so changing media players or volume settings will not produce sound.

How can I check specific fields like codec and resolution without printing the full JSON?

Use `-show_entries` to limit output to exact keys. For example: `ffprobe -v error -show_entries stream=index,codec_type,codec_name,width,height -of json "saved-video.mp4"`.

Why does ffprobe show an audio stream even though my video plays silently?

Either your media player does not support that specific audio codec inside the container (such as Opus or AC3 in certain default players), or the recorded audio track itself contains silent waveform data.

Related pages