Skip to main content

macOS Installation Guide

System Requirements

ItemRequirement
Operating systemmacOS 11 Big Sur or later
ChipApple Silicon (M1 or later) or Intel
Disk space5 GB

Installation Steps

Step 1: Download

Go to the download page and, on the macOS tab, pick the installer that matches your chip: choose Apple Silicon (M1 or later) and download aividlab_*_aarch64.dmg; for Intel Macs, choose Intel and download aividlab_*_x64.dmg.

Step 2: Install

Double-click the downloaded .dmg, drag aividlab into the Applications folder, then eject the .dmg when done.

Step 3: First Launch (⚠️ Important)

Before launching aividlab for the first time, run one command in a terminal to allow it (only needs to be done once):

  1. Open the "Terminal" app: press Command + Space to open Spotlight Search, type "Terminal", and press Enter.

  2. Click the copy button below, paste the command into Terminal, and press Enter:

    xattr -d com.apple.quarantine "/Applications/aividlab.app"
  3. Once it finishes, go back to the Applications folder and double-click aividlab — it should now launch normally.

To learn what this command does and why it's needed, see the explanation in the FAQ.

Notes

  • Separate installers are provided for Apple Silicon and Intel — pick the right one when downloading. Installing the wrong architecture will prevent the app from launching (you'll see a "can't be opened" message).
  • How do I know which chip my Mac has? Click the Apple menu in the top-left corner → "About This Mac". If the "Chip" field shows an Apple M-series chip, you have Apple Silicon; if it shows Intel Core, download the Intel installer.

Uninstall

sudo rm -rf "/Applications/aividlab.app"
rm -rf ~/Library/Application\ Support/com.aividlab.app
rm -rf ~/Library/Caches/com.aividlab.app

FAQ

  • Why is this command needed? com.apple.quarantine is the quarantine flag macOS puts on files "downloaded from the internet" that are not signed. aividlab does not currently have an Apple Developer ID signing certificate, so Gatekeeper blocks it by default, and double-clicking shows one of these messages:

    "aividlab" is damaged and can't be opened. You should move it to the Trash.

    or:

    "aividlab" can't be opened because Apple cannot check it for malicious software.

    Running xattr -d simply removes the quarantine attribute — it does not modify any of aividlab's code. Once we obtain an Apple Developer ID signature in the future, this step will no longer be necessary.

  • Still can't launch the app after running the command? Check the bottom of "System Settings → Privacy & Security" for an "Open Anyway" prompt for aividlab.