# MacOS setup guide

## Sudo is not necessary anywhere!

### Compatibility information

**Only Apple Silicon is supported.**

This build is intended for Apple Silicon Macs only, for example M1, M2, M3, M4 and newer.

Intel Macs are not supported.

---

## Start VRSX on macOS

1. Download the `osx-arm64.zip` package from releases.

2. macOS may automatically unzip the file after download.

   If it does, move the extracted `osx-arm64` directory anywhere you want.

   If it does not, unzip it manually first.

3. Open the `osx-arm64` directory in Finder and make sure you can see:

   ```text
   VRSX.App
   ```

4. Open Terminal in the `osx-arm64` directory.

   The easiest way:

   * open the `osx-arm64` folder in Finder
   * right-click inside the folder
   * choose “New Terminal at Folder”

   If you do not see that option, open Terminal manually and use `cd` to enter the `osx-arm64` directory.

5. Remove the macOS quarantine flag from the app:

   ```bash
   xattr -dr com.apple.quarantine ./VRSX.App
   ```

   This does not disable Gatekeeper globally. It only tells macOS to stop treating this specific app as a suspicious creature freshly dragged in from the internet swamp.

6. Open VRSX.

   Using Finder:

   ```text
   Double-click VRSX.App
   ```

   Or using Terminal:

   ```bash
   open ./VRSX.App
   ```

7. Known issue: VRSX may not show an icon in the Dock or menu bar.

   I love Apple, including the edible ones, but not this particular behavior.

   For now, VRSX behaves mostly like a background daemon. To stop it, run:

   ```bash
   killall VRSX
   ```

8. Open VRSX in your browser:

   ```text
   http://127.0.0.1:8085
   ```

   You can also use the IP address of your Mac from another device on the same network:

   ```text
   http://IP.OF.YOUR.MAC:8085
   ```

9. Activate VRSX using the license key available under the “My Account” section in ADS-B.Pro RadarView.

10. Enjoy!

---

## Autostart on macOS

macOS uses `launchd`, which is Apple’s own background service creature. It is powerful, weirdly shaped and not documented here yet.

For now, the simplest way to start VRSX automatically is to add it to Login Items.

1. Open:

   ```text
   System Settings
   ```

2. Go to:

   ```text
   General -> Login Items
   ```

3. Add:

   ```text
   VRSX.App
   ```

This is not a full daemon service, but it should be enough for most desktop users.

**NOTE:** Proper `launchd` support may be added later. For now, Login Items is the recommended macOS autostart method.