This project provides an easy, automated way to get your own copy of Aseprite by building it directly from the official source code for Windows, Linux, and macOS.
Aseprite is "source-available" software. This means while the pre-made versions are paid, the creators allow you to compile the code yourself for personal use. This repository does all the hard work for youβautomatically setting up the environment and creating ready-to-use builds for all platforms.
- Multi-Platform Support: Build for Windows, Linux (multiple distros), and macOS (Intel & Apple Silicon)
- Free & Legal: Automatically builds your own personal copy from the official code
- Cloud Builds (GitHub Actions): Everything can happen on GitHub's servers without installing anything
- Local Builds: Scripts for building on your own machine (Windows batch, Linux/macOS bash)
- Multiple Output Formats:
- Windows: Portable ZIP
- Linux: Portable TAR.GZ + .deb package
- macOS: ZIP (Apple Silicon & Intel)
- Automated Dependency Resolution: Installs required tools and libraries automatically
- Dynamic Resource Optimization: Uses available CPU cores for faster builds
- Fork this repository to your account
- Go to the Actions tab in your new repository
- Click "Build Aseprite (All Platforms)" on the left
- Click the Run workflow button (optionally specify a version)
- Wait 60-90 minutes. All platforms build in parallel. When complete, go to the Releases section to download:
- Windows:
Aseprite-*-Windows.zip - Linux:
Aseprite-*-Linux.tar.gz(portable) orAseprite-*-Linux.deb(package) - macOS (Apple Silicon):
Aseprite-*-macOS-arm64.zip - macOS (Intel):
Aseprite-*-macOS-x64.zip
- Windows:
- Fork the repository
- Go to Actions β select your platform:
- "Build Aseprite" β Windows only
- "Build Aseprite (Linux)" β Linux only
- Click Run workflow
- Download from Releases when complete
- Ensure you have Visual Studio 2022, CMake, and Ninja installed
- Download or clone this repository
- Open Command Prompt and run:
aseprite_build.bat - The script runs as Administrator and handles everything
- Find the build in
workspace/installer/
- Clone this repository:
git clone <repo-url> - Make the script executable:
chmod +x aseprite_build.sh - Run it:
./aseprite_build.sh - Script auto-installs dependencies for your distro (Debian/Ubuntu, Fedora, Arch, etc.)
- Find outputs in
workspace/output/
- Ensure Xcode Command Line Tools are installed:
xcode-select --install - Clone this repository:
git clone <repo-url> - Make the script executable:
chmod +x aseprite_build.sh - Run it:
./aseprite_build.sh - Script auto-installs Ninja via Homebrew if needed
- Find outputs in
workspace/output/
- Visual Studio 2022 (Build Tools or Full)
- CMake 3.15+
- Ninja 1.11+
- Git 2.20+
- Chocolatey (optional - script can install it)
- GCC or Clang
- CMake 3.15+
- Ninja 1.11+
- Git 2.20+
- Development libraries (auto-installed by script)
Supported Distros:
- Debian/Ubuntu (apt)
- Fedora/RHEL (yum)
- Arch Linux (pacman)
- Others with standard tools
Auto-Installed Libraries:
- libx11-dev, libxcursor-dev, libxi-dev, libxrandr-dev
- libgl1-mesa-dev, libfontconfig1-dev, libfreetype6-dev
- libharfbuzz-dev, libpixman-1-dev, zlib1g-dev
- Xcode Command Line Tools (or full Xcode)
- CMake 3.15+
- Ninja 1.11+ (auto-installed via Homebrew)
- Git 2.20+
- Homebrew (optional, script uses it for Ninja)
Non-interactive batch script that:
- Automatically installs CMake, Ninja via Chocolatey
- Detects Visual Studio 2022/2019 installation
- Downloads latest Aseprite source (or specified version)
- Downloads Skia library for Windows
- Compiles with parallel jobs (auto-detects CPU cores)
- Creates portable ZIP
- Works in both local and GitHub Actions environments
Usage:
aseprite_build.batBash script that:
- Auto-detects OS (Linux/macOS) and architecture
- Installs Ninja if missing
- Auto-installs platform-specific dependencies
- Downloads and compiles Aseprite
- Creates portable archives (TAR.GZ for Linux, ZIP for macOS)
- Generates .deb package on Linux (if dpkg-deb available)
- Creates DMG on macOS (if hdiutil available)
- Detects Apple Silicon vs Intel Macs
- Uses optimal Skia binaries for architecture
Usage:
chmod +x aseprite_build.sh
./aseprite_build.shFeatures:
- Colored output for clarity
- Detailed progress logging
- Automatic CPU core detection for parallel builds
- Error handling at each step
- Fallback to stable version if API fails
- Runs on:
windows-latest - Output: Portable ZIP file
- Trigger: Manual via workflow dispatch
- Time: ~30-40 minutes
- Runs on:
ubuntu-latest - Output: TAR.GZ (portable) + .deb package
- Trigger: Manual with version input
- Time: ~40-50 minutes
- Includes: Desktop entry for application menu
Parallel matrix build with:
- build-windows: Portable ZIP (~30-40 min)
- build-linux: TAR.GZ + .deb (~40-50 min)
- build-macos-arm64: Apple Silicon ZIP (~40-50 min)
- build-macos-x64: Intel Mac ZIP on macOS-13 (~40-50 min)
- create-release: Creates GitHub Release with all artifacts
- Total Time: ~50-90 minutes for all platforms
- Cost: Uses GitHub-hosted runners (free tier)
Aseprite-vX.X.X-Windows.zip
βββ aseprite.exe
βββ data/
βββ aseprite.ini
Extract anywhere and run aseprite.exe
Aseprite-vX.X.X-Linux.tar.gz
βββ aseprite (binary)
βββ data/
βββ aseprite.ini
Aseprite-vX.X.X-Linux.deb
- TAR.GZ: Extract anywhere and run
./aseprite - DEB: Install via
sudo dpkg -i Aseprite-*-Linux.debthen runaseprite
Aseprite-vX.X.X-macOS-arm64.zip (for M1/M2/M3)
Aseprite-vX.X.X-macOS-x64.zip (for Intel)
βββ Aseprite.app (full macOS app)
βββ aseprite.ini
Extract and double-click Aseprite.app or add to Applications
β Full Linux Support
- Auto-detects distro and installs dependencies
- Supports Debian, Fedora, Arch, and others
- Creates both portable TAR.GZ and .deb packages
- Adds desktop entry for application menus
β Full macOS Support
- Supports Intel (x64) and Apple Silicon (arm64)
- Auto-detects architecture
- Creates native .app bundles
- Optional DMG creation
β Multi-Platform CI/CD
- Single workflow for all platforms
- Parallel builds (all 4 jobs run simultaneously)
- Automatic GitHub Release creation with all artifacts
- Supports version input for specific releases
β Better Local Building
- Unified bash script for Linux/macOS
- Color-coded console output
- Detailed progress reporting
- Automatic CPU core detection
- Graceful fallback handling
β Dependency Automation
- Windows: Auto-installs via Chocolatey
- Linux: Detects package manager and installs
- macOS: Uses Homebrew for Ninja
- All scripts verify tool availability
β Removed interactive prompts for CI compatibility β Replaced 7z with PowerShell Expand-Archive (no dependencies) β Proper error handling at each step β Dynamic parallel compilation (CPU-aware) β Stable Skia release URLs (no 404 errors) β OpenSSL DLL conditional handling
-
"Visual Studio not found"
- Solution: Install Visual Studio 2022 Build Tools or full version
-
"CMake not found"
- Solution: Ensure Chocolatey is installed; script tries to auto-install
-
"Build failed"
- Try running as Administrator: Right-click β "Run as Administrator"
-
"Permission denied" on script
- Solution:
chmod +x aseprite_build.sh
- Solution:
-
Missing dependencies
- Script auto-installs most; if one fails, install manually via your package manager
-
"apt-get not found"
- You're on a non-Debian distro; script will try yum/pacman
-
Build fails on Wayland
- Some X11 libraries may have issues; try Xvfb if headless
-
"Ninja not found"
- Solution: Install Homebrew first, or run
brew install ninjamanually
- Solution: Install Homebrew first, or run
-
"Skia not found" after download
- Check internet connection; try downloading manually
-
Apple Silicon build on Intel Mac
- Won't work; use the Intel build instead
- Or cross-compile with:
-DCMAKE_OSX_ARCHITECTURES=arm64
-
GitHub Actions timeout (6 hours)
- Very large optimized builds may timeout
- Solution: Reduce optimization flags or use local build
-
Out of disk space
- Builds use 10-15 GB; ensure free space in
workspace/
- Builds use 10-15 GB; ensure free space in
-
Network/Download failures
- Manually download Aseprite source and Skia to
workspace/ - Script will detect and use existing files
- Manually download Aseprite source and Skia to
- Personal Use Only: You can build this for yourself, but cannot sell or publicly share the executable files
- Support the Creators: If you enjoy Aseprite, please buy it officially to support development
- EULA Compliance: Review Aseprite's EULA - these builds are for personal/private use only
- Aseprite Official Repository
- Aseprite Official Website
- Skia Graphics Library
- Reference Implementation
- LAF (Libre Application Framework)
- GitHub Actions: Use the "All Platforms" workflow for convenience
- Large Builds: If on slow internet, use local build with cached Skia
- Version Control: Specify exact versions for reproducible builds
- Disk Space: Clean
workspace/after successful builds to save space - Updates: Bookmark the Releases page to check for new builds