Installation

Hawkeye ships as a Homebrew formula on macOS and a .deb package on Debian/Ubuntu. For Windows, or 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

No prebuilt Windows package yet. Follow Building from source for the full procedure (Visual Studio 2022 + CMake + Git).

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