Open-source project
opentrack/opentrack avatar
opentrack/opentrack

opentrack: a head-tracking pipeline whose usefulness depends on which tracker and output you can match

Head tracking software for MS Windows, Linux, and Apple OSX

5,290 stars571 forksC++License varies

At a glance

What is it?
opentrack reads head rotation from a long list of trackers, filters it, and relays it to flight simulators and games through a separate list of output protocols. Many of the pairings are Windows only, and the Mac port is described as unmaintained.
Who is it for?
Use opentrack if you play flight or driving simulators and want to drive the in-game view with a webcam, marker, phone or dedicated tracker, and your game accepts one of its output protocols. Do not expect a uniform experience across systems: many trackers and outputs are Windows only, and the OSX build is marked unmaintained.
Can I use it commercially?
Not without permission. GitHub finds no licence file in the repository, and without a licence all rights are reserved by default: you may read the code but not reuse it. Check the README, or ask the authors, before using it.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly C++, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • opentrack/opentrack5,290 ★ · +147
Star history
Repository2026-09-232026-11-15
opentrack/opentrack5.1k5.3k

147 Stars in the last 53 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

It shares a name with railway planning software, and the README says the other project came first

The README opens with a disambiguation. opentrack is a program for tracking the user's head rotation and sending it to flight simulation software and military-themed video games. A line below warns anyone looking for railway planning software that opentrack.ch had the name first, and apologises for the long-standing naming conflict.

That is worth knowing before you search. Results for the name include athletics timing, insurance and track-day pages that have nothing to do with head tracking, and the project does not own the term. The reliable way to land on the right place is the project home on GitHub and the releases page, where an .exe installer and a .7z archive are published for Windows with each release.

A portable mode is described for installing onto a USB stick, with its own wiki page.

Pick a tracker first: webcams, markers, phones and hardware are separate paths

The input list is long and mixed. Webcam based options include the NeuralNet Tracker, described as AI-based head pose estimation with webcams, PointTracker by Patrick Ruoff for FreeTrack-like light points, and a paper marker tracked through the Aruco library. Other inputs include the Oculus Rift, Razer Hydra, Arduino with custom Hatire firmware, Intel RealSense 3D camera, Wiimote, Eyeware Beam, a Tobii eye tracker, joystick analog axes, and XReal One glasses.

Phone and network routes exist too: relaying UDP from a different computer, FreePIE Android apps over UDP, and a Windows Phone tracker over opentrack's UDP protocol.

The platform notes matter. Oculus Rift, joystick analog axes, RealSense and Wiimote are marked Windows. So the tracker you own can decide the operating system you need, and a Linux user with a RealSense camera has no listed path for it. The wiki holds tracker specific documentation and a Quick Start Guide.

Outputs are per game, and the Linux route goes through Wine or a virtual joystick

The output side is a separate list. SimConnect serves newer Microsoft Flight Simulator on Windows. FSUIPC covers Microsoft Flight Simulator 2002 and 2004 on Windows. A freetrack implementation is Windows only, and FlightGear is also listed. A tablet-like mouse output exists for Windows, and SteamVR is reached through a bridge by r57zone that is a separate project.

For other platforms the options are narrower: virtual joystick output works on Windows, Linux and OSX; a Wine freetrack glue protocol is for Linux and OSX; and the X-Plane plugin is listed for Linux and uses the Wine output option. UDP relaying sends data to another computer.

The consequence is that you choose the output by the game, not by preference. If your simulator reads only a protocol that opentrack offers on Windows, running the game on Linux means going through Wine or a joystick. The repository's proto- directories mirror this list, including proto-simconnect, proto-fsuipc, proto-ft, proto-wine and proto-vjoystick.

The OSX code is still there, but the README marks it unmaintained

The usage section says the codebase runs on Microsoft Windows, Apple OSX and GNU/Linux, and adds in parentheses that OSX is currently unmaintained. A macosx/ directory and a proto-iokit-foohid directory remain in the tree, along with build configuration for AppleClang on Darwin.

That tells you what to expect. A Mac user can find the code and may be able to build it, but nobody is committed to fixing problems on that platform, and a bug may sit unanswered. The prebuilt downloads announced in the README are for Windows only: installers and portable versions are available for each release.

On Linux you would be building from source. The README has a section titled Building opentrack from source, which begins with Windows instructions naming mingw-w64 or Microsoft Visual Studio 2015 Update 3 or newer.

Filters are a module family of their own, with a new Alpha Spectrum guide

opentrack lets you shape the output, filter it and operate with many input and output devices and protocols. The filtering code is split into directories: filter-accela, filter-accela-hamilton, filter-alpha-spectrum, filter-ewma2, filter-hamilton and filter-nm. The Hamilton filter is credited to GO63-samara, and Donovan Baarda is thanked as a filtering and control theory expert.

The README points to a parameter guide for the newer Alpha Spectrum filter in filter-alpha-spectrum/README.md. For the other filters, the wiki is where per-filter documentation is kept.

The practical point is that head movement is noisy, and the choice of filter and its settings decides how a view feels in a game. There is no single recommended setting in the README, so expect to tune with the presets and the pose widget, both of which have directories in the repository, presets/ and pose-widget/.

Releases are infrequent, and almost all code is ISC licensed

The latest tagged releases are opentrack 2026.1.0 on 2025-12-31, opentrack 2024.1.1 on 2024-06-24 and opentrack 2023.3.0 on 2023-11-06. The last push to the repository was on 2026-10-30, so work continues between releases, and installing from a release means you do not get that work until the next tag.

GitHub shows the license as unknown. The README fills the gap: almost all code is under the ISC license, there are very few proprietary dependencies, and there is no copyleft code. Individual files carry their own licensing and authorship information, and 3rdparty-notices/ and OPENTRACK-LICENSING.txt sit at the top level.

The warranty text is plain. WARRANTY.txt disclaims all possible warranty, and the README states the authors are not responsible for damage or losses.

It grew out of FaceTrackNoIR, and new modules follow a plugin API

The credits start with Stanisław Halik as maintainer, then Wim Vriend, author of FaceTrackNoIR, which served as the initial codebase. The code was almost entirely rewritten but keeps many of FaceTrackNoIR's ideas. Other credited contributions include the Rift and Razer Hydra tracker, the Intel RealSense tracker, the Wiimote tracker, the Kinect Face Tracker, the Micro:Bit work, the Eyeware Beam tracker and the Tobii eye tracker.

For developers, the contributing section links a plugin API header, api/plugin-api.hpp, a tracker test header, and a wiki page on working with core code. Wiki edits are sent as pull requests to a separate opentrack/wiki repository, and the user-facing wiki updates itself after a merge.

The project asks users to file an issue or feature request if something goes wrong. OpenCV authors are thanked in the README, which reflects the camera based trackers.

Editorial conclusion

Use opentrack if you play flight or driving simulators and want to drive the in-game view with a webcam, marker, phone or dedicated tracker, and your game accepts one of its output protocols. Do not expect a uniform experience across systems: many trackers and outputs are Windows only, and the OSX build is marked unmaintained. Before you install, pick a tracker you own, pick the output your game reads, and check both against the platform list.

Frequently asked questions

What does OpenTrack do?

opentrack tracks the user's head rotation and relays it to flight simulation software and military-themed video games, with output shaping and filtering in between.

How do I use opentrack with a webcam?

The README lists the NeuralNet Tracker for AI-based head pose estimation with webcams, PointTracker for FreeTrack-like light points, and an Aruco paper marker tracker. Setup steps are in the wiki Quick Start Guide.

Is OpenTrack free to download?

The releases page offers an .exe installer and a .7z archive for Windows, and almost all of the code is under the ISC license. The README states no price.

Official sources

  1. Issues
  2. opentrack/opentrack on GitHub
  3. README
  4. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/opentrack-opentrack.svg)](https://hysenlabs.com/projects/opentrack-opentrack)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/opentrack-opentrack.svg)](https://hysenlabs.com/projects/opentrack-opentrack)

Was this useful?