README.rst

   1 VLC 3.0 supports 360° videos. How can I mark up a mp4 file so that VLC recognizes it as 360 degree video?\r
   2 \r
   3 It's not possible with exiftool.\r
   4 You have to use the spatial media metadata injector from https://github.com/google/spatial-media/tree/master/spatialmedia\r
   5 \r
   6 \r
   7 My findings:\r
   8 \r
   9 Spherical Video RFC\r
  10 ===================\r
  11 https://github.com/google/spatial-media/blob/master/docs/spherical-video-rfc.md\r
  12 \r
  13 Git commit:\r
  14  c3d173385bf0e5ad915328e4b91939c1ae367106\r
  15  demux: mp4: support the 360 spherical video box\r
  16  http://git.videolan.org/?p=vlc.git;a=commitdiff;h=c3d173385bf0e5ad915328e4b91939c1ae367106;hp=08d26ea02f5c6c1e1169fd9f315a00e88241f03e\r
  17 \r
  18 VLC only tries to find the string "GSpherical:Spherical" in the meta data to activate the mode.\r
  19 \r
  20 exiftool::\r
  21 \r
  22   $ exiftool -XMP-GSpherical:Spherical="true" file.mp4\r
  23 \r
  24 Unfortunately, exiftool writes this in normal XMP data, but the spec v1 wants it in an atom with uuid ``ffcc8263-f855-4a93-8814-587a02521fdd``. exiftool does not support this.\r
  25 \r
  26 You can check this with AtomicParsley (``apt install atomicparsley``)::\r
  27 \r
  28    AtomicParsley file.mp4 -T 1\r
  29 \r
  30 This special uuid is missing.\r
  31 \r
  32 \r
  33 \r
  34 Spherical Video V2\r
  35 ==================\r
  36 https://github.com/google/spatial-media/blob/master/docs/spherical-video-v2-rfc.md\r
  37 \r
  38 git commit in vlc:\r
  39  cf8b24f05438d6bc451e0d17bf2bf3d006a5cbe3\r
  40  demux: mp4: support 360° v2 spatial metadata\r
  41  http://git.videolan.org/?p=vlc.git;a=commitdiff;h=cf8b24f05438d6bc451e0d17bf2bf3d006a5cbe3;hp=1afd117faf50e266998ace5f08f06e52b2260958\r
  42 \r
  43 v2 of the spec wants special mp4 atoms/boxes that exiftool is not able to write :/\r
  44 \r
  45 - https://sno.phy.queensu.ca/~phil/exiftool/TagNames/QuickTime.html#sv3d\r
  46 - https://sno.phy.queensu.ca/~phil/exiftool/TagNames/QuickTime.html#equi\r
  47 \r
  48 \r
  49 Also\r
  50 ====\r
  51 \r
  52 - https://trac.videolan.org/vlc/ticket/21752\r