ASEPRITE EXTENSION

Pixel art for Aseprite

A Lua-based extension that brings AI pixel art generation directly into Aseprite. Prompt, generate, and import sprites without leaving your pixel art canvas.

See it in action

SpriteSynth Aseprite Generate tab screenshot

generate tab

SpriteSynth Aseprite Manage tab screenshot

manage tab

SpriteSynth Aseprite Settings tab screenshot

settings tab

What's included

Generate Dialog

Full-featured dialog with prompt, image size, negative prompt, and seed fields. API key resolves from preferences then environment variable.

Canvas Import

Generated sprites are downloaded via curl and loaded directly onto your canvas as a new Sprite via Sprite{fromFile=}.

History Browser

Paginated history (10 per page) stored in Aseprite preferences. Re-open on canvas, delete individual entries, or clear all. Cap of 100 entries.

Settings Dialog

Dedicated settings dialog for API key management with status indicator (saved key / environment variable / none). Test your key before generating.

Cross-Platform

Works on Windows, macOS, and Linux. Handles temp paths, shell quoting, and platform-specific curl commands correctly.

39 Passing Tests

Comprehensive Lua test suite covering key resolution, JSON construction, history CRUD, URL building, and platform-specific behavior. CI runs on push via GitHub Actions.

Installation

Quick Install

  1. Download the latest release
  2. Copy the spritesynth-aseprite folder to your Aseprite extensions directory:

Windows: %APPDATA%\Aseprite\extensions\

macOS: ~/Library/Application Support/Aseprite/extensions/

Linux: ~/.config/aseprite/extensions/

  1. Restart Aseprite
  2. Open via File > Export > SpriteSynth Generate... or Scripts > SpriteSynth

Via GitHub

git clone https://github.com/magebase/spritesynth-aseprite.git
# Then copy the folder to your Aseprite extensions directory

API Endpoints

The extension interacts with the spritesynth API using these endpoints:

POST /generations/image Generate pixel art
GET /generations/{uuid} Poll generation status
GET /generations/{uuid}/download Download generated asset

Requirements

Aseprite

Aseprite v1.3+ (any OS)

API Key

Free or paid spritesynth account

curl

curl and internet connection

Start generating in Aseprite

Install the extension and create pixel art assets without leaving Aseprite.

Download .zip View on GitHub