Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Quick Start Guide (WIP)
This guide is intended for use to get up and running fairly quickly. It is not designed for explaining the intricacies of all the options/settings that are available.
Quick Start Video:
Video of the calibration process:
Below is the opening screen for OpenTrack. The version number is displayed in the top. The area marked "no video" displays the camera output once the program is running. The octopus will rotate as you move your head. Below them are the raw tracker and game data displays.
1 - clicking here will take you to the Tracker selection.
2 - clicking here will take you to the Protocol selection.
3 - clicking here will take you to the Filter selection.
4 - clicking here will take you to the Options window.
5 - clicking here will take you to the Mapping window.
Here are the options for the tracker selection: In the Tracker selection you define the type of tracking method to be received by opentrack. For example if you have a tracking clip with IR-leds you need 'Pointtracker 1.1', but if you want to use your phone as a tracking device you need to select the 'FreePIE UDP receiver'.
Here are the options for the protocol selection: The protocol section is for defining how to communicate the movement data from opentrack to the game. Many games will work using the 'freetrack 2.0 Enhanced' protocol, but some games do have their own protocol, for example the Flight Simulator games. In games that don't support any form of headtracking natively you can also map the headtracking to the mouse coordinates, so that you can move the mouse with your head.
Here are the options for the filter selection: Here are the options for the options window:
Here is the Mapping window where you can set curves for the six DOF. The numbers on the left represent the degrees of movement in the game, and the numbers along the bottom represent real world movement. In this window you can see that I have a dead space of approx 8 deg and at 15 degrees movement in game will be 180 deg for the yaw setting. In other words as I turn my head left and right and my view reaches the edges of my monitor I get max movement in game. If you tick the Asymmetric box you can set curves independently for right/left movement.
I use a 3 point IR led clip and a PS3 eye camera, a very good set-up to use with Opentrack. To get up and running quickly choose the Tracker, Protocol, and Filter you want to use. Clicking on the three dots next to the drop down takes you to additional settings for the chosen item. The option window has four tabs, Shorcuts, Camera, Output, and Game Detection.
If you are using Point Tracker you will need to click the 3 dot tab and enter your camera data in the pop-up that appears.
Once you are ready click Start and off you go. On the main wiki page are some links that lead to pages with additional information on various parts of OpenTrack.