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 newest Android release and install it. Android ships separately from the desktop builds, as Android vX.Y.Z releases that never take the Latest slot, so the APK is not on the release marked Latest. 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