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!
Input Manager (virtual and physical) Space Change options (1) Zoom In/Out
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 firstname.lastname@example.org 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 our Remote Connect, for the computer you want to connect to, we recommend:
A PC, not a mobile windows device like a surface
A full version of Windows 10 (Windows Pro or Home or better) running at least the October 2018 Update (Version 1809 build number 10.0.17763)
Intel i5 4590 equivalent or greater with 8GB of memory
Connection to your LAN (IE your home/work network based on its router(s) ) with no network-level firewalls that can block vSpatial.
* We do not officially support mobile windows devices. Some may work and others we know will not, such as devices with Intel Core 7th Gen M3 processors. Your mileage may vary, but if it does work out, we would love to know!
Private Workspace Room
Input Manager (virtual and physical) Space Change options (1) Zoom In/Out
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.
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.
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.
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.
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.