Head Tracking
Outer Wilds Head Tracking Mod
Head Tracking for Outer Wilds
![]()
Look around the solar system by moving your head! Turn your real head to peek around the cabin of your ship or gaze up at the stars through your helmet visor. This mod brings immersive head tracking to Outer Wilds.
Works with your phone, webcam, Tobii eye tracker, or any other tracking device supported by OpenTrack.
What You'll Need
- OWML (Outer Wilds Mod Manager)
- OpenTrack - free head tracking software
- A way to track your head:
- Your phone (easiest - just download an app!)
- Webcam
- Tobii eye tracker
- TrackIR, PS3 Eye + IR LEDs, or anything else OpenTrack supports
Installation
Using the Outer Wilds Mod Manager (recommended):
- Open the Outer Wilds Mod Manager
- Search for "Head Tracking"
- Click Install
Manual Installation:
- Download the latest release ZIP from the releases page
- Extract it to your
OWML/Mods/folder - You should see "Head Tracking" in the mod list
Setting Up Head Tracking
You'll need to set up OpenTrack to capture your head movements.
Step 1: Install OpenTrack
- Download OpenTrack from https://github.com/opentrack/opentrack/releases
- Run the installer
- Launch OpenTrack - you should see a window with "Input" and "Output" dropdowns
Step 2: Choose How You Want to Track
Pick whichever method works for you:
๐ฑ Using Your Phone (Easiest!)
Your phone can track your face and send the data to your computer over WiFi. No extra hardware needed!
Get the app:
- iOS: SmoothTrack ($9.99 - works great)
- Android: OpenTrack Mobile (free) or SmoothTrack ($9.99)
Setup:
- Install one of the apps above (or another opentrack compatible app) on your phone
- Make sure your phone and computer are on the same WiFi network
- Find your computer's IP address:
- Windows: Open Command Prompt and type
ipconfig- look for "IPv4 Address" (usually starts with 192.168) - Or check your router settings
- Windows: Open Command Prompt and type
- In OpenTrack on your computer:
- Set Input to "UDP over network"
- Click โ๏ธ next to Input, set Port to
4242(SmoothTrack default) or match your app's output port
- On your phone app:
- Enter your computer's IP address (e.g.,
192.168.1.100) - Set output port to
4242 - Start tracking
- Enter your computer's IP address (e.g.,
- Windows Firewall: When prompted, allow OpenTrack through your firewall (or manually add an exception for UDP port 4242)
- Back in OpenTrack, you should see the preview moving when you move your head
๐ฅ Using a Webcam
- In OpenTrack:
- Set Input to "PointTracker 1.1"
- Click the โ๏ธ settings button
- Follow the calibration instructions (you'll need to print a simple pattern or use the built-in model detection)
- You should see yourself in a preview window - move your head and watch the tracking data update
๐๏ธ Using Tobii Eye Tracker
If you have a Tobii device (4C, 5, etc.):
- Install Tobii Game Hub from https://gaming.tobii.com/getstarted/
- Make sure your Tobii device is connected
- Important: Keep "Tobii Experience" running (it detects the hardware) but close "Tobii Game Hub" before playing
- Why? Game Hub interferes with the tracking data and makes the camera overly sensitive
- In OpenTrack:
- Set Input to "Tracker | Tobii"
- You should see tracking data when you move your head
Step 3: Connect OpenTrack to the Game
Now tell OpenTrack to send its tracking data to Outer Wilds:
- In OpenTrack, set Output to "UDP over network"
- Click the โ๏ธ settings button next to Output
- Set:
- IP Address:
127.0.0.1 - Port:
5252
- IP Address:
- Click OK
- Click the big green Start button at the bottom
- Move your head and verify tracking is working - the octopus head in the preview window should move and the rotation/position numbers should change
- Keep OpenTrack running
That's it for setup!
Playing the Game
- Launch Outer Wilds through OWML (not through Steam/Epic directly)
- Load your save or start a new game
- Move your head - your view should follow!
The first time you look around, press F8 to center your view. This tells the mod "this is my neutral head position."
Controls
- F8 - Recenter your view (use this whenever things feel off-center)
- F9 - Toggle head tracking on/off
Tips for the Best Experience
Finding the right sensitivity:
- If the camera moves too much when you turn your head, open OpenTrack's "Mapping" tab and reduce the output curves
- If it doesn't move enough, increase the output curves
- You want subtle movements - you shouldn't need to turn your head 90 degrees to look around!
- For per-axis control, you can also edit the mod's
config.jsonfile inOWML/Mods/udkyo.HeadTracking/to adjust yaw, pitch, and roll sensitivity individually
Reducing jitter/shakiness:
- In OpenTrack, click the Filter dropdown and select "Accela"
- In the filter settings, increase smoothing to 1.5-2.0
- Add a small deadzone to ignore tiny movements
When head tracking pauses automatically:
- The mod automatically reduces or disables head tracking in certain situations:
- When using the model ship (prevents camera lock-ups)
- When zoomed in with the signalscope (so you can aim precisely)
- It'll come back on its own when you're done
Troubleshooting
Nothing happens when I move my head
Check OpenTrack:
- Is it running with a green "tracking" indicator?
- Move your head - do the numbers change?
- Did you click the Start button?
- Is Output set to "UDP over network" with port
5252?
Check the game:
- Did you launch through OWML? (Check if the OWML console window is open)
- Press F9 in case you accidentally disabled tracking
- Press F8 to recenter
- Check the OWML console for any error messages
If you're using your phone:
- Are your phone and computer on the same WiFi?
- Did you enter the right IP address?
- Check Windows Firewall isn't blocking OpenTrack
- Make sure you set Input to "UDP over network" (not Output - that's different!)
The camera is shaky or jittery
This is usually fixed with filtering:
- In OpenTrack, set Filter to "Accela"
- Click the filter settings button
- Increase smoothing to 1.5-2.0
- Add a small deadzone (maybe 0.5 degrees)
The camera is too sensitive or not sensitive enough
- In OpenTrack, click the Mapping button
- You'll see curves for Yaw, Pitch, and Roll
- Drag the curves to change sensitivity:
- Pull them down to make movements smaller
- Push them up to make movements bigger
- Click OK and test
You can also adjust sensitivity in the mod's config file if you want different sensitivity for each axis.
Tobii users: The camera spins wildly
If turning your head slightly makes you look all the way behind you:
- Close "Tobii Game Hub" (but keep "Tobii Experience" running)
- Restart OpenTrack
- The problem is that Game Hub sends its own tracking data that interferes with OpenTrack
You only need Tobii Experience for hardware detection - Game Hub does something weird resulting in graphical artifacts
The mod doesn't show up in OWML
- Make sure you installed it through the OWML mod manager, or
- If manual install, check the folder is in
OWML/Mods/withmanifest.jsoninside - Restart OWML
- Check the OWML console for errors
Building from Source
Only needed if you want to modify the mod yourself.
Requirements:
- .NET SDK 4.8 or higher
- Outer Wilds with OWML installed
- Pixi (optional but recommended)
Build & Deploy:
pixi run deploy
This will copy the OWML DLLs, build the mod, and deploy it to your OWML mods folder.
For manual builds without Pixi, see the build scripts in build/scripts/.
Credits
Made for the Outer Wilds community with โ๏ธ
Head Tracking
Outer Wilds Head Tracking Mod
