Installation

Hawkeye ships as a Homebrew formula on macOS, a .deb package on Debian/Ubuntu, and a portable ZIP on Windows. Android builds are published as a signed APK and through Google Play internal testing. 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.

Android

Download hawkeye-<version>-android.apk from the Hawkeye releases page and install it. The APK is signed and installs as downloaded; Android asks you to allow installs from your browser or file manager the first time.

The APK bundles both arm64-v8a and x86_64, so it runs on 64-bit ARM devices and in the Android emulator. It requires Android 10 (API 29) or newer and a GPU with OpenGL ES 3.0.

Google Play internal testing

Releases are also pushed to the Google Play internal test track. Ask a maintainer to add your Google account to the tester list if you prefer installs and automatic updates through Play. A Play install and a sideloaded APK are signed with different keys, so switching between them requires an uninstall.

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