shopify analytics ecommerce tracking
VR Tourviewer Forum

How to use VR Tourviewer

Ruud van Reenen

  • Developer
  • *****
  • 63
    • View Profile
    • 3DV - artist impressions & animations
How to use VR Tourviewer
« on: March 19, 2017, 21:56:40 »
VR Tourviewer is an Android app, to watch complete (mono- and stereoscopic) 360 degrees panorama tours, with the Samsung GearVR. Currently only tours created with Pano2VR are supported, but support for krPano tours is planned.

Download the app on your Android device.

Install the app:
To install, copy or download the downloaded APK file to your phone and start it.
To be able to install you have to allow installation of apps from 'Unknown sources' in security settings, since this is not a Google Play Store app. To start the app, click the ‘VR Tourviewer’ icon.

Due to Oculus restrictions for the use of Oculus Utilities for Unity, an Oculus signature for your device has to be included in the app.
If a signature for your device isn't included in the app yet, the app will inform you about it and will allow you to request a version with your signature.


If your signature is included, insert your phone into the Gear VR and the app should start, after a splashscreen, in the menu area.

Pano2VR output:
Use Pano2VR to generate the tour, you can add a second HTML output if you want to keep one project file and use it for both web output and VR output.

  • If you have a stereoscopic tour, in Pano2VR add a Tag called ‘stereo’ in User Data in at least one panorama (best practice to use the 1st panorama for this). VR Tourviewer needs this tag to display the tour in stereo
  • Use output to HTML5, with the cardboard.ggsk (or stare.ggsk) skin
  • in 'HTML' settings click the Tools icon and check 'Nodes are stereo pairs' if your tour is stereoscopic, always uncheck ‘Embedded XML’
  • Single resolution output: In HTML Output 'Image' use 'Single Res', for optimal results use a Cube Face Size of 1536px
  • Multi resolution output: In HTML Output 'Image' use 'Multi Res', for optimal results use a tilesize of 510, and make sure there is a level with width of 1536px
  • The generated XML file will be used by the app to find the images to load and to show the tour

The following features aren’t implemented (yet): polygon hotspots, skins, auto rotation (would cause instant nausea), auto change, transitions (nausea alarm too), context menu, control, preview. Please keep these limitations these in mind when creating/generating the output for VR Tourviewer.

Online tour or local tour on sdcard:
  • For online viewing: upload the complete tour to a server and send the URL of the generated XML file to dev@vrtourviewer.com, when the server receives a request from your app it will then reply with the proper URL. This tour will be visible in 'Favorites'. As soon as the VR keyboard is integrated you can add your own online tours.
  • For offline viewing: the app creates a ‘VRTourviewer’ (case sensitive) folder. Copy your complete tours (including subfolders) to that folder, you can use subfolders to easily organize them.
    When connected throught USB, the folder to copy the tours to is the following:
    For Galaxy S6/S6 Edge: root of 'Phone', in the folder VRTourviewer
    For Galaxy S7/S7 Edge: on 'Phone': Android/data/com.vrtourviewer.vrtourviewer/files/VRTourviewer

    Storage on external SD Card is not supported yet, due to Marshmallow/Samsung limitations. Storing on the phone's internal storage does have the benefit of being faster than the external SD card.

App usage:
  • The app uses gazing/staring for 2 seconds at a hotspot now, clicking on the Gear touchpad is used in the menu area.
  • The ‘esc’ button on the Gear (above touchpad) switches between menu and the loaded tour.
  • To add an online tour, use the + in the menu area, it will show a VR keyboard to enter the address to a Pano2VR tour

Planned features:
  • Setting initial view of panorama (<view> pannorth and/or <view><start> pan)
  • Support for additional lensflare types, now only one type (a default Asset in Unity) is used

Note that you can purchase a white label version with customized splashscreen, logo, launcher icon, hotspot colors, and even a custom panorama as the background of the menu area, tailored for your business, project or product. For more information, please send an email to info@vrtourviewer.com
« Last Edit: April 13, 2017, 10:27:34 by Ruud van Reenen »