Skip to content
Virtual treatment tool to assist in exposure therapy
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
Readme Images -Folder structure is changed Jan 9, 2019
VivoosVR -Supports dual screen Jan 9, 2019
.gitattributes -Folder structure is changed Jan 9, 2019
.gitignore -Folder structure is changed Jan 9, 2019 Create Dec 7, 2017
ExcelLibrary.dll -Folder structure is changed Jan 9, 2019
LICENSE Create LICENSE Dec 7, 2017 - Feature tests link is updated. Jan 14, 2019
VivoosVR Feature Tests.docx - Feature Tests document is updated. Jan 14, 2019



BSD 3-Clause



VivoosVR is a virtual treatment tool to assist in exposure therapy where participants are placed in a computer-generated 3D virtual world and guided through the selected environments, situations and conditions.

Physiological values of the participants are constantly monitored via GSR and pulse sensors. The system is designed to be used by qualified therapists and our target participants are young people suffering from phobias and social anxiety.

Simulation worlds have been created using Unreal 4 game engine and we support popular VR HMDs such as Oculus Rift and HTC Vive. We also have plans to optimize the system for mobile VR solutions in the near future.

VivoosVR is being developed in cooperation with a team of psychology / psychiatry experts.


Git initialisation

GitHub Desktop

  1. Download and install GitHub Desktop

  2. Run GitHub Desktop Application and click on File -> Clone Repository: Screenshot of Clone Repository

  3. Click on "URL" tab and copy the following link of the VivoosVR Repo and paste it on the URL part: Screenshot of PasteRepoLink

  4. Set local path of the repo

  5. Click on "Clone" to complete connecting to VivoosVR Repo using GitHub Desktop.


SQL Server Management Studio

  1. Locate "Database" folder in your local repo path and copy "Vivoos.bak" file in this folder to "C:\Program Files\Microsoft SQL Server\MSSQL14.SQLEXPRESS\MSSQL\Backup"

  2. Open the SQL Server Management Studio and login. In the Object Explorer tab, right click on "Databases" and select "Restore Database".


  3. Select Device part, click add and find "Vivoos.bak" file




  4. Close the SQL Server Management Studio Application.

Scenario Installation

If you wish to use the scenarios below in VivoosVR, you need to execute following steps:

  1. Click on the link which belongs to the scenario you would like to add.
  2. Download the zip in the link
  3. Extract the zip into the VivoosVR Scenario folder (Default Path: C:\Scenarios) (If the folder does not exist, you need to create the folder manually)

Links to the latest version of the scenarios can be found below:

  1. Fear of Dogs - Park Scenario - version 0.9.2
  2. Fear of Height - Balcony Scenario - version 0.9.6
  3. Fear of Spiders - Living Room Scenario - version 0.7.1
  4. Fear of Dark - Childs Room Scenario - version 0.9.2
  5. Social Anxiety - Classroom - version 0.9.6
  6. Fear of Height - Elevator Scenario - version 0.7.5

WebVR related links can be found below:

  1. Fear of Height - Balcony Scenario - WebVR:
    1. Build: Fear of Height - Balcony Scenario - WebVR version 0.8.0
    2. Try: Fear of Height - Balcony Scenario

How to Use


  1. If you click the exe of the program (VivoosVR\VivoosVR\bin\debug), login form welcomes you. Default user: Username: user Password:123 Default admin: Username: admin Password:123 You can add new users in admin page.


  1. For using the scenarios, you can download them in the github. Default path is C:/Scenarios. You can create a folder named Scenarios and copy the scenarios in this folder. If you want to copy another path, please login with the admin password and change the scenarios path. (Login -> Find the scenario and click edit -> Change the path)



  1. If you login with the default user password, the first screen you will see is the patient page. You can see a list of your patients in this page. You can also add new patients or you can edit existing patient information.


  1. You can click the “Session List” of one of your patients. In this page, you can see the sessions of the selected patient. You can also download the data (GSR and Pulse data due to the time) of the session or delete the session.


  1. By clicking the “New Session” button in the “Sessions Page”, you can choose and begin any of the existing exposure scenarios.


  1. In the “New Session Controls” page, you can trigger and control scenario events. Moreover, you can track the anxiety level of the patient through GSR and pulse graphs.




Currently VivoosVR communicates with the following modules and sensors of the Neulog:

You need to perform following tasks to make Neulog modules and sensors work correctly with VivoosVR:

  1. Plug USB module, Heart Rate & Pulse Logger Sensor and GSR Logger Sensor to each other and plug them to your computer via USB Port (Order of the modules are not important!)


  1. Attach handle of the heart rate and pulse sensor to little finger of your right hand in a way that glassy side of the handle touches the bottom side of your finger


  1. Attach the handles of the gsr module to ring finger and index finger of your right hand in a way that metal part of the handles touches the bottom side of your finger



How To Examine UE4 Project Stats

You need Unreal Engine 4 in order to examine the given stat files in the folder (Recommended version: 4.18 or above).

Assuming you have the stated Unreal Engine 4 version, you need to perform the following steps:

  1. Open any compatible Unreal Engine 4 project

  2. Open "Session Frontend" panel from Window > Developer Tools > Session Frontend 1

  3. Click on "Profiler" tab 2

  4. Click on "Load" button and locate the desired stat file 3

Click here for the project stat files

Feature Tests

You can download the document regarding feature tests of VivoosVR User Interface through this link.

You can’t perform that action at this time.