Skip to content
Owais KhanSoftware Reviews

Spatial Video Metadata Viewer

Drop any MP4 or MOV file to check its spatial video metadata — no upload, no account, no CLI tools. This MV-HEVC metadata checker walks the box tree and tells you whether the file carries the lhvC and stri atoms that Apple Vision Pro and Meta Quest require for true stereoscopic playback.

Everything runs locally: what you paste never leaves your browser.

Check stereo video metadata online

Drop an MP4 or MOV file here

or click to browse — file stays on your device

Valid Spatial Videoexample-spatial.mov

What to do

No action needed. This file contains MV-HEVC stereoscopic metadata and should play correctly on Apple Vision Pro and Meta Quest.

moovMovie container✓ present
hvcCHEVC config✓ present
lhvCLayer HEVC (spatial)✓ present
striStereo track info✓ present
heroHero-eye indicator✓ present

Tracks found: 1(spatial video needs ≥ 2)

MP4/MOV box tree — 10 atoms found
TypeOffsetSizeDescription
ftyp016File type and compatibility brands
moov1688Movie container — root of all metadata
trak2480Track container
mdia3272Media information container
minf4064Media info container
stbl4856Sample table container
hvcC5612HEVC decoder configuration (H.265)
lhvC6812Layer HEVC config — signals MV-HEVC spatial encoding
stri8012Stereo track info — marks left/right eye assignment
hero9212Hero-eye indicator — preferred eye for 2D fallback

How this spatial video metadata viewer works

MP4 and MOV files are built from nested "boxes" (also called atoms). Each box starts with a 4-byte big-endian size followed by a 4-byte ASCII type string. This tool reads the raw bytes of your file in the browser, walks the box tree, and looks for the atoms that signal spatial stereoscopic video.

The two critical atoms are lhvC (layer HEVC configuration) andstri (stereo track info). lhvC proves the file carries two independent HEVC layers — one for each eye. stri assigns each track to a left or right eye role. Without both, a headset cannot automatically route the layers to the correct display. The hero atom is optional but recommended: it tells the platform which eye to show when the video is displayed in a 2D context.

This Apple Vision Pro spatial video checker classifies files into four states: Valid Spatial Video (lhvC + stri present), Missing Stereoscopic Tag (one of the two is absent), Standard HEVC (only hvcC, no spatial atoms), and Not a video file (no moov container or no HEVC codec at all). Each state comes with a plain-English fix instruction.

MV-HEVC vs standard HEVC

Standard H.265/HEVC encodes a single video layer. Multi-View HEVC (MV-HEVC) extends the codec to carry multiple views — typically a base layer (one eye) and a dependent layer (the other eye) — inside a single MP4 track structure. The lhvC box is the container-level signal that the file uses this multi-layer encoding. A file that lacks it may still look like a side-by-side or over-under stereo video, but the headset has no machine-readable proof and will treat it as 2D.

If you have been searching for a Spatial Media Metadata Injector online to add these atoms after the fact, be aware that injecting metadata into a file that was not encoded as MV-HEVC will not create true spatial video — the encoder must produce two separate eye layers. The metadata atoms are a description of what the encoder did, not a transformation of the video itself.

Check stereo video metadata online — without uploading

Most check stereo video metadata online workflows involve uploading to a server, waiting for processing, and trusting a third party with potentially private footage. This tool does none of that. The File API hands the raw bytes to a JavaScript box parser running inside this page. The parser needs only the first few kilobytes of the file to find the box tree — it never reads the video frames themselves — and the result appears immediately.

Frequently asked questions

How can I tell if my video is encoded as true spatial MV-HEVC or standard 2D?
Drop the file into this spatial video metadata viewer online. The tool walks the MP4/MOV box tree and looks for two atoms that only appear in genuine MV-HEVC files: lhvC (layer HEVC configuration) and stri (stereo track info). If both are present the file is classified as Valid Spatial Video. If only hvcC is found without lhvC, the file is standard single-layer HEVC — it may look like a side-by-side video but it carries no stereoscopic signalling that a headset can act on automatically.
Why does my stereoscopic video play flat on Apple Vision Pro?
Apple Vision Pro reads the lhvC and stri metadata atoms to know how to route the left-eye and right-eye HEVC layers to each display. If either atom is absent the system has no machine-readable proof the file is stereoscopic and falls back to treating it as a 2D video. This MV-HEVC metadata checker will tell you exactly which atoms are missing. The fix is to re-encode with spatial video flags enabled — for example using Final Cut Pro's Spatial Video export or passing the appropriate flags to your encoder — so the container carries the required signalling.
Do I need to upload my video file to check its metadata tags?
No. This tool is a fully client-side MV-HEVC metadata checker. When you drop or select a file, the browser reads it with the File API and passes the raw bytes to a JavaScript parser running inside this page. The bytes never leave your machine: there is no upload step, no API call, and no server involved at any point. That is enforced rather than promised — the build pipeline scans the shipped HTML for any browser API capable of sending data off the page and fails if it finds one.
What spatial metadata tags are required for Meta Quest vs Apple Vision Pro?
Both platforms rely on the MV-HEVC container format and look for the same core atoms. The lhvC box carries the layer HEVC decoder configuration that proves the file has two independent HEVC layers (one per eye). The stri box assigns each track to a left or right eye role. Apple Vision Pro additionally uses the hero atom to decide which eye to show in 2D contexts. Meta Quest follows the same MV-HEVC spec for its spatial video player. A file that passes this Apple Vision Pro spatial video checker — status: Valid Spatial Video — should also play correctly on Meta Quest, because both platforms implement the same underlying standard.
Is anything I paste uploaded or processed on a server?
Nothing is uploaded. The entire spatial video metadata viewer runs as an inlined script inside this HTML page. Your file is read by the browser's built-in FileReader API, parsed in memory by a pure-JavaScript MP4 box walker, and the result is displayed immediately. No data is transmitted anywhere. Everything runs locally: what you paste never leaves your browser.