(no commit message)

diff --git a/README.rst b/README.rst
new file mode 100644 (file)
index 0000000..138122f
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,52 @@
+VLC 3.0 supports 360° videos. How can I mark up a mp4 file so that VLC recognizes it as 360 degree video?\r
+\r
+It's not possible with exiftool.\r
+You have to use the spatial media metadata injector from https://github.com/google/spatial-media/tree/master/spatialmedia\r
+\r
+\r
+My findings:\r
+\r
+Spherical Video RFC\r
+===================\r
+https://github.com/google/spatial-media/blob/master/docs/spherical-video-rfc.md\r
+\r
+Git commit:\r
+ c3d173385bf0e5ad915328e4b91939c1ae367106\r
+ demux: mp4: support the 360 spherical video box\r
+ http://git.videolan.org/?p=vlc.git;a=commitdiff;h=c3d173385bf0e5ad915328e4b91939c1ae367106;hp=08d26ea02f5c6c1e1169fd9f315a00e88241f03e\r
+\r
+VLC only tries to find the string "GSpherical:Spherical" in the meta data to activate the mode.\r
+\r
+exiftool::\r
+\r
+  $ exiftool -XMP-GSpherical:Spherical="true" file.mp4\r
+\r
+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
+\r
+You can check this with AtomicParsley (``apt install atomicparsley``)::\r
+\r
+   AtomicParsley file.mp4 -T 1\r
+\r
+This special uuid is missing.\r
+\r
+\r
+\r
+Spherical Video V2\r
+==================\r
+https://github.com/google/spatial-media/blob/master/docs/spherical-video-v2-rfc.md\r
+\r
+git commit in vlc:\r
+ cf8b24f05438d6bc451e0d17bf2bf3d006a5cbe3\r
+ demux: mp4: support 360° v2 spatial metadata\r
+ http://git.videolan.org/?p=vlc.git;a=commitdiff;h=cf8b24f05438d6bc451e0d17bf2bf3d006a5cbe3;hp=1afd117faf50e266998ace5f08f06e52b2260958\r
+\r
+v2 of the spec wants special mp4 atoms/boxes that exiftool is not able to write :/\r
+\r
+- https://sno.phy.queensu.ca/~phil/exiftool/TagNames/QuickTime.html#sv3d\r
+- https://sno.phy.queensu.ca/~phil/exiftool/TagNames/QuickTime.html#equi\r
+\r
+\r
+Also\r
+====\r
+\r
+- https://trac.videolan.org/vlc/ticket/21752\r