Opentrack Setup (Linux)

opentrack is a free, open-source head-tracking program that manages and transmits pose information to games and simulators.

Where to Find Protocol Settings

All protocol settings described below can be found at the top of the General tab in Tracking settings. Click the Settings button in the output pose visualization to open the Tracking settings window.

When do you need opentrack?

Most users don't need opentrack. LookPilot works directly with games through FreeTrack (TrackIR emulation) and Virtual Joystick protocols. However, opentrack is useful for specific edge cases:

Mouse emulation – for games that only support mouse input for camera control
Additional output protocols – such as SimConnect, OpenXR, or raw UDP not directly supported by LookPilot
Alternative filtering – opentrack offers different filtering algorithms (Accela, Kalman, EWMA) that some users prefer

Installation

For Linux users, we recommend using the Star Citizen-optimized fork which includes important compatibility fixes for Wine/Proton games:

opentrack-StarCitizen - Fork with improved compatibility for UMU-enabled launchers (like Lutris) and custom Proton prefixes.

Build from source

git clone https://github.com/Priton-CE/opentrack-StarCitizen.git
cd opentrack-StarCitizen
git checkout wine-extended-proton
mkdir build
cd build
cmake ..
ccmake ..  # Enable SDK_WINE in the interface
make
sudo make install

Note: When running ccmake .., use the interface to enable the SDK_WINE option before proceeding with make.

How to set it up with LookPilot

Launch opentrack
In LookPilot, go to Tracking settings (click the Settings button in the output pose visualization)
At the top of the General tab, set Protocol to opentrack
In opentrack, set Tracker to UDP over network
Click Start tracking in LookPilot
Click Start in opentrack
The octopus model in opentrack should move as you move your head

How to use opentrack (quick version)

In opentrack, choose an Output your game supports (e.g. Freetrack, Virtual Joystick, SimConnect, or mouse emulation)
Click Start to begin tracking
Pick a filter under Filter if you want smoothing beyond the default

For a detailed walkthrough with screenshots, see the official Quick-Start Guide. Many video tutorials are also available on YouTube.

Recommendations for LookPilot + opentrack

Adjust mapping curves in only one app (either opentrack or LookPilot) and leave the other set to Identity
To use LookPilot's filtering (smoothing or deadzone), set Filter to None in opentrack
To rely on opentrack's filters instead, set Deadzone and Smoothness to 0 in LookPilot (under General tab in Tracking settings)