Skip to content
Specifications and tools for 360º video and spatial audio. Modified for Google's VR180
Branch: master
Clone or download
Pull request Compare This branch is 80 commits ahead of kodabb:master.
David Burnett
Latest commit 93b520e Mar 3, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
spatialmedia Fix full frame from gui (no fov). Some compatabilty with Python 3 fixed. Feb 23, 2019
support/hrtfs/cube Add Thrive Cube HRTF set. Jun 8, 2016 update and Typo in Mar 3, 2019

This fork is designed to fake googles VR180 camera metadata.

Please download using the 'Clone or download' button, the releases have been inherited from the original Google repository and do not work for VR180.

It uses Spherical Video V2 metadata and gives a choice between Mesh Projection for fisheye videos or equi-rectangular projection with the left and right crop set to 1073741823 which is 0x3FFFFFFF or 1/4 of 0xFFFFFFFF. It can also be used to display full frame SBS 3D video (ala 3D movies) in Youtube using VR180 compatibility with some limitation without requiring a re-encode to fisheye or equirectangular.

To use it you need a copy of python 2.7 or 3.6 and use the command line or GUI.

Typical usage:

python spatialmedia -i -s left-right -m equirectangular Test_180_3D.mp4 Test_STV2_180_3D.mp4


python spatialmedia -i -s top-bottom -m equirectangular Test_180_3D.mp4 Test_STV2_180_3D.mp4


python spatialmedia -i -s left-right -m mesh Test_180_3D.mp4 Test_STV2_180_3D.mp4


python spatialmedia -i -s left-right -m full-frame Test_sbs_ff_3D.mp4 Test_STV2_ff_3D.mp4


python spatialmedia -i -s left-right -m equi-mesh Test_Equi-180_3D.mp4 Test_STV2_VR180_3D.mp4

This will take the first file, inject the metadata and write the result out to the second file.

or alternatively

cd spatialmedia


to use the simple GUI. Note on the GUI mesh is called fisheye after the style of video it works with.

Please note that nearly all the mesh and equirectangular options will create the correct metadata (the exeception being -m mesh will ignore --degree=360 and field of view (-v) is only supported by equi-mesh as the field of view and full-frame as the image ratio ) but not all the options are accepted by Youtube.

As of 5th, June 2018 Youtube will accept...

-m equirectangular with all options except the combination of 180 degree and mono. -m mesh is restricted to stereo 3D at 180 degrees -m full-frame Youtube probably don't support it, it just happens to work. -m equi-mesh This is just VR180 using a slice of the hemi-spherei mesh. Getty's VR180 videos use something similar.

So mesh is restricted to 180 degree 3D videos in a 1:1 ratio. Equirectangular will work for all 360 formats but 180 degree videos have to have stereo image pairs.

There is no way to do mono 180 without resorting to SBS or OU stereo image pairs with the same image duplicated in the frame.

This is basically kodabb/spatial-media sphericaltoolsv2 branch with some hacking around merged into master so anyone wanting to use this doesn't have to play around with branches.

The original readme details below.

Spatial Media

A collection of specifications and tools for 360° video and spatial audio, including:

Try out Jump Inspector, an Android app for previewing VR videos with spatial audio.

You can’t perform that action at this time.