Installation

Installation

Requirements

• Apple Silicon Mac (arm64) — this is not a universal app
• macOS 14 or newer

Download a release

1. Grab ShuttleX-<version>-arm64.zip from the Releases page.
2. Unzip it and move ShuttleX.app to /Applications.
3. Approve it on first launch (see Gatekeeper below).

Because the app is only ad-hoc signed (not notarized), Gatekeeper blocks the first launch when the file came from the internet/AirDrop. Two ways to approve it:

• Terminal: xattr -dr com.apple.quarantine /Applications/ShuttleX.app
• System Settings: launch once, dismiss the warning, then System Settings → Privacy & Security → "Open Anyway". (Since macOS 15, right-click → Open is no longer enough.)

A FAT/exFAT USB stick sets no quarantine attribute, so the app starts directly from one.

Build from source

git clone https://github.com/DasDuo/ShuttleX
cd ShuttleX
./build.sh
open build/ShuttleX.app

Requirements: Xcode (or the Command Line Tools) with Swift 5.9+. Locally built apps have no quarantine, so they start without the Gatekeeper step.

Run the test suite with swift test.

Launch at login

Settings → General → "Launch at login". For this to work reliably, run the app from /Applications.