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.
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.

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 errorhides standard startup banners and only prints errors alongside the requested data.-show_formatoutputs container-level details such as total duration, file size, and muxing format.-show_streamslists every individual video, audio, or subtitle track inside the container.-of jsonformats 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"
- If
"streams": []is empty: The file contains no audio track at all. If you downloaded a separate video-only stream, you will need to re-download a combined option or merge an audio stream. See X Video Downloader With Audio for choosing combined formats. - If an audio stream is listed: Note the
codec_nameandchannels. Some built-in OS players struggle withopusin an MP4 container or multi-channelac3audio. Review MP4 Has Picture but No Sound? Check the File and the Player and AC3 vs AAC: Audio Compatibility to test playback in another player.
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
AC3 vs AAC: Audio Compatibility, Surround Sound and Passthrough
Compare AC3 and AAC for local media: check player and container support, understand passthrough, and decide whether to preserve or re-encode an audio track.
CBR vs VBR: Bitrate, File Size and Quality for Local Video Workflows
Compare CBR and VBR data allocation, distinguish constant quality from average bitrate, and inspect local video without guessing from one bitrate value.
X Video Downloader With Audio: Save Twitter Video With Sound
Download an X/Twitter video with sound: confirm source audio, choose a combined audio-video output when available, and verify the saved file before keeping it.
MP4 Has Picture but No Sound? Check the File and the Player
Diagnose why a saved MP4 shows video without sound. Compare playback, inspect its audio stream and decide whether you need an authorized original.