Create a one-click installer for your macOS application. Save your users from cognitive load when choosing the right file for their processor type (x86_64 or arm64), ensuring installation simplicity.
- Support for 2 source options for downloading application files: GitHub Releases and Direct URLs
- Localization in 14 languages: English, Bulgarian, Chinese (Simplified), French, German, Hindi, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Turkish, Vietnamese
- The installer skips downloading application files if the app is already installed on the user's device
- Confirmation prompt when exiting the installer during download or installation
Clone the project repository:
git clone https://github.com/doroved/mac-installer.git
cd mac-installer
Navigate to the project settings (Xcode) and make the following changes:
- General → Display Name — replace AppName with your application name
- Signing & Capabilities → Bundle Identifier — replace com.appname.installer with a unique identifier for your installer
In the AppConfig.swift file:
- Specify your application name in appName as it appears in /Applications
- Choose the application file download method (downloadType):
- github — for downloading from GitHub Releases
- direct — for direct download via URL
- Specify URLs for latestReleaseURL, arm64URL, x86_64URL depending on the chosen download method
In Assets.xcassets, replace the icon with your application's icon.
- Navigate to Product → Archive to create a project archive
- After creating the archive, click the Distribute App button, select Direct Distribution, and click Distribute
- Wait for the process to complete and click Export to save the installer as a .app file
.png)


