amyinorbit / headtrack

Lightweight X-Plane plugin that uses SmoothTrack input to enables head tracking.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

HeadTrack

HeadTrack is a lightweight plugin for X-Plane that lets you use apps like SmoothTrack to control the cockpit view position and orientation.

Main HeadTrack settings UI

HeadTrack is made with <3 in Scotland. HeadTrack will always be free! If you want to support my X-Plane work, you can buy me a coffee ☕.

Installation

Extract the downloaded zip file drop the htrack in x-plane/Resources/plugins.

Usage

You can enable and disable head tracking, as well as reset the center head and in-simulator positions in the Plugins > HeadTrack menu in X-Plane. Point your head tracking app to your PC's IP address and port 4242, and you should be good to go!

The settings window lets you tweak tracking sensitivity, smoothing and response. It also displays graphs of the current received head position, and of the corresponding cockpit position if tracking is active.

Settings saved globally are stored in x-plane/Resources/plugins/htrack/config.json. You can also save settings per-plane, and these will be loaded automatically when you load specific planes. These are stored as htrack.json in the plane's folder. This can be useful if you want snappier settings for fighter planes and something calmer for jet liners, for example.

Bugs & Suggestions

If you find any bugs or have suggestions on how to make HeadTrack better, you can file an issue here, email me at developer@amyparent.com, or fork this repository and hack away!

Building

If you want to build HeadTrack from source yourself, you will need:

  • a C/C++ compiler (tested with GCC and Clang, and MingW on Windows. It will probably not work with MSVC, but feel free to try it!)
  • OpenGL development libraries for your platform
  • a build of libacfutils

To build headtrack:

$ cd headtrack
$ mkdir build && cd build
$ cmake -DLIBACFUTILS=<path to your libacfutils directory> ..
$ make

🏳️‍⚧️

About

Lightweight X-Plane plugin that uses SmoothTrack input to enables head tracking.

License:MIT License


Languages

Language:C++ 53.1%Language:C 44.1%Language:Objective-C++ 1.5%Language:Makefile 0.4%Language:Objective-C 0.4%Language:CMake 0.3%Language:Batchfile 0.1%Language:Shell 0.1%Language:HTML 0.0%Language:GLSL 0.0%