Skip to content

Humangle/VRTourEditor

Repository files navigation

HumAngle VR Tour Editor Documentation

This is an open-source VR storytelling tool for media organisations. This is used to display 360 images, tours, and videos across XR headsets, smartphones and computers. It allows you to design and generate XR experiences that can be embedded in web pages and launched to full VR for headsets and devices with ARCore/ARKit.

HumAngle VR Office Tour

Getting Started

  1. Go To humangle.github.io/VRTourEditor and select the "HumAngle Office Tour" Template. This is what HumAngle VR Office Tour was created with.
  2. To start a new project, make sure to insert your project name. Click on "+" to add the url links to your images. Your images can be hosted on github or any free platform that does not restrict access from another server (CORS policy). Tip: find the actual image location by right clicking and selecting "open image in new tab".
  3. If your project has multiple images, you can create connections between them from each image to form a Tour. The VR Tour would begin from the first image uploaded or any index selected.
  4. Export your project and host your generated web page online, you can embed it as shown in our How to Embed example and other examples in our 360 Embed Library.
<!--Replace "https://humangle.github.io/VRTourEditor/sample" with the link to where you have published your generated web page-->
<iframe src="https://humangle.github.io/VRTourEditor/sample" style="width:500px; height:300px; border:none;" allowfullscreen> </iframe>

Features

Add 360 Images and Videos

Create Connections

Insert Objects

Animator

HVRJ - HumAngle VR JSON Format

This is a JSON file saved with a .hvrj extension that lets you to externally store or share a copy of your project (only be edited with the HumAngle VR Tour Editor). This allows you to easily update your projects/tours in future.

{
	"header" : {
		"version" : 1.2002,
		"project" : "Project Name",
		"icon" : "https://raw-link.to/the-actual/project-icon-image.png",
		"image" : "https://raw-link.to/the-actual/project-preview-and-title-image.png",
		"audio" : "https://raw-link.to/the-actual/background-audio.mp3",
		"showpreview" : false,
		"autorotate" : false,
		"stereo" : false,
		"index" : "Name_Of_First_360_Image_OR_Video",
		"pan" : 0
	},
	"full" : {
		
	},
	"lite" : {
	
	},
	"objects" : {
	
	},
	"animate" : {
	
	}
}

How to Contribute

Send a pull request or Donate.

About

An Open Source 360/VR Tour Generator

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Sponsor this project

Contributors 2

  •  
  •