Aseprite Compiler for macOS

An automated, one-step script to compile and install Aseprite directly on macOS (Apple Silicon M1/M2/M3/M4 & Intel).

Inspired by David-129/Aseprite-Compiler (for Windows) and fully automated from the official Aseprite macOS Compilation Guide.

---

⚠️ Important Warning & Disclaimer

Warning

Please read carefully before proceeding:

• Personal Use Only: Aseprite's EULA allows you to compile the source code for personal use. You cannot distribute, redistribute, or sell pre-compiled binaries or installer packages.
• Support the Developers: If you enjoy Aseprite and have the means, we strongly recommend purchasing Aseprite officially (via the official site or Steam). Purchasing gives you:
  • Instant updates and automatic patches without manual recompilation.
  • Direct developer support.
  • Financial support for the creators to keep improving this awesome software.
• No Warranty / Limitation of Liability: This script is provided "as-is" for educational purposes without warranty of any kind. Use at your own risk. The author is not affiliated with Igara Studio S.A. and is not responsible for any issues, data loss, or system problems that may arise from using this script or compiling the software.

---

Purpose & Intent

Compiling Aseprite manually on macOS requires installing several build dependencies (Xcode Command Line Tools, CMake, Ninja), cloning submodules, discovering the exact matching Skia tag, downloading and unzipping pre-built Skia binaries, setting compiler architecture flags, building targets, and assembling an .app bundle.

This project exists to simplify and automate this entire workflow into a single command on macOS, while:

1. Verifying your environment and automatically fetching missing dependencies via Homebrew.
2. Building an optimized native application.
3. Automatically installing Aseprite.app directly into /Applications so it appears in Launchpad and Spotlight.

---

Compatibility

Architecture	Supported	Notes
Apple Silicon (M1 / M2 / M3 / M4 / Pro / Max / Ultra)	✅ Yes	Fully supported and optimized with ARM NEON acceleration.
Intel x86_64 Mac	⚠️ Conditional	Script detects x86_64 and attempts to fetch x64 Skia + build x64 binaries, but primarily tested on macOS 11.0+ on Apple Silicon. Older Intel macOS versions may run into Xcode / C++20 toolchain compatibility issues.

• Recommended OS: macOS 11.0 (Big Sur) or newer.

---

Prerequisites

Before running the script, make sure you have:

1. Xcode Command Line Tools installed:

   xcode-select --install

2. Homebrew installed (if not present, the script will notify you with the install command):

   /bin/bash -c "$(curl -fsSL https://github.com/ghraw/Homebrew/install/HEAD/install.sh)"

3. Disk Space: At least ~5 GB of free disk space for Skia, source code, and intermediate compilation artifacts.

---

How to Run (3 Simple Steps)

Clone both repositories into the same folder, grant permissions, and run:

# 1. Clone this script repository
git clone https://github.com/robingamedev/aseprite-compiler-mac-script.git

# 2. Clone the official Aseprite repository (with submodules)
git clone --recursive https://github.com/aseprite/aseprite.git

# 3. Enter the script directory and run!
cd aseprite-compiler-mac-script
chmod +x check-and-compile-aseprite.sh
./check-and-compile-aseprite.sh

Note

Folder Layout: The script automatically detects the aseprite directory when both folders are placed side-by-side:

your-workspace/
├── aseprite-compiler-mac-script/
│   └── check-and-compile-aseprite.sh
└── aseprite/

---

Updating Aseprite

When a new version of Aseprite is released, you can easily pull the latest updates and recompile:

# 1. Pull the newest Aseprite changes
cd aseprite
git pull
git submodule update --init --recursive

# 2. Re-run the compiler script
cd ../aseprite-compiler-mac-script
./check-and-compile-aseprite.sh

---

What the Script Does Automatically

The automated script follows the official Aseprite macOS Installation instructions across 7 streamlined steps:

flowchart TD
    A[1. Check Xcode SDK] --> B[2. Check/Install Homebrew, CMake, Ninja]
    B --> C[3. Sync Git Submodules]
    C --> D[4. Download & Extract Matching Skia Binary]
    D --> E[5. Configure CMake for macOS & Architecture]
    E --> F[6. Multi-core Compile with Ninja]
    F --> G[7. Install to Applications & Clear Quarantine]

Loading

1. Checks Xcode SDK via xcrun --sdk macosx --show-sdk-path.
2. Verifies Homebrew & Build Tools, auto-installing cmake and ninja if missing.
3. Synchronizes Git submodules (git submodule update --init --recursive).
4. Inspects laf/misc/skia-tag.txt to automatically fetch and unpack the exact matching precompiled Skia library release for your machine's CPU architecture (arm64 vs x64).
5. Configures CMake targeting aseprite.app with proper macOS SDK and architecture flags.
6. Compiles Aseprite using Ninja with all available CPU cores (-j count).
7. Installs the resulting Aseprite.app to /Applications (or ~/Applications if running without root permissions) and clears Gatekeeper quarantine flags.

---

Launching Aseprite

Once the script completes, you can launch Aseprite via:

• Launchpad or Spotlight (Press Cmd + Space and type Aseprite)
• Finder under /Applications/Aseprite.app
• Terminal:

  open -a Aseprite

---

Troubleshooting

macOS says "Aseprite.app cannot be opened because Apple cannot check it for malicious software"

The script attempts to clear quarantine attributes automatically. If macOS Gatekeeper still blocks it, run:

xattr -cr /Applications/Aseprite.app

(Or right-click Aseprite.app in Finder, choose Open, and click Open again in the dialog).

Permission denied writing to /Applications

If your user account does not have write permissions to /Applications, the script automatically installs to your user applications folder at ~/Applications/Aseprite.app.

Compilation / CMake errors during re-compilation (Clean Build)

If upstream Aseprite dependencies or Skia tags have changed, run a clean build to wipe previous CMake caches:

./check-and-compile-aseprite.sh --clean

---

License & Credits

• Aseprite Source Code: aseprite/aseprite - Copyright (C) 2001-2024 Igara Studio S.A.
• Original Windows Compiler Concept: David-129/Aseprite-Compiler
• This compilation helper script is released under a Custom License (MIT-style with Restrictions). See the LICENSE file for full terms.