Skip to content
Native VR/AR/XR engine for JavaScript πŸ¦–
Branch: master
Clone or download
Latest commit dbaefb4 Apr 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
android Bugfix android CMakeLists.txt webrtc lib binding Apr 18, 2019
assets
buildtools Revert "Add buildtools: curl, unzip" Apr 15, 2018
deps Remove canvas 2d default font setting Apr 18, 2019
docs fix build error doc formatting Apr 17, 2019
examples Small text.html example cleanup Apr 18, 2019
lib Merge exokit-core Apr 28, 2018
metadata More program-device.mabu webrtc path bugfixing Apr 18, 2019
res/Icon_Grid Update magic leap icon model Dec 31, 2018
scripts Major android build scripts refactor Apr 18, 2019
src More gl context re-present bugfixing Apr 18, 2019
tests/unit Remove old zzz unit test Jan 12, 2019
.eslintrc.json add linter Jul 4, 2018
.gitignore Clean up .gitignore Apr 18, 2019
.travis.yml Add node_js version hardcode to .travis.yml Apr 13, 2019
BUILDING.md Update BUILDING.md Apr 16, 2019
CODE_OF_CONDUCT.md change webmixedreality to exokitxr Apr 7, 2019
CONTRIBUTING.md change webmixedreality to exokitxr Apr 7, 2019
Dockerfile Do not install optional modules in Dockerfile Feb 7, 2019
LICENSE.md Update LICENSE.md year to 2019 Apr 13, 2019
README.md Merge pull request #888 from chrisplatorres/move-icon Apr 14, 2019
appveyor.yml change webmixedreality to exokitxr Apr 7, 2019
binding.gyp Bump native-webrtc-deps version Apr 18, 2019
bugsnag.txt Add bugsnag.txt Bugsnag API key Jun 23, 2018
exokit.cpp
main.cpp Revert "Remove dead include from main.cpp" Apr 18, 2019
package.json Bump native-webrtc-deps version Apr 18, 2019

README.md

Exokit

Exokit

πŸ•Ά Native VR and AR engine for JavaScript πŸ¦–

Site β€” Docs β€” Discord β€” Slack β€” Twitter β€” Email List

Examples

Hands Reality Tab Live Reload Magic Leap Tutorial Reality Tab

Reality Projection with HTC Vive and Magic Leap Emukit Various Exokit Apps

Find more examples here and on YouTube.

Overview

This project enables developers to build XR experiences using the same code that runs on the web. Exokit engine is written on top of Node and emulates a web browser, providing native hooks for WebGL, WebXR, WebAudio, and other APIs used in immersive experiences.

πŸ‘“ Exokit targets the following platforms:

  • Desktop VR (Steam compatible)
  • Magic Leap
  • Mobile AR (ARKit / ARCore) *
  • Mobile VR (Daydream / Gear VR) *
  • Standalone VR (Oculus Quest/Go) *

* not supported yet

πŸ”Œ Since Exokit supports anything that runs on the web, it powers experiences built with:

  • Three.js
  • Unity
  • Pixi.js
  • Babylon.js
  • A-Frame
  • Custom WebGL frameworks
  • WebAssembly, TypeScript, and any language that transpiles to JavaScript

πŸ‘ Why Exokit?

  • You want your WebGL/WebXR to run fast.
  • You want the hot new web APIs.
  • You want to add your own integrations -- including native -- into a browser environment.
  • You want a lightweight browser as a hackable node module.
  • You want to combine the web with a 3D engine like Unity.

πŸ‘Ž Why not Exokit?

  • You're looking for a traditional "web browser".
  • You don't care about 3D or mixed reality.
  • You're looking for strict and/or legacy standards support.

πŸ“– Manifesto

  • The future is immersive. The web is the best application platform. Javascript is the best ecosystem.
  • Content should be hardware agnostic. Tomorrow will have different hardware. VR and AR should be compatible.
  • It's not possible to do both 2D and 3D well. We don't do 2D. We can use an external 2D browser.
  • Use your favorite game engine. Exokit is not a game engine.
  • Legacy browser design choices don't make sense in XR.
  • Exokit empowers and connect apps, even (especially) if they aren't designed to cooperate.
  • Apps should run in "reality tabs", layers of reality that blend together.

Quickstart

Desktop

Download for current OS

Run a WebXR site (desktop)

exokit https://aframe.io/a-painter/ # start A-Painter in Exokit

Magic Leap

Download for Magic Leap

Run (Magic Leap device)

mldb connect 192.168.0.10:1131 # mldb needs to be connected; see MLDB documentation
mldb install -u exokit.mpk # downloaded or built package
mldb launch com.webmr.exokit -v "ARGS=node --experimental-worker . file:///package/examples/hello_ml.html" # or URL to load
mldb log exokit:*

Architecture

Exokit is a Javascript Node.js module.

C++ bindings hook into WebGL, WebXR, Magic Leap, Leap Motion, and various other device APIs.

const {window} = require('exokit')() to get an immersive browser in another project.

Exokit runs on Windows, macOS, Linux (x64), Linux (ARM64), and Magic Leap (ARM64).

Web API support

  • HTTP/S
  • HTML5
  • <script>
  • DOM
  • WebGL
  • WebXR
  • WebVR
  • WebRTC
  • Canvas2D
  • WebSocket
  • Web Workers
  • <img>, <audio>, <video>
  • WebAudio
  • Keyboard/Mouse events
  • Gamepad API
  • <iframe>
  • HTML layout
  • HTML rendering
  • CSS
  • Legacy APIs

Hardware bindings

  • OpenGL
  • OpenVR (Steam VR)
  • Magic Leap
  • Leap Motion

Local Development

See full building instructions in BUILDING.md.

git clone https://github.com/exokitxr/exokit.git
cd exokit
npm install
node --experimental-worker . <url> # or node --experimental-worker . -h for home

Debugging

Uses ndb.

npm run debug

Then in the console, input:

let window = await require('./src/').load(yourUrl);

Now you have a handle on the window object as you test your application, and you can set debugger breakpoints, inspect memory, profile CPU, etc.

Questions

For questions and support, ask on StackOverflow.

Stay in Touch

Contributing

Get involved! Check out the Contributing Guide for how to get started.

License

This program is free software and is distributed under an MIT License.

You can’t perform that action at this time.