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:

   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:

   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:

   Double-click VRSX.App
   

   Or using Terminal:

   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:

   killall VRSX
   

8. Open VRSX in your browser:

   http://127.0.0.1:8085
   

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

   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:

   System Settings
   

2. Go to:

   General -> Login Items
   

3. Add:

   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.