# LookPilot App Guides

> Setup, configuration, and troubleshooting for the LookPilot
> application.

Canonical URL: https://lookpilot.app/app-guides
Markdown alternate of: https://lookpilot.app/app-guides

This page is the index of app-level documentation. For per-game setup
notes, see https://lookpilot.app/game-guides.

## Getting Started

- Install on Windows from
  https://github.com/Reblexis/lookpilot-downloads/releases (latest
  Setup .exe).
- Install on Linux from the same releases page (latest x86_64
  AppImage). Mark the AppImage executable and launch it.
- First-run setup: pick your webcam, sign in (or start the 14-day
  trial), grant camera permission if the OS asks for it.

## Connect to Any Game

Pick the output protocol per game:

- **TrackIR / FreeTrack DLL** - the most common path. Most flight,
  space, and truck sims detect tracking automatically once the
  TrackIR / FreeTrack adapter is enabled in LookPilot.
- **opentrack UDP** - LookPilot acts as an opentrack input source over
  UDP. Useful for advanced curve editing in opentrack itself.
- **Virtual joystick (vJoy on Windows, uinput on Linux)** - useful for
  games that have no native head-tracking support but accept analog
  joystick axes.
- **Mouse output** - drives mouse movement from head pose. Useful for
  FPS-style look targeting in games without TrackIR support.

Multiple adapters can be active at once.

## Tracking Settings

- Sensitivity per axis.
- Smoothing.
- Deadzone (anchored or progressive).
- Response curve (linear, ease, custom).
- Per-axis enable / disable, axis mapping, lock pitch / lock roll,
  invert axes.
- Eye gaze influence (how strongly to mix eye signal on top of head
  motion).

## Presets

- Save and load presets per game.
- Import community presets (shared as files).
- Bind hotkeys to switch between presets on the fly.

## App Settings

- Hotkeys: recenter, toggle tracking, switch preset.
- Startup behavior (run on login, start tracking on launch).
- Camera selection on systems with multiple webcams.
- Telemetry toggle (anonymous session metadata can be disabled here).

## Opentrack Setup

LookPilot can publish tracking over UDP in the format opentrack
expects, letting users build custom curves and filters in opentrack
while LookPilot handles capture and inference.

## Troubleshooting

- **Camera not detected** - check Windows Camera privacy settings, or
  on Linux verify `/dev/video*` permissions. Restart the app after
  granting permission.
- **Low FPS** - prefer a 720p stream from a webcam with good low-light
  performance; close other apps using the camera.
- **Jitter** - increase smoothing; verify the room has enough light.
- **Drift** - recenter (default hotkey shown in app settings); enable
  auto-center if available.
- **Game does not detect tracking** - confirm the right adapter is
  enabled in LookPilot for that game. Check the game's per-game guide
  at https://lookpilot.app/game-guides.
- **TrackIR.dll conflicts** - if both TrackIR drivers and LookPilot
  are installed, disable the TrackIR drivers or pick a single source.
- **Wayland on Linux** - some Wayland sessions restrict virtual input;
  prefer X11 if virtual joystick or mouse output behaves oddly.

## Virtual Camera

LookPilot can expose the processed feed as a virtual camera for
streaming or recording.

## More

- Per-game setup pages: https://lookpilot.app/game-guides
- Free trial / buy: https://lookpilot.app/purchase
- Discord: https://discord.gg/RbhTxhFnCF
- Full reference for AI agents: https://lookpilot.app/llms-full.txt