To connect to a PC when using a mobile VR headset (Quest, Quest2) or to a different PC than the one you are currently on when using a PC VR headset or one of the 2D apps, you will first need to download and install the Remote Desktop Connection app on our Downloads page onto the computer you want to connect to.

By default, the file you download will go to your downloads folder which you can find by clicking File Explorer icon on the taskbar and clicking on ‘downloads’ on the left. Inside the folder, the file will be called “vSpatialRemoteWindowsSetup_release.exe”.
‍
Double click to run it and follow the instructions in the installer. After it has finished installing you can start the remote connection by running "vSpatial Remote Manager " located in the vSpatial folder on the Start menu.

Once the Remote Manager is open you will be asked to log in using the same email that you used for your vSpatial account. After entering your email, you will be sent a confirmation email to that inbox. After registering and confirming, simply click on the button to switch the connection to being ‘available’ and now you will be able to connect to this PC from vSpatial!

*Note that Remote Connect will not work if you attempt to connect to a remote server running on the computer you are running vSpatial on, not only is there no need to do so as you will be able to access all of your computers right from the vSpatial app itself it also causes issues with two different applications trying to use the same screen and has been disabled. Additionally, without a premium subscription, Remote Connect only works over LAN (both the device running vSpatial and the device running the remote manager being on the same router or local network).

We have versions for all current Oculus devices, and we support as many of the popular headsets as we can in our Steam version. See the downloads page for more details.
We have released our final version for the Oculus Go – there will be no future updates.

If you have any additional questions or concerns, reach out to us on Discord!

‍
‍

If you aren’t seeing the confirmation email in your inbox, there are a few places it might be going to. The first thing you can do is check that you entered your email correctly in the confirmation bar. Next, you can use the search bar in your email program of choice to look for the email. It will come from registration@vspatial.com
‍
If you can’t find it in your main inbox, it may be going into one of the other default inboxes or even into your Junk folder. On Outlook, make sure to check both your ‘Focused’ and ‘Other’ sections in your inbox and on Gmail, make sure to check under the Promotions and Social sections of your inbox as well. Checking your junk folder on Outlook in your browser is easy. Just go down to the Junk Email tab on the left. If you find a confirmation email there, you can click on the “It’s not junk” option to help outlook know to send confirmation emails to your main inbox in the future. We would love it if you would also click the option to report the email as not junk to Microsoft.

To check your junk email in Gmail in your browser, go to the inbox menu right below the compose button on the left. Scroll down until you see “More” with a drop down arrow and click on it. Scroll down again until you see “Spam”

If you are getting a message telling you the verification failed when you click the verification link, the most likely problem is that you clicked a link in an older email. Only the most recent email you receive has an active verification link. Double-check that the email you are looking at is the most recent one and keep in mind that the most recent one may have been filtered to a spam folder or a different part of your inbox. Verification emails are also only valid for 15 minutes after they are sent. After that time period, the link will no longer verify. If you can’t find the most recent email or it has expired, you can always wait about a minute and click in the app to resend a verification email. Just beware that when receiving two or more of the same email close to one another that your email will likely filter them to spam.

It likely means your C++ distributables are out of date and need to be updated. You can do this by either updating to a 2019 or newer version of Windows or you can download the updated distributables straight from the Microsoft website by going here, scrolling down to where it says Visual Studio 2015, 2017, 2019, and 2022 and downloading the one labeled “x64: vc-redist.x64.exe”. Once it downloads, double click the .exe file to begin the installation.

For running the vSpatial app in VR we recommend the specifications found here: https://www.vspatial.com/app/

For our Remote Connect, for the computer you want to connect to, we recommend:

We supported the Oculus Go in its early days and appreciate the time we were able to support it. Unfortunately Oculus has sunset this device and as part of that, their newest SDK's break support for the GO. We've had to make the hard decisions to support the latest and greatest devices and software Oculus provides at the expense of no longer supporting older devices like the Oculus Go and GearVR.

There are a couple of considerations here:
The VR device you’re on can have limits. The Quest maxes out to 4 active screens at a time and the Go maxes out at 3. The other consideration is your actual monitor. We move applications around your actual monitors in order to capture them. A 1080p display will only get 1 active display, 1440p can give you 3, and a 4k monitor can give you 4 active screens at a time. If you have multiple monitors, you’ll have more active screens. If you don’t want to buy another monitor, there are some great “fake monitors” you can buy here. For an HDMI monitor or Mini Display Ports that are on most laptops go here.

Above the clock, there is an “eyeball” icon. Click on that button to toggle controller labels. You'll also see labels for the environment in general.

There is currently no way to change the preset control mapping.

PC VR:

If you are running vSaptial from the Steam or the Oculus store the logs will be located at
C:\Users\YOURUSERNAME\AppData\Local\vSpatial\VR\LogFiles
‍
*if you happen to use both versions of vSpatial on the same computer the file for each day will contain the log information for both versions
‍
2D apps:
‍
The Windows 2D version logs are located at
C:\Users\YOURUSERNAME\AppData\Local\vSpatial\2D\LogFiles
‍
and the Mac 2D version logs are located at ~/Library/Application\Support/unity.vSpatial.vSpatial/LogFiles
‍
Remote Connect: The Remote Manager application running in the tray allows you to send a support email to both vSpatial and yourself with the logfiles as an attachment. To do so, right click on the vSpatial Manager icon and select "Support".
‍
For Windows on mobile headsets, the logs are stored on the headsets themselves and require a software tool to get a hold of, so don’t worry about trying to get it yourself.

We currently have a macOS 2D application you can use found here. We don’t currently support remote connections to macOS devices but are actively working on it.

If you are seeing pictures and not avatars for other people in a meeting then the first thing to do is to check if you have avatars enabled in your settings. Open the settings window and go to the Meeting tab. At the top, you will see the option to turn Avatars on and off. Make sure that the switch is turned on. If you have the avatars option on and you still are only seeing portraits, you are likely hitting the avatar limit for your mobile platform. Each platform has a different limit on the number of avatars it will show in one meeting in order to avoid the app slowing down and affecting your experience.
For the PCVR versions or the 2D app, there is no limit on the number of avatars you can have in a meeting. For the headset, you can only have avatars in a 1 on 1 meeting, and for the Quest, you can have avatars for yourself and up to 4 other people per meeting. If you go above the avatar limit, vSpatial will automatically switch displaying everyone from their avatar to their portrait (Don’t worry! This is just for the meeting and won’t change the preference you set in settings).

The Volume Viewer is currently limited to just PC versions of vSpatial as the mobile headsets (Go and Quest) don’t have the power to run it without seriously slowing down the headsets. We are working on optimizing it further to see if it can run on mobile headsets in the future.

This is such a broad category that it is impossible to cover everything, but a few common issues you can try yourself are listed here. If these don’t solve your issue please don’t hesitate to contact us on discord by clicking here!
The first thing you can try is updating your drivers, especially your GPU drivers. The best way to do this is by going to your GPU manufacturer’s website and downloading their recommended driver. If you don’t know what GPU you have, you can open Device Manager by going to the search bar in the taskbar at the bottom of your screen and search searching for “Device Manager”. Open it and click to expand the Display Adapters section, and there you should see your GPU.
‍
‍
Next, check and see if you have at least a 2019 version of Windows. In the search bar in the taskbar type ‘Check for Updates’ and click on the app it suggests. This will tell you if you have any updates that are waiting to be installed and by looking at ‘update history’ you are able to see when your last update was. vSpatial may also be falsely flagged by your antivirus as malware, especially if you are using the Remote Connect. To check whether this is happening please take a look at the question below this one.

The usual culprit for timing out is firewalls. Go to Control Panel\System and Security\Windows Defender Firewall\Allowed apps on your PC and make sure that “Remote Server” is allowed to communicate through the Firewall. A firewall external to your PC (e.g. a router for your house or business) could also be blocking connections.

- Remote Desktop Enhanced $4.99/month: Use your Quest to connect to your PC from anywhere (instead of just your local network)
‍
- Collaboration Enhanced $5.99/month: Collaborate with up to 16 users (instead of just 1-1)
‍
- Virtual Webcam & Mic $3.99 one time: Join Zoom, Teams, Slack, etc. Video calls with an avatar camera and using your Quest mic as the input for your meeting

We do not support the Microsoft Edge browser fully as there are issues with entering text into it within an app. You will be able to open Edge windows in the carousel, click in them, and even use the search/URL bar, but the rest of the text boxes will not respond to input. Other browsers like Firefox or Chrome (and other browsers based on them) don’t have this issue.

We are aware of this and we are working on a solution. Every browser treats pop-ups and dropdowns differently so there is no one-size-fits-all fix we can implement.

If you're seeing the error "Oculus entitlement timed out: Entitlement check failed with error 'user not logged in', http code -1. Cannot start vSpatial". This could be caused by Meta/ Oculus servers experiencing difficulties or your headset not on a good wifi/internet connection.