Aseprite Export

Overview

Export your spritesynth pixel art in Aseprite-compatible formats. Use the JSON export for manual import or the Aseprite extension for direct integration.

Export Formats

JSON Export

Export animation data as Aseprite-compatible JSON.

Via Editor

1. Open your character or animation in the editor
2. Click Export → Aseprite
3. Download the JSON file

Via API

curl -X GET https://api.spritesynth.dev/api/exports/characters/{id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "aseprite_json",
    "scale": 1
  }'

Aseprite Extension

Install the spritesynth Aseprite extension for direct integration:

1. Download the extension from the spritesynth dashboard
2. In Aseprite, go to File → Sprite Size → Extensions
3. Install the downloaded .aseprite-extension file
4. Access spritesynth directly from Aseprite's menu

Importing JSON into Aseprite

Method 1: Script Import

Use Aseprite's built-in scripting to import the JSON:

1. Open Aseprite
2. Go to File → Run Script
3. Select the spritesynth import script (included in export)
4. Select the JSON file
5. The sprite sheet and animation data are imported automatically

Method 2: Manual Import

1. Export individual frames as PNG from spritesynth
2. In Aseprite, go to File → Open and select the first frame
3. Go to File → Import → Import Stack
4. Select all frame PNGs in order
5. Frames are added to the timeline

JSON Format

The exported JSON contains frame data and animation metadata:

{
  "frames": [
    {
      "filename": "idle_0",
      "frame": { "x": 0, "y": 0, "w": 32, "h": 32 },
      "duration": 100
    },
    {
      "filename": "idle_1",
      "frame": { "x": 32, "y": 0, "w": 32, "h": 32 },
      "duration": 100
    }
  ],
  "meta": {
    "size": { "w": 64, "h": 32 },
    "scale": "1"
  },
  "animations": {
    "idle": {
      "frames": ["idle_0", "idle_1"],
      "fps": 8
    }
  }
}

Exporting from Aseprite to spritesynth

The extension also supports exporting from Aseprite back to spritesynth:

1. Open your sprite in Aseprite
2. Go to spritesynth → Upload to spritesynth
3. Choose a project and name
4. Your sprite is uploaded with all layers and animation data preserved

Tips

• Export at 1x scale for pixel-perfect import into Aseprite
• Aseprite uses milliseconds for frame duration — spritesynth handles the conversion
• Layer data is preserved in the full project export
• Use the extension for the smoothest round-trip workflow