2023-11-10: immerGallery 1.2.2 "3D Camera Update" released. Learn more in our News.
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.
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
(immerGallery Demo is limited to showing your first 10 images and 80+ included samples images)
The most immersive and easiest to use VR Image viewer!
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!
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.
Modify your 360-degrees panorama with immersive environmental effects like snow.
Add rain to your panorama. Combined with the sound of rain drops, watching the images gives you full immersion.
* depending on location
Camera Models | 180° stereo | 360° mono | 360° stereo | Flat 2D | Flat 3D |
Canon EOS R5 RF 5.2mm F2.8 L Canon EOS R5 C RF 5.2mm F2.8 L |
✅ | ||||
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) | ✅ |
(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 | ✅ | ✅ | ✅ | ✅ | ✅ |
No. We focus on images. By doing so, we set ourselves the goal to deliver the world's best VR image viewer for you.
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)
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 or jpg .
Recommended image file format suffix hints (case insensitive):
|
|
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.
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.
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.
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.
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:
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.
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.
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.
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.
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.
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
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.
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.