spatial-media provides tools for working with spherical video and spatial audio metadata so players and platforms can correctly render immersive media. The utilities inject, inspect, and extract metadata in common container formats (MP4/WebM) to signal 360° projection type, stereoscopy mode, and spatial audio layout. Creators use it to prepare 360/VR180 assets for upload so services know whether a video is monoscopic, top-bottom stereo, or side-by-side, and whether ambisonic audio is present. By separating metadata handling from encoding, the tools slot into existing editing/export workflows without requiring specialized NLE support. They help ensure assets play back with the right projection, field of view, and head-tracked audio in compliant players. For archive and validation use cases, the scripts can also read existing flags to diagnose why a video isn’t being recognized as immersive.
Features
- Metadata injection and extraction for 360°/VR180 video
- Support for MP4 and WebM containers
- Flags for stereoscopic layouts and projection types
- Spatial audio (e.g., ambisonics) metadata handling
- Command-line utilities that fit into export pipelines
- Inspection tools for troubleshooting player compatibility