Outer Wilds Head Tracking

An unofficial head tracking mod for Outer Wilds that lets you look around naturally using your phone or dedicated head tracker.

Features

• Decoupled look + aim: Look around freely with your head while your aim stays independent
• 3DOF head tracking: Yaw, pitch, and roll via OpenTrack UDP protocol
• Adaptive smoothing: Automatically adjusts smoothing for WiFi/remote connections to reduce jitter
• Smart auto-disable: Tracking automatically pauses during model ship piloting, signalscope zoom, and pause menu
• Full game integration: Flashlight follows your gaze, Nomai Translator targets where you look, quantum objects respect head-tracked view direction

Requirements

• Outer Wilds (Steam or Epic)
• Outer Wilds Mod Manager
• A head tracking source (see below)

Quick Start

1. Install pixi
2. Clone this repository
3. Run pixi run deploy
4. Configure OpenTrack to output UDP data to 127.0.0.1:4242
5. Launch the game

Manual Installation

See INSTALL.md for detailed manual installation instructions.

Head Tracking Setup

This mod receives tracking data via the OpenTrack UDP protocol (port 4242 by default). You can use a phone or webcam with OpenTrack or any OpenTrack-compatible head tracking software.

The mod automatically detects remote connections (e.g., phone over WiFi) and applies smoothing to compensate for network jitter.

Controls

Key	Action
Home	Recenter tracking (set current head position as neutral)
End	Toggle head tracking on/off

Configuration

Settings are available in the OWML Mod Manager or in-game mod menu. The mod creates a config file with default settings on first run. Edit it to customize:

Setting	Default	Description
opentrackPort	4242	UDP port for receiving tracking data
yawSensitivity	1.0	Horizontal look sensitivity
pitchSensitivity	1.0	Vertical look sensitivity
rollSensitivity	1.0	Head tilt sensitivity
smoothing	0.0	Manual smoothing (0 = none, 1 = max)
adaptiveSmoothing	true	Auto-apply smoothing for remote/WiFi connections

Building from Source

This project uses pixi for build management.

# Install dependencies
pixi run restore

# Build the mod
pixi run build

# Deploy to OWML Mods folder
pixi run deploy

# Create release package
pixi run package

The mod depends on the shared CameraUnlock.Core library (included as a git submodule in the shared/ directory).

Project Structure

outer-wilds/
├── manifest.json              # OWML mod manifest
├── default-config.json        # Default settings
├── pixi.toml                  # Build configuration
├── scripts/
│   ├── deploy.ps1             # Deploy to OWML
│   ├── package.ps1            # Create release zip
│   └── uninstall.ps1          # Remove from OWML
└── src/OuterWildsHeadTracking/
    ├── HeadTrackingMod.cs     # Main mod entry point
    ├── Camera/
    │   ├── Core/              # Camera rotation patches
    │   ├── Effects/           # Flashlight, fog, quantum
    │   ├── UI/                # Reticle, markers, translator
    │   └── Utilities/         # Rotation helpers
    ├── Configuration/         # Constants
    └── Tracking/              # OpenTrack client

Technical Details

• Built for .NET Framework 4.8
• Uses Harmony 2.4 for runtime patching
• Integrates with OWML 2.9+
• Shared core library provides: UDP receiver, rotation processing, smoothing algorithms

License

MIT License - see LICENSE file for details.

Credits

• Mobius Digital - Outer Wilds
• OWML - Mod loading framework
• Harmony - Runtime patching library