# Troubleshoot guide

Welcome to the ImmersiX Troubleshooting Guide. This guide aims to help you identify and resolve common issues you might encounter while using the ImmersiX application. Whether you're facing performance issues, initialization errors, or playback difficulties, this guide provides solutions to enhance your playback experience. For further assistance, please contact our support team.

{% hint style="warning" %}
If you are experiencing issues with your headset or its connection to the PC, please refer to the instructions from the headset manufacturer. For Meta Quest devices, you can find more information in the Meta Quest [Help Centre](https://www.meta.com/en-gb/help/quest/).
{% endhint %}

{% hint style="info" %}
Question? We're happy to help! Please [Contact us](/technologies/immersix/contact-us.md).
{% endhint %}

### Performance issue detected

The application has detected a performance issue which may effect your playback experience. We recommend checking out our [Performance guide](/technologies/immersix/performance-guide.md) to improve your immersive experience.

<figure><img src="/files/95171nlUwkJ9OLUIaKTP" alt=""><figcaption></figcaption></figure>

### No audio device found: Could not initialize scene audio manager

The application could not find an active audio device. Please plug in an audio device.

### VR initialization error -2: Could not create OpenXR instance

If an OpenXR instance cannot be created when launching the ImmersiX application, the Meta Quest Link application is not running. Please refer to step 3 in [Getting started](/technologies/immersix/getting-started.md) to install and set up the Meta Quest Link before starting the ImmersiX application.

<figure><img src="/files/SpFKTfJFQEvRMh0bPAT5" alt="Error message stating OpenXR is not initialised."><figcaption><p>OpenXR error (-2)</p></figcaption></figure>

### VR initialization error -4: No OpenXR headset or system found

If no OpenXR headset or system is found when launching the ImmersiX application, the Meta Quest Link application is not set-up correctly. Please refer to steps 4-6 in [Getting started](/technologies/immersix/getting-started.md) to set up the Meta Quest Link before starting the ImmersiX application.

<figure><img src="/files/0jMeDWNhjIM4QxmZOs9P" alt=""><figcaption><p>OpenXR error (-4)</p></figcaption></figure>

### GPU warning

The ImmersiX app requires an NVIDA graphics card (GPU) with the minimum recommended GPU being an NVIDIA GeForce GTX 1080 Ti (see [System requirements](/technologies/immersix/system-requirements.md) for more details). If this warning is shown, your system does either not include an NVIDIA GPU or the available GPU does not meet the minimum system requirements. You will likely observe playback issues when using the ImmersiX application.

<figure><img src="/files/Lpkre52HD6WbXoEirbeK" alt=""><figcaption><p>GPU warning</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.v-nova.com/technologies/immersix/troubleshoot-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.