Video Metadata Inspector
Inspect one local video for container and stream evidence, with bounded file reads plus clear warnings for sampled or missing metadata.A video file is a container holding one or more timed streams. The container may describe duration and track order, while each video or audio stream has its own codec, dimensions, rate, language, and other properties. A filename ending in .mp4 identifies a likely container, not the codec inside it and not whether a particular browser or device can decode every track.
| Term | What it describes | Common overread |
|---|---|---|
| Container | The file structure that stores tracks and descriptive fields, such as MP4, Matroska, or WebM. | A recognized container does not guarantee a supported codec. |
| Codec | The encoding used for one video or audio stream. | A recognized codec name does not prove that the current browser can decode it. |
| Coded dimensions | The stored pixel dimensions of encoded video samples. | They may differ from displayed dimensions after aspect-ratio adjustment and rotation. |
| Bitrate or frame rate | A rate reported by metadata or estimated from packet records. | A short sample may not represent a variable-rate file as a whole. |
| Embedded tag | Descriptive data such as title, artist, language, or a format-specific field. | Missing or present tags do not prove origin, authorship, or authenticity. |
Metadata inspection is useful before a delivery, upload, archive handoff, or playback investigation. It can reveal unexpected dimensions, rotation, extra audio tracks, an unknown codec, absent duration, or a mismatch between the browser MIME hint and the parsed container.
The report remains evidence rather than certification. It does not decode and watch the full programme, measure visual quality, confirm standards compliance, prove that timestamps are continuous, or guarantee playback on another device.
How to Use This Tool:
Choose the file that will actually be delivered or investigated, not a renamed copy whose contents may differ.
- Select one MP4, MOV, M4V, MKV, WebM, MPEG-TS, MTS, or M2TS video no larger than 512 MB.
- Keep Additional packet samples at 0 for the default 120-record sample. Add 120, 240, or 360 only when a longer sample is worth the extra read work for variable-rate evidence.
- Wait for the inspection to finish. A corrupt file, unsupported container, missing video track, 15-second timeout, or 32 MB read budget produces a corrective message instead of a partial success claim.
- Start with the container and stream counts, then follow any missing-field or sampling warning to the corresponding evidence row before using a value in a ticket or delivery note.
Interpreting Results:
Prefer values read directly from the container or track metadata when they answer the question. When average bitrate is absent, a packet sample supplies an estimate instead. Frame rate is also sampled here, so the attached packet count and warning matter when the source uses variable frame rate.
- Not reported means the bounded inspection did not obtain a usable value. It does not prove that the underlying media has no equivalent information.
- Browser decode support applies to the current browser and its available decoders. Another application or device may differ.
- A low missing-field count describes report completeness, not video quality, authenticity, or delivery readiness.
Technical Details:
Metadata values are gathered through bounded, lazy reads from the selected file. The inspector identifies the container, enumerates tracks, reads available file and track fields, and samples encoded packet statistics only where the report needs rate evidence. It does not scan the entire file to invent a duration that the container did not report.
Lookup Core:
| Evidence group | Lookup | Limit |
|---|---|---|
| File | Name, browser MIME hint, file size, and bytes read. | The MIME hint comes from the browser and may be blank or inaccurate. |
| Container | Parsed format, MIME description, metadata duration, and track count. | Duration remains unreported when the container does not expose it within the bounded path. |
| Video stream | Codec identifiers, duration, dimensions, rotation, color-space fields, HDR signal, and decode support. | A false HDR signal can mean absent or insufficient color metadata rather than definite standard dynamic range. |
| Audio stream | Codec identifiers, duration, channel count, sample rate, language, and decode support. | The report does not listen to or validate the decoded programme. |
| Packet sample | Average packet rate and fallback average bitrate from 120 to 480 records per video stream. | The sample may miss later rate changes. |
| Tags | Bounded normalized and raw descriptive values. | At most 64 tags are retained and long text is limited to 300 characters. |
The evidence model accepts up to 24 tracks, including at most 8 video and 16 audio tracks. Metadata duration is bounded at 24 hours, individual reads at 4 MB, cumulative reads at 32 MB, warnings at 50, and the inspection at 15 seconds.
Counts, missing-field totals, and warning totals are exact counts of the bounded report records. Container and stream values are retrieved from the file or packet sample; there is no universal equation that can reconstruct metadata the source does not expose.
Accuracy and Privacy Notes:
The selected video stays on the device and is read only in bounded ranges. It is not uploaded or placed in the shareable URL, and file resources are released after inspection or cancellation.
A deeper media probe may still be necessary for variable-rate analysis, frame-by-frame timing, damaged indexes, full tag extraction, or formal conformance testing. Keep the parser version and sampling warning with any value copied into a diagnostic record.
References:
- Reading media files, Mediabunny.
- MetadataTags, Mediabunny.
- File API, World Wide Web Consortium.