Skip to main content
Aseprite includes a powerful command-line interface (CLI) that allows you to automate tasks like batch conversion, sprite sheet generation, and image processing without opening the GUI.

​
Basic Usage

The basic syntax for using Aseprite from the command line is: 
aseprite [OPTIONS] [FILES...]

​
Common Use Cases

The CLI is particularly useful for:
  • Batch Processing: Convert multiple files at once
  • Sprite Sheet Generation: Export animations as sprite sheets with metadata
  • CI/CD Integration: Automate asset processing in build pipelines
  • Scripting: Execute Lua scripts on sprite files
  • Format Conversion: Convert between different image formats
  • Color Mode Changes: Batch convert color modes (RGB, Grayscale, Indexed)

​
Running in Batch Mode

By default, Aseprite starts with its UI. To run in batch mode (no UI), use the --batch flag: 
aseprite --batch input.ase --save-as output.png

​
Preview Mode

To see what commands will be executed without actually running them, use the --preview flag: 
aseprite --preview --batch input.ase --save-as output.png

​
Verbose Output

For detailed output about what Aseprite is doing: 
# Standard verbose output
aseprite --verbose --batch input.ase --save-as output.png

# Extremely verbose output (debug mode)
aseprite --debug --batch input.ase --save-as output.png

​
Getting Help

Display all available CLI options: 
aseprite --help
Check the version: 
aseprite --version

​
Basic Examples

​
Convert a single file

aseprite --batch sprite.ase --save-as sprite.png

​
Process multiple files

aseprite --batch file1.ase file2.ase file3.ase --save-as output-{title}.png

​
Scale and convert

aseprite --batch input.ase --scale 2 --save-as output.png

​
Command Processing Order

Aseprite processes commands in the order they appear on the command line. This is important for operations that depend on previous commands:
  1. Files are loaded first
  2. Modifications are applied (scale, palette, color mode, etc.)
  3. Export operations are executed (save-as, sheet generation)

​
Next Steps