Welcome to the LIV Wiki!

This wiki is under construction! If you would like to help please create an account and participate in creating some pages! Let us know on our Discord if you are so we can put you in the credits, and distribute virtual hugs : )

Massive thanks to Ragesaq (https://twitch.tv/ragesaq) for setting up the Wiki server for us. You're a rockstar.


Contents

About LIV

LIV is a windows app available on Steam for creating Mixed Reality in VR using the openVR API. It is currently officially supported on the HTC VIVE and Oculus Rift using SteamVR. Windows Mixed Reality support is forthcoming.

LIV is still in Early Access, and we're working diligently in improving stability and performance across all devices and hardware configurations. We're still a small team of nerds who are working on this because we absolutely love what we do, and want to empower more people in VR to create compelling VR content. In other words, LIV is the result of Ikigai from everyone involved, including you fine folks in our community.

Thank you for all your continued support!

Official links

Before you get started


We currently only support games that you own on Steam. Oculus exclusives are not currently supported. AMD GPUs are also not currently supported!

Required Hardware


Oculus Rift or HTC VIVE
VR Ready PC with

  • GPU: Nvidia 1070 or higher
  • CPU: AMD Ryzen/Intel i7 or better
  • Webcamera or DSLR camera
  • Optional: Capture card (needed if you are not using a webcam)
  • Greenscreen
  • Update! We're beta testing green-screen less background removal using the Kinect V2. Hop into our Discord and sign up for the beta in the #no-green-screen channel.


Incompatible Hardware

The following hardware does currently NOT work with LIV:

  • AMD Radeon GPUs
  • Blackmagic capture cards

Required Software


Download the LIV Client on Steam

LIV is the app that will handle the compositing for you!

OpenVR Advanced Settings Plugin

The OpenVR Advance Settings plug-in can be used to rotate/zoom in-out your playspace, allowing you to get a good camera angle.
This is also very useful if you are preparing non-live content with a static camera or need to get the correct angle for a live stream.

Recommended Cameras


Generally speaking, any camera that is picked up as a Webcamera should do the trick.

Cameras that our users have confirmed work with LIV.

Webcameras

  • Logitech C920
  • Logitech C922
  • Logitech C930e
  • Logitech Brio


Action cams and DSLRs (these require a capture card, read more in the Recommended Capture Card section.

  • GoPro Hero 5
  • GoPro Hero 6
  • Panasonic G7
  • Canon 6D
  • Canon 550d
  • Panasonic GH5


You're welcome to try other cameras and report back on compatibility.

Recommended Capture Cards


Generally speaking, any low latency card from Avermedia or Elgato should work. Capture cards that our users have confirmed work well with LIV:

  • Avermedia LGX
  • Avermedia Extremecap U3
  • Elgato HD60 Pro
  • Elgato 4K
  • Avermedia Live Gamer HD2


You're welcome to try other cameras and report back on compatibility.

Recommended Software


Download the LIV Client on Steam

LIV is the app that will handle the compositing for you!

OpenVR Advanced Settings Plugin

The OpenVR Advance Settings plug-in can be used to rotate/zoom in-out your playspace, allowing you to get a good camera angle.
This is also very useful if you are preparing non-live content with a static camera or need to get the correct angle for a live stream.

Setting Up An Effective Green Screen


Big thanks to VRJosh (https://twitch.tv/vrjosh) for putting this segment together!

Key Points:

  • Remove all wrinkles/folds from your greenscreen, remove as many shadows as possible.
  • If using multiple greenscreens, cover any seams with green gaffer tape
  • Ensure you have lots of static light, preferably from multiple diffused light sources
  • If possible have your greenscreen set in an interior room with as little ambient/outdoor light as possible.


The primary concern when setting up a greenscreen is to provide a smooth, uniform surface in the background of your shot. This means trying to get rid of any wrinkles or seams in the greenscreen as these create shadows which are harder to key out.

The easiest way to create a smooth greenscreen is to hang a single screen from a supporting beam and let gravity pull it straight. However, to get a wider mixed reality shot you may wish to cover another wall and the floor with greenscreens.

This might require you to use 2 or more screens, in which case you'll want to use some green gaffer tape to cover the seams.

In addition to the screens themselves, the other most important factor is lighting. To get a smooth background image you'll want to preferably use at least 2 strong light sources with diffusion filters. This will spread out the light evenly and prevent your own shadow from potentially interfering with the chromakeying.

Another important thing to consider is where in your house/office to place your greenscreen set. Rooms with exterior windows, particularly windows that receive direct sunlight, are going to provide extra challenges due to the ambient lighting changing throughout the day which may change the apparent color of the greenscreen.

If you must place your set in a room with a window, you may want to place some extra dark window coverings over it (unless you're doing all your recording/streaming at night).

You can get most of the required equipment of places like Amazon or your local hardware store.


Setting Up LIV Mixed Reality


Pre-face

LIV is still in Early Access, and there are lingering bugs and user experience changes that we need to implement before it's "dead simple" to use. We ask for your support and understanding during this time, and are excited to push VR spectatorship to the next level with you.

This guide is to help you get set up with Mixed Reality using the LIV Client.

It will cover the following steps:

  • Installing the LIV Virtual Camera Driver (or setting up your third controller/VIVE tracker)
  • Generating your camera configuration file
  • Setting up your camera
  • Setting up your chroma key settings and scene settings
  • Choosing your output quality
  • Launching the game in Mixed Reality


This guide assumes you've already completed your VR hardware setup (including room-scale setup).

Installing Your LIV VIRTUAL CAMERA DRIVERS


Launch LIV through your Steam Library (do not launch the compositor)

Launch LIV on Steam

Quit SteamVR if it is running.

Install the LIV VIRTUAL CAMERA DRIVERS

Install LIV Camera Drivers

Restart SteamVR and power on your controllers.

Relaunch LIV and launch the compositor. SteamVR should show you your new LIV Virtual Camera Drivers. They will be gray until you launch LIV and the compositor -- this is intended!

SteamVR Window

Creating Your LIV Camera Profile


Open up LIV and launch the compositor.

In LIV, go to the Camera Tab and click ADD to create a new profile. It will open up your Camera Profile window.

Add camera profile in LIV

Pick your Camera and the resolution.

Pick your camera resolution

In your Camera Profile window, go to CALIBRATION

Go to Calibration in your LIV Camera Window

Click on Begin Calibration to start the Calibration process. You'll do the calibration inside the headset!

Calibrating your LIV VIRTUAL CAMERA


Here's a clip from LIV streamer QTPOP of him doing the calibration.

Below there are also written instructions.

Step 1) Bring your controller all the way up to your camera lens. You want the controller to be touching the camera lens, but make sure you don't accidentally move the camera while doing the calibration. The slightest motion may off-set your calibration.

ON VIVE: Line up the middle of the hole of your controller with the middle of the red cross.
ON RIFT: Line up the middle of your trigger button with the middle of the red cross.

Step 2 and 3) Move back into your play space until the distance meter turns green while doing the next two clicks (top and bottom corner!)

The same applies for Step 2 and 3 as it did for Step 1: make sure you line up the middle of the hole of your VIVE controller/the middle of your RIFT trigger button with the middle of the crosses.

For all these steps, make sure the orientation of your controller remains the same on each click. You want the controllers to be facing your camera.

VIVR calibration imagery

If you did the steps right, your virtual controllers should show up and be close to perfectly aligned with your real controllers.

Crispy calibration
(You can't tell, but that's actually a virtual controller overlaid on a real controller -- can you say CRIIIISPY calibration?)¸

If the calibration is way off, you're better off redoing the calibration. Make sure you maintain tracking throughout the entire process.

If your camera is outside of tracking range, you'll need to move it closer. You can also lose tracking by blocking your sensors with your body, so be cautious of that.

If they are almost perfect, you can do small manual adjustments using the provided controls to play around.

Once you have a result you're happy with, save your calibration!

Launching A Game In Mixed Reality With LIV

Go to CAPTURE, then AUTO in LIV:

Capture your game in LIV


Select your game from the dropdown list. Here is what each label means:

  • SDK-Supported - The developer has integrated our SDK. Apart from performance gains in the background, it means you can launch the game at any resolution without having to worry about your screen supporting it.
  • Fully supported - The game has been tested & confirmed to work well with LIV. You can only launch the game at HALF the resolution of your screen. If you have a 1440p screen, the highest resolution you can launch the game at is 720P.
  • Possibly supported - The game might work with LIV. This applies to all Unity titles as they work out of the box unless the developers intentionally disable, or add post-processing effects that mess with the mixed reality output. Try it out and let us know how it goes!

Note: Unreal Engine games can sometimes be in the Possibly Supported list - check there if you don't see it!


Once you've found your game:

  1. Choose a "Target Resolution" - this will affect performance! The lower you go, the less GPU will be used.
  2. Pay attention to any "Quirks" listed!
  3. Click "Launch"! You'll need to do this every time your calibration changes, or you change camera profiles.
    You can even do it with the game still running!


How do I know that it is working?

SDK-SUPPORTED games

Check your LIV Client Output window. It should be a static (not moving) frame of the game, and if you walk into your camera frame you should see your virtual controllers/hands matching up with your real ones.

Easiest way to get to your LIV Client Output window is to either hold ALT and press Tab to get to the window, or by hovering over LIV in your Taskbar and selecting the LIV Client Output window.


NON-SDK (LEGACY) games

Your game will break into what's called "Quadrant" mode:

Quadrant Mode


  • The top two quads ought to be mostly black and not moving.
  • The bottom left quad ought to show the background of the game, and not be moving.
  • The bottom right quad ought to show a small portion of your First Person View, and be moving when you move your headset.


If those things are right, you should see your mixed reality view in your LIV Client Output window!

Easiest way to get to your LIV Client Output window is to either hold ALT and press Tab to get to the window, or by hovering over LIV in your Taskbar and selecting the LIV Client Output window.


Streaming & Recording Mixed Reality


You can record and stream with software like OBS, Xsplit and Shadowplay, and there are many more options for you to explore.
We'll go over OBS setup as it's the most commonly used.

OBS Setup


Game Capture (Suggested)

  • Add a new Game Capture Source to your OBS Source List.
  • Select capture.exe as your Game Capture Source.


Window Capture

  • Add a new Window Capture Source to your OBS Source List.
  • Select the window you want to target in your window list.


LIV OBS Plugin

To install:

  • Right-click LIV in your Steam library, and click "Properties"
  • Click the "Local Files" tab
  • Click "Browse Local Files..."
  • Go into the "resources" folder, then "OBS"
  • Next, you'll want to open a new File Explorer window, and navigate to where you installed OBS. This is usually in "C:\Program Files (x86)\obs-studio\"
  • Go into the "obs-plugins" folder, then "64bit"
  • Copy the "obs-liv-capture.dll" from the first folder into the plugins folder


Once you've got your game feed into OBS/Xsplit, it's business as usual. You can add your own overlays, play around with your encoding settings and get your stream going!

Make sure you share your LIV streams to our #live-with-liv channel on Discord -- our community would love to see it!

Best Practices For Streaming MR


Viewport:

Most of you will be doing mixed reality from a static angle. Framing your static angle is crucial to getting good footage.

Put yourself in the shoes of your audience and ask yourself: what vital information do I need to show the audience for them to have a complete understanding of what is going on in the game?

Examples

If you are playing a rhythm game in mixed reality, your audience wants to see:

  • where the notes/blocks/balls are coming from
  • your current combo counter
  • your current score counter


If you are playing a shooter game in mixed reality, your audience wants to see:

  • the direction that you are looking in/aiming in
  • information around ammo/minimap/your health etc.


This specifically will be game dependent, as a lot of VR games aren't using HUD elements like in traditional games.

In short, you need to learn what your audience wants to see, and tailor your mixed reality stream towards that.

Some games are better suited for mixed reality than others, in particular if you are looking to live stream. With non-live content, you can cut and edit your videos to your heart's extent. With live streamed content, you need to be extra diligent in making sure you're providing a thoughtful spectator experience.

If you are unsure, hop into our Discord and ask around! We'd be happy to help!


Common Problems And FAQ

Having trouble? Check the questions below to see if they might help you.


My calibration looked great in the calibration tool, but in games it's really off. What am I doing wrong?

It sounds like you've calibrated to the wrong device. Before you start the calibration, make sure you have the Static(Virtual) device selected in your Camera Tab in LIV (Under Virtual Camera), or the tracker/third controller that you are using as your third tracked device.


When I launch a game with LIV, my Virtual Camera is much higher/lower than it should be

It sounds like you've calibrated to the wrong device. Before you start the calibration, make sure you have the Static(Virtual) device selected in your Camera Tab in LIV (Under Virtual Camera), or the tracker/third controller that you are using as your third tracked device.


I only get one controller when playing games with LIV!

There are a couple of reasons why this might happen - and here's the most common solution:

  1. Start LIV, and launch the compositor.
  2. In the Camera tab, set the Virtual Camera class to "Tracker".
  3. Make sure one of the LIV icons is green in the SteamVR Status window.
  4. Put your HMD on, and open the SteamVR Dashboard
  5. Go to Settings
  6. Go to Bindings
  7. Go to Manage Trackers
  8. Find the LIV device, and set it to "Disabled"

This should bring your other controllers back!


If your calibration is now wrong, and it's an older game:

  1. Go back into LIV, in the Camera tab.
  2. Set the Virtual Camera class to "Controller".
  3. Make sure you're holding both of your real controllers as you launch the game. SteamVR is trying to work out which ones are your left/right hands!


My LIV drivers are greyed out, how do I turn them on?

Your LIV Drivers are intentionally set to "sleeping" after every SteamVR restart. You need to turn on your controllers, launch LIV, and the compositor for them to activate.

If they don't turn green when you launch the compositor, go to your Camera tab in LIV and check the checkbox called "Enable Virtual Camera Driver" and make sure your controllers are turned on!

My LIV drivers turn grey when I close LIV

As of the latest update, this is intended behavior. You can opt-in to always having the LIV Drivers active. Go into your Camera Tab in LIV and uncheck the checkbox that says "Disable on Exit"


I can't do roomscale setup ever since I installed LIV

For a small number of users, the LIV Virtual Camera driver causes some issues when you try to setup roomscale. To fix it, just launch LIV, click the "Uninstall" button on the first screen, redo roomscale setup and then re-install the driver again


My LIV Client Output is completely black

This is either because you are on an AMD Graphics Card, or because you have several GPUs/an integrated GPU and your LIV + SteamVR are running in separate graphics cards.

To check which GPU your processes are running, go into your Task Manager (Cntrl + Shift + Escape), head to the Processes Tab and check out the GPU Engine Column.


  1. If you need to change which GPU your capture.exe runs on (to make sure it runs on the same GPU as all your Steam and SteamVR processes), you need to:
  2. Right click on your desktop and select Nvidia Control Panel
  3. Go to Manage 3D Settings
  4. Go to Program Settings
  5. Click on Add Process
  6. Navigate to LIV's Capture.exe in \Steam\Steamapps\common\LIV\capture.exe
  7. Change the preferred graphics processor to High Performance NVIDIA processor
  8. Hit save and try to capture with LIV again!


I'm on the Oculus Rift and sometimes LIV works for me, and other times it doesn't! What's going on?

The Rift has a proximity sensor on the inside the headset. The proximity sensor needs to be triggered for the Rift to render certain textures, textures that are crucial for LIV to work.

In general, when doing anything on the Rift, a good habit is to have the headset set your head (not necessarily over your eyes) so that the proximity sensor is triggered.

Another hack Rift users do is to tape a little piece of cloth or paper infront of the proximity sensor, so you don't have to worry about it.


I tried to capture a game using Manual Mode in LIV but my calibration is way off!

Capturing a game in Manual Mode doesn't automatically update your externalcamera.cfg file. There are two ways to go about this. You can either relaunch the game using Auto Capture in LIV, or you can manually copy your externalcamera.cfg file into the game folder (the game that you're trying to launch).

You can export a copy of your externalcamera.cfg file by going into Camera -> Edit -> Calibration and hitting the export button.


How do I uninstall the LIV Drivers?

  1. Launch LIV but don't launch the compositor.
  2. Close down SteamVR.
  3. Click Uninstall on the LIV window.

That's all! We're sad to see you go, if you have any feedback or want to share your reasons, we'd love to hear them.


I am experiencing crashes, how do I figure out what's wrong?

This is a tough one! With the wildly different hardware setups, camera settings, HMD options and software configurations (including the ever so pesky Windows), it's impossible to say for sure what your issue is.

The best solution is to hop into our Discord and write a message in #software-support, and one of our team members will hop in and help you troubleshoot : )

Creating Mixed Reality with LIV and depth sensors