2024-03-14: immerGallery 1.2.5 "Multiplayer Update"​ released. Learn more in our News.

Your Virtual Reality
Image Viewer

Enjoy immersive photos for virtual reality (VR) like never before! immerGallery is designed to make it as easy for you as possible to enjoy your images without hassle. Never worry about manually setting the VR formats of your images. Our AI handles it for you! 

No matter if mono or stereo, immerGallery lets you easily display and navigate between your images in from various formats such as regular 2D, 3D, 180° 2D / 3D and panoramic 360° 2D / 3D. This works for photos as well as for renderings, e.g. spherical panoramas of architecture, interior designs or game screenshots. 

immerGallery is also a social VR experience: you can enjoy your immersive images together with your friends in our new multiplayer mode!

Get immerGallery now for Meta Quest 2, Meta Quest Pro and Meta Quest 3!

(Watch on YouTube ↗)

Available for Meta Quest 2, Meta Quest Pro and Meta Quest 3

Download

immerGallery 
at Meta Quest Store
immerGallery Demo
at Meta Quest Store

(immerGallery Demo is limited to showing your first 10 images and 80+ included samples images)

Features

The most immersive and easiest to use VR Image viewer!

AI Image Format Detection

AI-based smart detection of immersive media formats, e.g. VR180 stereo, VR360 mono, VR360 stereo top/down...

Multiplayer 
(Social VR)

Enjoy your immersive galleries together with your friends in virtual reality!

Immersive Galleries

Create your own immersive galleries by augmenting your images with background audio, voice-overs and descriptions through our web-tool!

Useful
Thumbnails

Based on the detected image format, we create useful thumbnails for an ideal preview

Make Your
Images Alive!

Bring your images to live by adding environmental effects. Let it snow, let it snow!

UPnP / DLNA and SMB

Watch images from your local media home server!
(currently in beta)

Use
Favorites

Mark your favorites images to easily find them later

Download Shared Immersive Galleries

Easily download zipped immersive galleries from others (http / https)

Highest Image Quality

Through smart rendering specific to the VR resolution, we provide the highest image quality

Support for various image representation

3D? 180 degrees? 360 degrees spherical panoramas? Flat 2D? Fisheye? Equirect? Left / right? Top / bottom? Stereoscopic side-by-side? Cylindrical panoramas in Virtual Reality?

We support it all!

360-degree image
Flat 2D image 180-degree image

Easy user interface!

Quickly browse through your images with a user interface that maps your folders naturally to virtual reality. Useful thumbnails are created automatically for your media depending on the automatically detected image format.

Quest 2 Controller

Navigate with a single controller!

The user interface has been optimized so you only need a single controller for full functionality!

Let is snow, let it snow.

Modify your 360-degrees panorama with immersive environmental effects like snow.

Only happy when it rains...

Add rain to your panorama. Combined with the sound of rain drops, watching the images gives you full immersion.

Display rendered images from supported cameras

Camera Models 180° stereo 360° mono 360° stereo Flat 2D Flat
3D
Apple Spatial Photos 
(iPhone 15 Pro with app Spatialify for images from Spatial Videos)
Canon EOS R5 RF 5.2mm F2.8 L
Canon EOS R5 C RF 5.2mm
Canon EOS R6 Mark II 5.2mm
Canon PowerShot VR10
Calf Professional 3D VR180 Camera
Fujifilm FinePix Real 3D
Google Photo Sphere through
Google Nexus Smartphones
Google Cardboard Camera App (no audio)
GoPro Fusion
GoPro Max
Insta360 EVO
Insta360 Air
Insta360 Nano S
Insta360 ONE X
Insta360 ONE X2
Insta360 ONE R Twin Edition
Insta360 ONE RS
Insta360 ONE RS 1-inch
Insta360 X3
Insta360 Pro
Insta360 Pro 2
Insta360 Titan
Kandao QooCam EGO
Kandao QooCam
Kandao QooCam 8K
Labpano PanoX V2
Labpano PilotPano
Labpano Pilot Era
Labpano Pilot One
Lenovo Mirage Camera
Panasonic Lumix DMC-3D1
Ricoh THETA
Ricoh THETA m15
Ricoh THETA S
Ricoh THETA SC
Ricoh THETA SC2
Ricoh THETA V
Ricoh THETA X
Ricoh THETA Z1
Samsung Gear 360
TECHE 3D 180VR
Vuze
Vuze+
Vuze XR
All other cameras capturing equirectangular 180° / 360°
All 2D cameras, smartphones, tablet or 2D drawings (.jpg)

Display images from 3D Rendering Software

(depends on available virtual camera outputs from the software)

Renderer 180° stereo 360° mono 360° stereo Flat
2D
Flat
3D
Archicad
Blender
Lumion 
Pytha
SketchUp
Unity Panorama180 Renderer
V-Ray
All renderers able to create equirectangular, 2D, 3D and side-by-side images

faq

Do you support videos?

No. We focus on images. By doing so, we set ourselves the goal to deliver the world's best VR image viewer for you.

What types of files can be loaded and where should they be stored?

For the best experience, we recommend using .jpg image files. For the Meta Quest devices, the images need to be stored in the /sdcard/Pictures folder or subfolders of it. We have a video on how to upload it on YouTube and here on the bottom of the page.

The full list of supported image file formats / extensions for local files (UPnP might differ depending on the server) for version 1.1.6 or later:

• .jpg (equal with .jpeg)

• .png

• .mpo

• .webp (future 1.1.6 version only)

• .bmp (future 1.1.6 version only) 

• .tiff (equal with .tif) 

• .gif (static)

• .jps (3D low field-of-view side-by-side stereo jpg)

How can I augment my images with audio, a map and environmental effects for my own immersive gallery?

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 .

Are there special file name hints or file extensions to force an image format?

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 or  jpg .

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

How to get future updates?

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

What is the difference between the Meta Quest, Meta Quest 2 and Meta Quest Pro version?

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.

Meta Quest (1) support is now deprecated. The last version for of immerGallery for it is 1.1.8a. It may not be available in the Meta store anymore for new Quest (1) customers.

How do the favorites (heart) work?

Favorites can be added and removed through three different methods:

a) the heart button on the top part of the menu
b) by clicking into the top right corner of a thumbnail
c) by pressing the B or Y button when viewing an image with the menu closed 

Depending in which state you are currently in immerGallery, the behaviour is different:

1) You have clicked on an image and you are watching a gallery. Using the heart feature, this toggles if this image is currently added through your favorites or not.

2) You did NOT start the playback of a gallery or pressed "Stop Playback". Because no single image is selected now, using the heart feature, you toggle if the current folder is currently added through your favorites or not. 

Changing the heart status directly on the top right corner of the thumbnail works for both modes.

Please note: when you are in playback mode in your favorites folder and you remove the currently watched item, the playback will stop as the favorites got reorganized.

The view on the favorites will first show all added folders. Inside, you find the exact data and subfolders as you would expect it. After the folders, the full path of the image including the directory path is used for alphanumerical sorting. This way, favorites added from the same folder will be next to each other.

Are there limitations on the number of images per folder?

For the best experience, we recommend limiting the number of images per folder to 300. However, we do support larger folders of up to 500 images, but performance will be decreased. If a folder contains more than that, we will only list the first images up to that limit. The number of subfolders within a single folder is limited to 300.

If the use case is to watch a folder full of regular 2D images, then we recommend using tools like Bulk Rename Tool for Mircosoft Windows to add a _2D suffix to your images which forces immerGallery to take these as 2D images without processing. This will load faster.


What about photos taken with the (obsolete) Google Cardboard Camera app in 3D and its audio?

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.


Why is there no multi-language support yet?

We are sorry that for now English is the only supported language. We still have very frequent changes in features and the user interface. If we support multi-language in the future, we want to support multiple languages. For now, sadly, the time for a professional translation into mutliple languages would slow our fast progress in adding features down. We might revisit this topic in H2 / 2023.

Any tips for downloading .zip files inside the apps URL bar under the Download tab?

With the address bar under the Download tab inside the app, you can download .zip files which are accessible through http or https. Please note that there are some limitations to the .zip file:

* The .zip file needs to be smaller than 2 GB (2048 MB).

* Special characters inside the .zip file might cause issues during extraction. If you want to make sure there are no issues, please avoid them.

A reasonable method to avoid typing could be to take your Dropbox shared link and the put it into an URL shortener. In that case, please make sure that the URL you use for the shortener contains "dl=1", meaning the file will be directly downloaded and NOT "dl=0", meaning the file would be opened as a web interface and not be directly downloaded. "dl=0" is not supported in immerGallery and with an URL shortener we cannot change it afterwards.

If inside your .zip file, there are other .zip files, they will NOT be extracted.

You do NOT need to set a folder inside your gallery. If you .zip file is named "My cool vacation.zip", we will automatically create a folder "My cool vacation" and extract it there. 

End of Meta Quest (1) support - Quest 1 Deprecation Date

Primarily due to Meta’s deprecation of the Quest 1 SDK (their last supported version is v50), we are prevented from keeping immerGallery updated properly on the device. Therefore, we may not be able to update the Quest 1 version in the future anymore. We are committed to keep it running as long as possible and we might have an option to upload a "last build" for Quest 1, which should continue to work. However, after that, only the Quest 2, Quest 3 and Quest Pro versions might receive updates.

We are very sorry for this and would have liked to support our Quest 1 users longer, but without the proper support of Meta for that, we have no other choice.

The Quest 1 last update date for immerGallery and end of support was End of June 2023. It may not be available in the Meta store anymore for users who have not purchased it before that date for Quest 1.

Files are not showing or GPS data from images does not load the map on the controller?

If this happens, it is very likely related to the Android file permissions not properly set. When you launched immerGallery the first time, it asked if access to the data is allowed. If this was declined, file cannot be found and loaded. The same applies to the permission to read out location data from media. If this happened and you want to change it, please try one of these:

1) If the permission popup shows at app launch, accept permission requests.

2) In the overview of your Meta VR apps, click the three dots on immerGallery - Permissions. Toggle storage permission on. If it was already on, try turning it off and on again.

3) Uninstall and install app again if the popup for permission does not show up.


What should I know about the Pastebin support inside the app?

In the full version of immerGallery, you can connect to a public Pastebin posting by using just the ID in the URL. For example, to access pastebin.com/LigdUX, you only enter LigdUX. We will parse the content there to what appear to be links for downloads. The downloads need to be zip-files without passwords containing images and optionally audio and immerVR-files. Subfolders can be used inside the archive. The links for the download need to start the download of the zip file directly without any web login or captchas.

In order to give a better overview of the download, we display the word before the URL or the word chain in quotes before the URL if it is found.

In a later version, we might use the first word or first word chain in quotes of the Pastebin content as a title or author.

Example of text inside a Pastebin posting with explanations:

"Dan's Galleries"  // could be later used in immerGallery as title of current Pastebin
"Gallery Regensburg" https://immerVR.com/files/pasteBin/regensburg.zip   // Gallery Regensburg will be used as description for this download
An example from Rome myfiles.com/gallery.zip   // Rome will be used as description as it is the last word and there are no quotes
MyDropboxPhotos https://www.dropbox.com/scl/fi/yr9xzvhkkrdfyabcdef/gallery.zip?rlkey=abcdef6o9g38cy&dl=0  

What are the required app permissions since immerGallery 1.2 and newer?

Due to the underlying operating system base of Android 12 or higher on the newer Meta Quest devices, the permission system to access files has changed. Therefore, a first dialogue during the first app start has to be confirmed to allow read permission, e.g. to the /Pictures folder. Once inside the app, we have on top of the menu the hint to also allow the extended read and write permissions. If these are not set, the following features do not work: loading .immerVR files from Local Gallery (e.g. for custom background audio), deleting files, some image formats may not be loaded, .zip files for extraction from /Download is not possible. Therefore, please enable it. The selection will be saved, so this is only required once.

More information on the 3D Camera feature for Meta Quest 3 (recommended only for experts)

Overview:
The Meta Quest 3 device has reasonably good color cameras and shows a stereoscopic view. You could just record that in your Meta home environment with passthrough enabled. However, with immerGallery, we have helpful hints to make it easier to verify the setup and you can enable a water scale graphics. For recording 3D content, video or using screenshots of that video later as photos, it is imperative that there is no roll rotation. In many cases, pitch rotation should be avoided as well, but is less critical.

How to:
Enable developer mode on Quest 3 (please use a search engine for details)

• In immerGallery on Quest 3, enable Settings - Advanced - 3D camera menu

Set values through adb or SideQuest VR while being connected over USB from PC to Quest 3. Settings are reset to default after reboot:

  adb shell setprop debug.oculus.screenCaptureEye 2

  adb shell setprop debug.oculus.capture.width 3840

  adb shell setprop debug.oculus.capture.height 1920

  adb shell setprop debug.oculus.fullRateCapture 0

  adb shell setprop debug.oculus.capture.bitrate 40000000

  If you use adb from your Windows Command line cmd.exe, you can execute this with a single command:
  adb shell setprop debug.oculus.screenCaptureEye 2 && adb shell setprop debug.oculus.capture.width 3840 && adb shell setprop  debug.oculus.capture.height 1920 && adb shell setprop debug.oculus.fullRateCapture 0 && adb shell setprop debug.oculus.capture.bitrate 40000000

  If you use adb from your Windows Powershell, you can execute this with a single command:
  adb shell setprop debug.oculus.screenCaptureEye 2; adb shell setprop debug.oculus.capture.width 3840; adb shell setprop debug.oculus.capture.height 1920; adb shell setprop debug.oculus.fullRateCapture 0; adb shell setprop debug.oculus.capture.bitrate 40000000 

Be inside valid boundary / guardian or the recorded video is black

Start recording:

  ◦ Open Meta menu with the Meta button ∞

  ◦ Press record

  ◦ Close Meta menu

  ◦ When done, stop recording

• The saved video will be on your Quest 3 folder Oculus/VideoShots

Copy video to PC. In VLC Player, you can take screenshots to have 3D photos: Shift-S. These will be saved in your own /Pictures folder on your PC.

Copy images from PC /Pictures to Quest 3 /Pictures or subfolders.

Enjoy 3D photos in immerGallery! (videos are currently not supported in immerGallery)


General:
We have an auto-switch water scale mode. It will show the water scale as overlay for 3 seconds. Then it disappears for 1second until it shows again for 3 seconds and so on. This allows you to change your view to avoid roll and pitch rotations. When you screenshot frames from the final video, you can choose the ones where the water scale was well-aligned before it disappeared. 

When shown, the water scale overlay will be recorded as well. If you want to capture a video without grabbing single frames as photos from it, it is advices to not use the auto-switch mode. In the regular mode, the water scale is shown. By pressing the controller's trigger button, you can toggle it on and off. For example, if you cut later the video, you start first with showing the water scale while recording. You align your view to minimize rotations. You disable the water scale with the trigger and from there on capture the content that you use later for your cut. This way, at least the starting position is with minimal rotations and may be kept stable longer.

The capture resolutions are the maximum that we know of that have a valid aspect ratio (1:1 per eye) of the captured stereo content. The bitrate of 40,000,000 is the maximum supported bit rate on Quest 3 at the time of this writing.

In the Meta menu under Settings - System - Camera, there are options regarding image stabilization. If the goal is to capture frames as 3D photos, we recommend to keep it off. If enabled, fast movements will distort the image, resulting in black areas which do not have a stereo match. For recording video, a lower stabilization will be helpful for a better video viewing experience, but too fast movements should be avoided.

When trying to connect with the "Go!" button in multiplayer it stays disconnected and a 15-seconds countdown appears.

For using multiplayer, a certain valid authentication is required. This only works for app purchases that are registered correctly at Meta. This should always be the case for regular purchases, but does not apply to "test versions" not being provided through Meta.

In the case of account sharing where two or more Meta accounts are used on the same VR device, it only works if the main account on that device owns a purchased version of immerGallery as well.

Press Kit, the Future and Changelog

Press Kit

Future plans and Changelog