Skip to main content

macOS Installation

This guide covers how to install DesireCore on macOS.

Estimated time

The entire installation typically takes just 1 minute — download the DMG, drag to Applications, done.

Installation Steps​

  1. Download the DMG file

    Go to the official website and click the download button. The website will automatically detect your Mac's chip type (Apple Silicon or Intel) and provide the corresponding .dmg installer.

    Manually select architecture

    If the auto-detection is inaccurate, click "More download options" to choose manually. Click > About This Mac in the top-left corner and check the "Chip" field: select the ARM64 version for "Apple M series", or the x64 version for "Intel".

  2. Open the DMG file

    Double-click the downloaded .dmg file to open the installer window.

  3. Drag to Applications folder

    Drag the DesireCore icon into the Applications folder.

  4. Launch DesireCore

    Open the Applications folder and double-click DesireCore to launch.

GUI Automation and HostAgent​

The macOS version currently uses HostAgent as the carrier for local GUI operations and related device capabilities. HostAgent is an active execution component and has not been replaced by the CUA Driver used on Windows.

The first time you use interface inspection, clicking, typing, screenshots, or similar capabilities, macOS may request Accessibility, Screen Recording, or other permissions. Grant only what the task requires. If a capability does not recover immediately after a permission change, restart HostAgent or DesireCore and try again. Windows temporarily uses the bundled CUA Driver as a transitional way to provide GUI capability before Windows HostAgent is complete.

Handling Gatekeeper Prompts​

On the first launch, macOS may display a prompt saying "DesireCore can't be opened because the developer cannot be verified." This is macOS's security mechanism (Gatekeeper) checking newly downloaded applications.

DesireCore is Apple Notarized

The DesireCore installer has been notarized by Apple and is safe. The system needs additional verification on the first launch.

To proceed:

Method 1 (recommended): Right-click to open

  1. Find DesireCore in the Applications folder
  2. Hold Control and click (or right-click) DesireCore
  3. Select "Open"
  4. Click "Open" again in the dialog that appears

Method 2: Via System Settings

  1. Open System Settings > Privacy & Security
  2. Scroll down to find the prompt about DesireCore being blocked
  3. Click "Open Anyway"

Uninstall​

To uninstall DesireCore:

  1. Open Finder > Applications
  2. Drag DesireCore to the Trash
  3. Empty the Trash

To also remove application data, delete the following directories:

~/Library/Application Support/DesireCore/
~/.desirecore/

Troubleshooting​

  • DMG won't open: Verify the download completed successfully, then try downloading again.
  • "is damaged and can't be opened" message: This is usually Gatekeeper blocking the app — follow the "Handling Gatekeeper Prompts" section above.
  • Slow performance on Apple Silicon: Confirm you downloaded the arm64 version, not x64 (Rosetta translation incurs a performance penalty).
  • Other issues: Visit the FAQ or contact our support team.

After installation, head to First Run to learn about the post-launch onboarding flow.