Setting up and calibrating a 6x GoPro set up with Vahana VR

In this walk-through, we assume you are using a 6x GoPro setup such as Freedom360 or 360Heros.

1. Make sure all your GoPros are set to the same settings:

  • Set the video mode to 960p (1280x960).
  • Deactivate on screen display (OSD). There shouldn't be any typo on top of the video.
  • Turn OFF the auto white balance, and use the same settings for all cameras.
  • Disable spot metering.


2. Connect all the cameras to the HDMI capture ports and turn them on:

Mark your HDMI cables so that you can identify them clearly from both ends, ideally by numbering them from 0, or by using color codes.


3. Launch Vahana VR and open the sample magewell.vah configuration:

You can easily find and edit the magewell.vah configuration by clicking on the Vahana configuration folder shortcut. The folder is located here:


At this point you should have all the videos displaying. If anything looks wrong on one of your source video, check that you have everything connected properly.


4. You can now access the output & interactive views to preview the spherical video:

The output will look mixed up as you connected your cameras in the same order as the sample configuration. In order to fix the output you will have to create a new calibration.


5. Go back to the source view and click on the calibration button:

Select fullframe fisheye and a FOV of 120 degrees. These settings correspond to GoPro cameras.


6. Hit the "Create" button to launch the calibration algorithm:

For a successful calibration each source video needs to hold enough details so that the algorithm can detect matching features between them.

The matching features control points are used by the calibration algorithm to optimize the camera position and geometry.

White walls or blue sky will typically fail to provide enough details to identify control points for a successful calibration. 


7. Hit the "Toggle cont" button to display control points:

When two videos provide overlap and don't display any control points, you will need to generate control points in these areas.

8. Rotate the camera so that new features can be detected in the areas where control points are missing:

Hit the calibration button again. The newly created will accumulate with the previous ones.

Repeat this step until you get a successful calibration. A successful calibration will automatically save the changes to your *.vah configuration file.

After a successful calibration, you can keep improving the calibration until you are fully satisfied with it.


10. Backup your calibration by duplicating the *.vah file:

At this point, you have a calibrated setup for your 6x GoPro rig. You can create multiple configurations with different calibrations to face various situations.


11. Keep track of the rig and HDMI capture setup:

Each individual camera should be positioned at the same index on your rig each time. Avoid repositioning the camera.

Each camera should be plugged to the same HDMI port every time you set up everything again in order to re-use your configuration with a previously created calibration.

Have more questions? Submit a request


Article is closed for comments.