> For the complete documentation index, see [llms.txt](https://portalgraphvr.gitbook.io/portalgraph-document-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portalgraphvr.gitbook.io/portalgraph-document-en/how-to-use-portalgraph-app/vive-tracker-guide.md).

# VIVE Tracker Setup Guide

This guide explains how to configure head tracking using a VIVE Tracker.

## Portalgraph Settings

Launch an application built with Portalgraph and open the settings screen (by default, press F12), and select the **Tracker/Custom** tab. Check the "Auto-launch Tracker App" option, then select "OpenVR" from the dropdown below it. The VIVE Tracker tracking software will launch automatically the next time the application starts.

<figure><img src="https://1057988615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR4jDeJrvuIogaygztZi7%2Fuploads%2FV23DMN0CiQe3c8ThdWUT%2Fimage.png?alt=media&amp;token=795042c0-e288-4db4-b50e-5356b71d2460" alt=""><figcaption></figcaption></figure>

#### Initial Setup

When you launch the VIVE Tracker tracking software for the first time, a message will appear prompting you to modify the settings, as shown below. Since VIVE Trackers are configured by default to be used together with a VR headset, the settings need to be changed to allow use without a headset. Click "Fix," then follow the on-screen instructions to quit SteamVR and relaunch the VIVE Tracker tracking software (registered in the Start menu as "Tracker Portalgraph").

<figure><img src="https://1057988615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR4jDeJrvuIogaygztZi7%2Fuploads%2FzRs4j5gsH3Tfxc1vEiAM%2Fimage%20(24).png?alt=media&amp;token=c6b9f024-d410-4178-8357-1db0dfb55771" alt=""><figcaption></figcaption></figure>

In the **Tracker Position** dropdown, select **Forehead** and click **Apply**. This sets up the tracker to be mounted on your forehead (choose the appropriate option based on your intended mounting position).

<figure><img src="https://1057988615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR4jDeJrvuIogaygztZi7%2Fuploads%2FmfUPLtnBl7MqLBSfrcsg%2Fimage.png?alt=media&amp;token=83e50b21-14db-4809-af7f-efc2ccc2469d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/R4jDeJrvuIogaygztZi7/blobs/69LTpDDES9mh9wCtCs9Q/image.png" alt=""><figcaption></figcaption></figure>

Click **Next**, then click **Tracker**.

<figure><img src="https://1057988615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR4jDeJrvuIogaygztZi7%2Fuploads%2Fwgec6HhNvI5M6WbYzqXe%2FScreenshot%202024-11-09%20160124.png?alt=media&amp;token=a517fff8-a5dd-496e-94c9-bedc5ee970ef" alt=""><figcaption></figcaption></figure>

In the **Tracker Settings** screen, enter the screen size in meters. Click **Calibrate**, then align the tracker to the center of the screen and wait for the countdown to complete. The calibration will be performed automatically.

<figure><img src="https://1057988615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR4jDeJrvuIogaygztZi7%2Fuploads%2FYaEHCNEE1777KtgHifJ5%2Fimage.png?alt=media&amp;token=872ea2a4-0e68-475f-a78d-0e44a27c375c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1057988615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR4jDeJrvuIogaygztZi7%2Fuploads%2FipWom15bMagWGId2HN89%2FIMG_2551%20(1).png?alt=media&amp;token=20f38103-e360-45d6-bda1-5f2963bddc78" alt=""><figcaption></figcaption></figure>