[[file:./doc/SimulaLogoHorizontal.png]]
[[https://simulavr.com][Simula]] is a VR window manager for Linux that runs on top of [[https://godotengine.org/][Godot]]. It takes less than 1 minute to install.
For the past few years we've been focused primarily on our custom VR computer hardware. Please check our [[https://simulavr.com][website]] for details.
[[http://www.youtube.com/watch?v=FWLuwG91HnI][http://img.youtube.com/vi/FWLuwG91HnI/0.jpg]]
Video: [[http://www.youtube.com/watch?v=FWLuwG91HnI][Demonstration.]]
Compatibility: Simula is officially compatible with SteamVR headsets equipped with Linux drivers (e.g. HTC Vive, HTC Vive Pro, & Valve Index). We have also added experimental support to OpenXR headsets that have Monado drivers (e.g. North Star, OSVR HDK, and PSVR). Some people have gotten the Oculus Rift S to run Simula via OpenHMD (see [[https://github.com/OpenHMD/OpenHMD/issues/225#issuecomment-638454156][here]]), though we have not officially tested this ourselves.
Mission: Facilitate a Linux future for VR & AR Desktop. In the short-run, this means allowing people to run 2D Linux apps with current generation headsets. In the long-run, this means allowing people to run Linux in standalone AR & VR HMDs.
Simula One Headset: We are also in the process of developing a (limited number of) portable VR headsets for sale which come with SimulaVR mounted on them by default. If you are interested in purchasing one, [[https://simulavr.com][visit our website]] and join our waitlist to receive a place in line and/or periodic updates on its development.
Origins: Simula is a reimplementation fork of [[https://github.com/evil0sheep/motorcar][motorcar]]. To read about motorcar, see /[[https://github.com/evil0sheep/MastersThesis/blob/master/thesis.pdf?raw=true][Toward General Purpose 3D User Interfaces: Extending Windowing Systems to Three Dimensions]]/
A common objection to the viability of VR Desktop is that it exhibits poor text quality; however, with our low pass filter, Simula has taken special care to make text quality as clear as possible:
[[./doc/TextQuality2.gif]]
The left image is a VR terminal /without/ our filter applied; the right is the same image /with/ our filter applied. Compared to other VR Desktops, Simula allows for significantly longer sessions without uncomfortable eye strain.
To install Simula on all Linux distros, run:
git clone --depth 1 --recursive https://github.com/SimulaVR/Simula cd Simula
source ./utils/Helpers.sh && installSimula
./result/bin/simula # Needs SteamVR to be running
Installing Simula should take less than 1 minute: this script doesn't actually compile anything on your system, but instead downloads the appropriate binaries from our cache in a way that is system and driver agnostic. Under the hood, we (i) check whether you have ~nix~ and ~cachix~ installed (and, if not, install them); (ii) check which graphics drivers you have and (iii) download Simula via ~cachix~ with the appropriate driver flags, falling back to a ~nix~ build if downloading fails.
On NixOS systems, you must ensure
nix.settings.trusted-users = [ "root" "
is added to your ~configuration.nix~, or the install command above will be unable to download Simula from our cache, instead falling back to a manual build (which takes 1hr+).
** OpenXR Backend (Optional)
If you want to avoid using SteamVR, Simula supports an optional OpenXR backend (e.g. [[https://gitlab.freedesktop.org/monado/monado][monado]]). To use, adjust ~_backend~ from ~OpenVR~ to ~OpenXR~ in ~./config.dhall~. You will then be required to ensure that an OpenXR runtime (e.g. ~monado-service~) is running on your system before launching Simula. In addition, you must tell Simula where your ~libopenxr_monado.so~ is located:
monado-service & XR_RUNTIME_JSON=/path/to/your/openxr_monado-dev.json ./result/bin/simula
with ~openxr-dev.json~ encoding the location of your ~libopenxr_monado.so~:
{ "file_format_version": "1.0.0", "runtime": { "library_path": "/path/to/your/openxr/build/src/xrt/targets/openxr/libopenxr_monado.so" } }
** Updating
To update Simula to the current ~master~ (without losing your configuration adjustments), simply run
./source/Helpers.sh && updateSimula
** COMMENT AppImage
Simula requires ~xpra~, ~xrdb~, ~wmctrl~, and ~terminator~. We keep a bleeding edge ~AppImage~ of Simula synced to a tarball, which can be used as follows:
wget -c https://www.wolframcloud.com/obj/george.w.singer/SimulaAppImage.tar.gz -O - | tar -xz cd ./Simula chmod +x ./bin/godot.AppImage ./bin/godot.AppImage --path $PWD # launches Simula (requires SteamVR to be running)
** COMMENT Bleeding Edge Binary
We keep a bleeding edge version of Simula synced to the following tarball:
wget -c https://www.wolframcloud.com/obj/george.w.singer/SimulaBleedingEdge.tar.gz -O - | tar -xz cd ./Simula ./bin/godot # launches Simula (requires SteamVR to be running)
For installtion troubleshooting, [[https://gitter.im/SimulaVR/Simula][just ask us directly]].
Windows become "active" once you look at them. Active windows receive typing events from the keyboard, and cursor events from mouse movement. In addition, the following window-manipulation shortcuts are provided by default into Simula (these can be adjusted by changing ~./config.dhall~):
| Key binding. | Action |
|--------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------|
| ~Super + Shift + Escape~ | Terminate Simula |
| ~Super + z~ | Toggle Simula's mouse & keyboard grab from your host OS (see below) |
| ~Super + /~ | Quick launch terminal |
| ~Super + Apostrophe~ | Send window cursor to gaze point (hold down to make cursor follow gaze) |
| ~Super + Enter~ | Left click surface cursor at gaze point |
| ~Super + Shift + Enter~ | Right click surface cursor at gaze point |
| ~Super + Alt~ | Grab surface for movement (release to let go) |
| ~Super + m~ | Grab all surfaces for movement (release to let go) |
| ~Super + Shift + m~ | Grab all surfaces /in all workspaces at once/ for movement (release to let go) |
| ~Super + a~ | Launch Simula's app launcher ([[https://launchpad.net/synapse-project][synapse]]) |
| ~Super + e~ | Cycle Simula's background environment |
| ~Super + f~ | Orient window towards user gaze |
| ~Super + 9~ | Scale window to smaller size |
| ~Super + 0~ | Scale window to larger size |
| ~Super + <number between 1 and 8>~ | Switch to workspace
NOTE: In order to prevent Simula's keyboard shortcuts from conflicting with your existing window manager's shortcuts, Simula "grabs" the system keyboard and cursor from your host OS to prevent input events from propagating past Simula. This creates a problem: it is then impossible for you to escape Simula once you launch it! In order to get around this, press ~Super + z~ to ungrab Simula, which will restore mouse and keyboard control to your normal window manager.
** VR Controllers
[[https://www.evetech.co.za/repository/ProductImages/htc-vive-controller-730px-v1.jpg]]
Left-clicking. Use (7) gently (you don't have to go all the way down to click).
Right-clicking. Use (1).
Scrolling. Scroll up and down via (2).
Text dragging. Hold (7) down and drag.
Window manipulation. Point at a window and, while holding (8), move your controller around. The windows should "levitate" in the direction of your movement.
Window rescaling. Point at a window, hold (8) down, and then scroll up and down on (2).
** Mouse & Keyboard View
Simula has a headset [[https://www.youtube.com/watch?v=D5c3Hfp8Hcw][webcam view]] (binded presently to ~Super + w~) that allows you to see your mouse and keyboard from VR.
** Configuration
** COMMENT Recovering Simula Apps
Apps launched in Simula persist across sessions via an [[https://xpra.org/][xpra]] server running on ~DISPLAY=:13~. This means that if Simula exits (perhaps by a sudden crash), all you need to do to recover your apps is to relaunch Simula.
If instead you'd like to access your apps from outside Simula, run
xpra attach :13
and they will appear on your current ~DISPLAY~. Running ~xpra stop~ (or just ~pkill xpra~) is a quick way to kill all apps associated with your Simula session(s).
We are in the process of developing a (limited number of) portable VR headsets for sale which come with SimulaVR mounted on them by default. If you are interested in purchasing one, [[https://simulavr.com][visit our website]] and join our waitlist to receive a place in line and/or periodic updates on its development.
For troubleshooting and discussion, join our community at https://discordapp.com/invite/a4PnP7n.
[[https://gitter.im/SimulaVR/Simula][file:./doc/GitterBadge.png]]
Simula is in alpha phase, and can be difficult to get working on many setups. For help with installation, please visit our [[https://gitter.im/SimulaVR/Simula][chat room]]. Note that Simula has only been tested on Ubuntu 19.04 (Disco Dingo), but the instructions below should in principle work on (i) older versions of Ubuntu and/or other distros that use ~apt~ (i.e., Debian) or (ii) Arch Linux (or distros that use ~pacman~).
Clone Simula and install its dependencies. Depending upon your distro, you'll need to run some combination of ~make ubuntu~, ~make arch~, ~make nvidia~ and ~make amd~.
git clone --recursive https://github.com/SimulaVR/Simula cd Simula
make ubuntu # Installs needed packages via apt-get
Compile Simula. Warning: this can take a while.
make all
Launch Simula. You must first launch SteamVR before you can run Simula.
steam & # First launch SteamVR from steam make run # ..then launch Simula
Launch some apps. Once Simula starts, launch some Wayland apps to interact with (at this point Simula only supports Wayland apps). Apps must be launched with ~WAYLAND_DISPLAY~ set to ~simula-0~.
WAYLAND_DISPLAY=simula-0 sakura # Wayland-based terminal WAYLAND_DISPLAY=simula-0 epiphany # Wayland-based web browser
Any errors can be immediately helped with in [[https://gitter.im/SimulaVR/Simula][Simula's chatroom]]. Here are some helpers though:
Driver errors. If you get driver related errors, try running ~make nvidia~ or ~make amd~ to try to upgrade to the latest drivers for your respective video card. These helpers only work on Ubuntu/Arch:
make nvidia # If needed: installs nvidia-driver-418 (via apt-get) make amd # If needed: installs mesa-vulkan-drivers and other packages for SteamVR on AMD (via apt-get)
Godot errors. If you get godot related errors, trying rebuilding ~godot~ from scratch:
make godot
Wlroots errors. If you get wrloots related errors (i.e., any error that complains about missing ~wlr_*~ references), try rebuilding wlroots from scratch:
make wlroots # If you have trouble launching Simula, try recompiling Godot via this command.
Unable to launch a particular app. Many Linux apps don't work right now in Simula (technically: any app that doesn't implement the XDG Wayland protocol). We're working on fixing this ASAP so that all Linux apps are compatible with Simula. This should be done by end of month (June 2019).
We're looking for open-source contributors. If you're interested in using Haskell to bring VR and Linux together, drop by our [[https://gitter.im/SimulaVR/Simula][chat room]], or email georgewsinger@gmail.com.
If you're interested in a future where Linux and VR co-exist, you can donate to the following addresses:
Bitcoin. 17YLp6kJswxa8gGKwXqLrNtnM9Fgye6dfQ
Ethereum. 0x373227b43Fe1eFe8da9d30ED1Ee45E7488F6cab3
PayPal. george.w.singer@gmail.com
** COMMENT Project Expenses
Project Expenses. Donations to the project pay for the following expenses:
See Simula's [[https://github.com/SimulaVR/Simula/wiki][Wiki]] for our Master Plan and list of Monthly Updates.