Export a sprite sheet from Aseprite's command line

Put the export in a script so every save of the .aseprite file can rebuild the sheet.

SNP 133 #246 Filed aseprite pixelart gamedev

shell
aseprite -b player.aseprite --sheet player.png --data player.json --sheet-type packed --format json-array
  • -b batch mode, no window
  • --sheet the PNG, --data the frame metadata (positions, durations, tags)
  • --sheet-type packed packs frames tightly; rows or columns keep them in a grid
  • --format json-array instead of the default hash, easier to loop over

Export one tag only, or every layer as its own file:

shell
aseprite -b player.aseprite --tag walk --save-as walk-{frame}.png
aseprite -b player.aseprite --split-layers --save-as layer-{layer}.png

--scale 4 upsizes without blur on the way out. On Windows the executable is Aseprite.exe in the install folder, or in Steam under steamapps/common/Aseprite.