A tool for manipulating spatial media ([spherical video] (../docs/spherical-video-rfc.md) and [spatial audio] (../docs/spatial-audio-rfc.md)) metadata in MP4 and MOV files. It can be used to inject spatial media metadata into a file or validate metadata in an existing file.
Python 2.7 must be used to run the tool.
From within the directory above spatialmedia:
python spatialmedia -h
Prints help and usage information.
python spatialmedia <files...>
For each file specified, prints spatial media metadata contained in the file.
python spatialmedia -i [--stereo=(none|top-bottom|left-right)] [--spatial-audio] <input> <output>
Saves a version of <input> injected with spatial media metadata to <output>.
<input> and <output> must not be the same file.
Selects the left/right eye frame layout; see the StereoMode element in the
Spherical Video RFC for more information.
Options:
-
none: Mono frame layout. -
top-bottom: Top half contains the left eye and bottom half contains the right eye. -
left-right: Left half contains the left eye and right half contains the right eye.
Enables injection of spatial audio metadata. If enabled, the file must contain a 4-channel first-order ambisonics audio track with ACN channel ordering and SN3D normalization; see the Spatial Audio RFC for more information.
Install PyInstaller, then run the following:
pyinstaller spatial_media_metadata_injector.spec