A package for Max/MSP/Jitter to support computational worldmaking
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
externals merged files Jan 23, 2017
help merge help Apr 12, 2017
media adding broadcast mode to ws Mar 28, 2016
patchers vr.world : new messages added May 3, 2017
support openvr 1.0.2 sdk libs Jul 11, 2016
templates template bug ? Dec 5, 2016
.gitignore Update [htcvive] to 1.0.2 openvr SDK Jul 11, 2016
.gitmodules glm inline Jul 8, 2016
LICENSE.txt first commits Dec 11, 2015
README.md release cleanup Oct 19, 2016
icon.png merge icon etc. Oct 19, 2016
package-info.json release urls Oct 19, 2016


A package for Max/MSP/Jitter to support computational worldmaking

Currently includes:

  • oculusrift -- supports the Oculus Rift head-mounted display (developer kit and consumer models, currently Windows only)
  • htcvive -- supports the HTC Vive head-mounted display (currently Windows only)
  • ws -- a simple websocket server external for max, making it trivial to interact with browser-based clients (Windows/OSX)

Much more to come!


Download the package and place into your Max Packages folder. (On Windows, My Documents/Max 7/Packages, on Mac, ~/Documents/Max 7/Packages), then restart Max.

Take a look at patchers in the help and examples folders to get to know the package.


  • The [oculusrift] object depends upon having the Oculus Home software installed & calibrated. It is free.
  • The [htcvive] object depends upon having Steam and SteamVR installed & calibrated. It is free.

If you have trouble loading externals on Windows, you might need to install the visual studio 2015 redistributable package. It is free.

Hardware requirements for the VR objects ([oculusrift] and [htcvive])

Obviously, you need the respective Oculus Rift or HTC Vive head-mounted display hardware!

Creating a virtual reality world requires high-performance computer graphics -- with the current generation of consumer head-mounted displays, it requires the equivalent of two HD or better resolution screens rendering at 90 frames per second. At present the recommended PC requirements to cover both the Rift and the Vive are:

  • GPU: NVIDIA GTX 970 / AMD R9 290 equivalent or greater
  • Video Output: HDMI 1.4 or DisplayPort 1.2 or newer
  • CPU: Intel i5-4590 / AMD FX 8350 equivalent or greater
  • Memory: 8GB+ RAM
  • USB: 3x USB 3.0 ports plus 1x USB 2.0 port
  • OS: Windows 7 SP1 64 bit or newer (No OSX support at present)

Created by Graham Wakefield and the Alice Lab for Computational Worldmaking at York University, Toronto.