For every image file, you can create an according .immerVR file which contains and links to additional data.
Please use our web-based immersive Gallery-Generator .

Ideally our automatic image format detection should take care of the image format automatically. If you encounter wrongly detected images, please email them to us so we can improve our algorithms for all users. 

In the case that you want to override the detected image format, you can change the format on-the-fly in the app under "Current Image". 

You can also create an accompanying .immerVR file for specifying a certain image format.

There are three file extensions that have impact on the image format:

1) .jps: this is a renamed .jpg file and contains a left/right low-field-of-view stereo image

2) .mpo: container, for which we assume that it internally has a left and right image for low-field-of-view-stereo

3) .vr.jpg: for images that have the right eye view hidden in meta data, e.g. photos from the Lenovo Mirage Camera. This defaults to VR180 stereo. If your images have been created this way, they will already have the .vr.jpg extension. Please do not set it manually for your other images.

Various software has supported various hints in file names to enforce a certain image format. We do not support half-resolution formats and always assume full resolution. The following hints are supported. We recommend the ones in bold, but the others work as well. All values are case-insensitive and need to be suffixes of the file name before the file extension, e.g. beach_180_LR.jpg. When displaying the file names with thumbnails in the app, we remove the hints.

Download image file format hints immerGallery as  pdf .

Recommended image file format suffix hints (case insensitive):

VR180 stereo left/right equirect _180_LR VR180 stereo top/bottom equirect _180_TB VR180 stereo left/right fisheye _180F_LR VR180 stereo top/bottom fisheye _180F_TB VR180 mono equirect _180 VR180 mono fisheye _180F VR360 stereo left/right _360_LR VR360 stereo top/bottom _360_TB VR360 mono equirect _360 Low-FOV 3D left/right _LR Low-FOV 3D left/right half width _LRH Low-FOV 2D (regular image) _2DP VR180 stereo left/right equirect Canon RF 5.2mm _rf52 Cylinder mono _CYL2D Cylinder stereo left/right (not supported yet) _CYL3D_LR Cylinder stereo top/bottom (not supported yet)  _CYL3D_TB

Hints as image:

We continue to develop and improve our VR image viewer. Updates will be pushed automatically through the virtual reality app stores.

Due to the faster hardware on the Meta Quest 2, the app is able to show images a bit faster and can use the 90 Hz refresh rate of the Meta Quest 2 compared to Meta Quest. Nevertheless, you can enjoy the full experience with all our features on the first version of the Meta Quest as well. In Meta Quest Pro, the passthrough video mode will be in color.

Right now, we only directly support the 2D panorama images from Google Cardboard Camera. If the panorama is not fully spherical, we will apply pole filling to it automatically. There is a manual way to extract the second eye image from such images using  Google's Cardboard Camera   Converter (thanks to cambridgeJason for the hint!). You can also convert a 3D-360° .vr.jpg file using Google's VR180 Creator Tools into an equirectangular top/down image which immerGallery can display correctly.

As for the audio saved inside such image files, there is a manual way to extract these as well so they could be linked together again in immerGallery through the .immerVR files: Assuming your file is beach.vr.jpg:

1. Download and extract ExifTool: https://exiftool.org  
2. Rename exiftool(-k).exe to exiftool.exe
3. Go into the command line (cmd) and run: exiftool -AudioData -W %d%f.%s -b beach.vr.jpg
4. You now have a file named beach.vr.mp4 which has the audio in it
5. Use a website like https://online-audio-converter.com/ to convert the .mp4 to a .mp3 file and save it to beach.vr.mp3
6. You can delete the .mp4 file now
7. Make sure you have your image beach.vr.jpg and beach.vr.mp3 in the same folder
8. Put the beach.vr.immerVR file in the same folder. You can edit it in a text editor to change the audio file name when you do other named images
9. Put all of it on your Quest /Pictures folder and it should play back with audio

Example content of the beach.vr.immerVR file - please adjust to your filenames:

audioVoiceOverFile beach.vr.mp3
scaleAudioVoiceOverVolume 0.5
loopAudioVoiceOver true

We realize that this is not as comfortable as having this done all automatically and want to apologize that we didn't have the resources to priortize this feature yet. As the Google Cardboard Camera app is obsolete and has been removed from the Google Play store, we expect this format to wind down in the future. Therefore, having the data extracted and in commonly known and frequently used formats might be beneficial in the long term for your own content.