Install on macOS

The xRay macOS app is the desktop UI client for inspecting Flutter apps that run the xray_inspector server. It is distributed as a signed and notarized .dmg on GitHub Releases, and as a Homebrew Cask.

Requirements

• macOS 10.15 (Catalina) or later
• Apple Silicon (Intel not tested)
• A running Flutter app with xray_inspector configured (see Quick Start)

Option 1 — Homebrew (recommended)

Install with Homebrew Cask:

brew install --cask impaktfull/tap/xray

If you haven't added the tap before, Homebrew will add it automatically. You can also add it explicitly:

brew tap impaktfull/tap
brew install --cask xray

Upgrade to the latest release:

brew update
brew upgrade --cask xray

Uninstall:

brew uninstall --cask xray

Option 2 — Direct DMG download

1. Open the xRay GitHub Releases page.
2. Download the latest xRay-<version>.dmg asset.
3. Open the DMG and drag xRay.app into your Applications folder.
4. Eject the DMG and launch xRay from Applications or Spotlight.

The DMG is signed with a Developer ID certificate and notarized by Apple, so Gatekeeper will open it without additional prompts.

Verify the installation

Launch xRay and confirm the app starts. When your Flutter app with xray_inspector is running on the same network, it will appear in the device list automatically via UDP discovery.

Next steps

• Quick Start — set up xray_inspector in your Flutter app
• Network Inspection
• Log Inspection
• Key-Value Inspection