This repository exists to accumulate and understand file formats and metadata standards generated by 360 cameras.
We build software that processes 360 video and image files. In many cases these files contain telemetry data (e.g are geotagged).
Before processing them, we need to understand the format (or standard) of files each camera produces to process it correctly.
This repository contains our research to aid others building similar tools.
Data wanted! Don't see your camera manufacturer/model listed. Help us
All sample files used to extract metadata are offered free of charge for the benefit of other developers. You will find links to download under each cameras README.md file.
Generally camera manufacturers write metadata standards in a few formats.
Ones we've researched are linked:
More of our research can be found in the /0-standards directory in this repository.
You can use the open-source Exiftool to extract and normalise metadata.
Consider supporting exiftool: Exiftool is a free and very well supported bit of software we use to extract metadata. Let’s make sure it stays that way. You should consider a small donation to support it if this repository has been useful to you.
Heres a quick introduction on how to use it:
Read more about image file metadata
Some useful exiftool commands:
exiftool -G -s -b -j -a -T MULTISHOT_0611_000000.jpg > MULTISHOT_0611_000000_timelapse_metadata.json
This command includes the following arguments:
-a: Allow duplicate tags to be extracted -G: Print group name for each tag -s: Descriptions, not tag names, are shown by default when extracting information. Use the -s option to see the tag names instead.
Read more about video file metadata
Some useful exiftool commands:
Video level data
exiftool -ee -G -s -b -j -a -T VIDEO_7152.mp4 > gopro_fusion_VIDEO_7152_metadata_overview.json
Track level data (more verbose -- includes telemetry)
exiftool -ee -G3 -s -b -j -a -T VIDEO_7152.mp4 > gopro_fusion_VIDEO_7152_metadata_track.json
These commands includes the following arguments:
- -ee: Extract embedded data from mp0 files (and others).
- -a: Allow duplicate tags to be extracted
- -G3: Identify the originating document for extracted information. Embedded documents containing sub-documents are indicated with dashes in the family 3 group name. (eg. Doc2-3 is the 3rd sub-document of the 2nd embedded document.)
- -s: Descriptions, not tag names, are shown by default when extracting information. Use the -s option to see the tag names instead.
- -b: Output metadata in binary format (useful because often telemetry data is binary e.g gyroscopes)
- -j: Use JSON (JavaScript Object Notation) formatting for console output
Note, for larger files you might encounter the error:
Warning: End of processing at large atom (LargeFileSupport not enabled)
I got this error when processing this 4GB video.
In which case you need to enable largefilesupport using an exiftool .config file. Read this topic on the exiftool forum for more information.
Unfortunately we don’t have the budget to buy every single 360 camera to test the photos and videos they produce with our software.
Whilst having standards like EXIF and XMP is very helpful, many manufacturers do things slightly differently (especially given the flexibility of fields in XMP data).
In order to make sure our free, open-source software works for everyone, we need to test it using 360 image and video files produced by a range of cameras and manufacturers.
And that’s why we need your help.
If you have a 360 camera and want to support our work, please share more information about your camera with us using this form. Thank you!
The /0-tests directory contains files that can be used to test software. It contains valid and corrupted 2D and 360 photos.
We offer community support for all our software on our Campfire forum. Ask a question or make a suggestion here.
The 360 Camera Metadata repo is licensed under a MIT license.