Aseprite Frame Extraction

Quick start

• Run python scripts/extract_aseprite_frames.py <file-or-folder-or-glob> [...].
• Outputs to assets/<sprite-name>/<tag>/<frame>.png by default.
• Use --split-shadow to export main sprites without shadow and shadow-only sprites separately.

Workflow

1. Point to .aseprite files or a folder.
2. Provide --aseprite if Aseprite is not on PATH.
3. Check results in the output folder.

Notes

• Uses Aseprite CLI --split-tags and {tag}/{frame}.png to classify frames.
• Tag names and frames are exported as-is; tag names become folder names.
• If a sprite has no tags, no frames are exported.
• When --split-shadow is enabled, the script:
  • exports main sprites using --ignore-layer <shadow-layer>
  • exports shadow sprites using --layer <shadow-layer>