Skip to content
Addon to bring virtual reality devices to the Blender viewport
Branch: master
Clone or download

Latest commit

Latest commit 8361cf1 Jul 25, 2016


Type Name Latest commit message Commit time
Failed to load latest commit information.
space_view3d_virtual_reality Set Oculus (latest) as default backend Jul 25, 2016
.gitattributes Git: .gitattributes Jul 25, 2016
.gitignore .gitignore update Oct 16, 2015
.gitmodules HMD SDK Bridge (build) submodule Oct 16, 2015 readme update Jul 25, 2016

Virtual Reality Viewport

Addon to bring virtual reality devices to the Blender viewport.

This is work in progress, use at your own risk.


Oculus Legacy (Linux, Mac, Windows)

  • Oculus 0.5 runtime

Oculus (Windows)

  • Oculus 1.5 runtime

How to Use

In the User Preferences, Add-ons, 3D View: Virtual Reality Viewport select the Display Backend you want to use.

In the viewport go to the toolshelf, select the Virtual Reality tab, click on the Virtual Reality button and follow the on-screen instructions.

Current State

Video of an old version of the plugin working:

Video of plugin in action

Easy Installation

You can get the latest version of the Addon here:

Advanced Installation

In a terminal paste the following commands:

$ git clone
$ cd virtual_reality_viewport
$ git submodule update --init --recursive --remote
$ zip -x __pycache__ -x */.git* -r9 space_view3d_virtual_reality

Now install the in Blender as an addon.


In a terminal paste the following commands:

$ git pull origin master
$ git submodule update --recursive --remote

Followed by the rsync command for your OS:


$ rsync -rv --exclude=.DS_Store --exclude=.git --exclude=*.blend1 --exclude=*.blend2 --exclude=*.swp --exclude=*.swo space_view3d_virtual_reality ~/Library/Application\ Support/Blender/2.76/scripts/addons/


$ rsync -rv --exclude=.DS_Store --exclude=.git --exclude=*.blend1 --exclude=*.blend2 --exclude=*.swp --exclude=*.swo space_view3d_virtual_reality ~/.config/blender/2.76/scripts/addons/

Optionally, instead of rsync you can generate a new .zip, remove the previous version of the addon and re-install it.


  • Upgrade Oculus SDK 0.7 to 1.3
  • Extend the external bridge library to support other HMD devices


Old Versions

For the previous version (with support for Oculus DK1 via runtime 0.7):


  • Visgraf / IMPA - for supporting the core of the addon development
  • Djalma Lucio for peer review and discussions about the bridge implementation
  • Campbell Barton - for reviewing and contributing to the patches for Blender core
  • Thanks for all the testers
You can’t perform that action at this time.