2024-06-25: immerGallery 1.2.7 "Video Player Update"​ released. Learn more in our News.

Your Virtual Reality
Image and Video 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 media 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)

 ​↗️immerGallery PCVR
Wishlist at Steam now!

Valve Index, HTC Vive, HTC Vive Pro, HTC Vive Pro 2, HTC Vive Focus 3, HTC Vive Cosmos 3, 
HP Reverb (G2), Varjo Aero, Pimax, Playstation VR2 with PC Adapter, Lenovo Explorer, Acer Windows Mixed Reality, Samsung Odyssey, HP Windows Mixed Reality Headset, ... 

Streaming to headsets: Meta Quest Link, Pico Connect and other compatible devices.

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!
(UPnP 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!

Navigate through voice control!

98% of the functionality are controllable through voice. Mostly, you can put your controller away.

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
Acer SpatialLabs Eyes Stereo Camera
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 EOS R7 RF-S 3.9mm f/3.5
Canon EOS R7 RF-S 7.8mm F4
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 X4
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?

Yes. Since version 1.2.7 videos are supported as a "beta" feature. Videos are currently separated from images and are chosen from the /Movies and /Pictures folder on your device. Future versions will integrate images and videos in your regular folders.

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

• .bmp

• .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  pdfor  webp image .

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 3D red/blue anaglyph _ANA
Low-FOV 2D (regular image) _2DP
VR180 stereo left/right equirect Canon RF 5.2mm _rf52
Cylinder mono _CYL2D
Cylinder stereo left/right (future versions) _CYL3D_LR
Cylinder stereo top/bottom (future versions) _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.

Which voice commands are supported?

Many functions of immerGallery can be used with voice commands. Some depend on the context and may only work with that.

Similar words for calls: show = open
If there is an option to enable, then disable is the corresponding command.


Common
select 1
select 2
select 244
show 5
show 42
Select a thumbnail, folder or download in a table
next default: next image
if in MP3 menu: next song
if in video menu: next video
previous
folder up
left browsing through tabs or in Reward section
right
scroll down
scroll up
start playback
pause playback
stop playback
zoom in
zoom out

hearts
i love it
mark favorite
add to favorite

zoom in map
zoom out map

rotate left
rotate right
rotation in 360° media
refresh
end program
end simulation
exit program



Menu
open menu
enable menu

close menu
disable menu
hide menu

show local gallery
open local gallery

show sample gallery
show mulitplayer
show upnp
show smb
show download
show favorites
show modify image
show rewards
show mp3 player
show settings
show 3d camera
show help


Deletion
delete
trash

keep for deletion dialogue
cancel for deletion dialogue
clear cache
clear downloads
delete all favorites from folder
delete all except favorites from folder
unmark favorites in folder


Audio
play random song
start mp3
start music
play song
play a song
start playing a random mp3 song
next song
previous song
stop song
stop mp3
stop music

pause song
pause mp3
pause music
same for unpause
enable background audio
mute background audio

enable voice over
enable mp3 player audio
enable mp3 player music

increase background audio
increase background volume
rise background audio
rise background volume

increase mp3 audio
increase microphone volume
stop background
play none
play nothing

Video

play video
pause video
unpause video
stop video


Multiplayer
go
connect
To start a multiplayer session. This disables voice control.
max players two
max players three
max players four
Configure max players of a room in multiplayer.


Rewards
claim reward
get reward
collect reward
click reward

missed rewards
go to rewards


Modify image
special effect none
disable birds
disable leaves
disable meadow
disable environments
disable hot air balloon
disable st patrick's day
disable special effects
disable snow
disable rain
disable underwater
...

enable leaves
enable meadow
enable halloween
enable hot air balloon
enable hot air balloon birds
...

play arabic
play beach
play birds
play classic
...

apply special effects to folder Under Modify Image
apply background music to folder Under Modify Image
save settings in folder Under Modify Image


Options
enable image switch sound
enable black background  ambient background for low-fov images
enable loop for playback
enable tool tips for controller
enable next thumbnail for controller
enable small font
enable laser in menu
enable verbose for better debug output when sending logs
enable 120 120 Hz mode
pitch rotation 0
pitch rotation 10
pitch rotation 90

enabled curved force curved display for low-fov images
increase menu distance
zoom out menu

enable controller
enable keep rotation remember rotation in 360 degrees across image swtich
enable upnp debug
enable faster image switch
disable voice control
stop voice control
voice control off

enable passthrough
enable camera pass



SMB
enable smb show menu item for SMB
scan scan for SMB servers
enable save password for SMB
enable password hidden hidden password for SMB with asteriks


3D camera
enable 3d camera menu shows menu button to access 3D camera settings on Quest 3
enable 3d camera if in menu for 3d camera, start 3d camera mode
enable auto switch water scale for 3d camera
enable move water scale for 3d camera, move water scale to bottom region
extract leveled after 3d camera capture, extract leveled images
extract photo after 3d camera capture, extract every 3 seconds an image


Fear
acrophobia off
acrophobia medium
acrophobia high

arachnophobia off
arachnophobia on

carnophobia off
carnophobia on



Other
send log
sort by file name
sort by file name descending
sort by date
sort by date descending

Press Kit, the Future and Changelog

Press Kit

Future plans and Changelog