Installation

Hawkeye ships as a Homebrew formula on macOS, a .deb package on Debian/Ubuntu, and a portable ZIP on Windows. If you want the latest development build, see Building from source.

macOS (Homebrew)

brew tap PX4/px4
brew install PX4/px4/hawkeye

After install, the hawkeye binary is on your PATH. Launch it from any terminal:

hawkeye

Linux (Debian/Ubuntu)

Download the latest .deb from the Hawkeye releases page and install it:

sudo dpkg -i hawkeye-*.deb

ARM64 builds (Raspberry Pi, Jetson, cloud ARM instances) are published in the same release.

Windows

Download hawkeye-<version>-windows-x64.zip from the Hawkeye releases page, extract it anywhere (e.g. C:\Tools\hawkeye), and double-click hawkeye.exe.

The ZIP is self-contained — no Visual Studio or runtime installer required. User data (screenshots, markers) is written to %APPDATA%\hawkeye.

First-launch warning

Windows SmartScreen may warn that hawkeye.exe is from an unknown publisher. Click "More info" → "Run anyway". The binary is unsigned; signing and winget distribution are on the roadmap.

To launch from any terminal, add the extracted folder to your PATH.

Verifying the install

Launch Hawkeye with no arguments:

hawkeye

A window opens with the default quadrotor model on a grid backdrop, waiting for MAVLink telemetry on UDP port 19410.

If the window doesn't appear, see Troubleshooting.

Next steps

• First SITL run — Hawkeye + PX4 SIH
• First replay — Load a .ulg file
• First swarm — Replay multiple logs together
• Command-Line Reference — Every CLI flag with examples