Split and merge frames from Aseprite files
MIT License
WIP/Incomplete
This is an Aseprite extension that can split and merge frames from one or more sprite files to another. It preserves any associated tags, layers, and other metadata.
This is mainly intended for sitautions where you have a large group of static images per Aseprite file, with one frame per image. The process can be tedious if you want to reorganize frames across multiple such files, especially if you make heavy use of tags and tag/layer userdata, which need to be manually copied one at a time.
This extension makes this task much simpler.
Edit > Preferences > Extensions > Add Extension
See Extensions in the Aseprite docs for more information.
Example one-liner to install on Linux:
curl \
https://raw.githubusercontent.com/JWCook/aseprite-split-merge/main/split-merge.lua \
-o ~/.config/aseprite/scripts/split-merge.lua
To run, either select Frames > Split/Merge
, or press Ctrl+Shift+M
Select File > Scripts > split-merge
aseprite-split-merge
can also be run from the Aseprite CLI,
using the --script
and (optionally) --script-param
arguments.
src-sprite
: Sprite file to copy from; otherwise use active spritedest-sprite
: Sprite file to copy to; otherwise create new sprite
{src-sprite}_{start}-{end}.aseprite
start-frame
: Frame to start copying from; default: 1
end-frame
: Frame to stop copying from; default: last frame of src-sprite
overwrite
: Overwrite an existing file instead of appending to it; default: false
aseprite -b my_sprite.aseprite \
--script-param dest-sprite=my_sprite_subset.aseprite \
--script-param start-frame=1 \
--script-param end-frame=10 \
--script-param overwrite=true \
--script split-merge.lua