An advanced sprite packing tool. Currently a work in progress.
- Either the Microsoft .NET framework on Windows, or the Mono runtime on other platforms.
- If you want to build SpritePacker from source, you'll need git installed and in your PATH.
I provide prebuilt binaries, just in case you can't get SpritePacker to build yourself.
- Clone or download this repo, and build the included solution.
- Windows GUI: Open the solution in Visual Studio and hit build (CTRL + SHIFT + B).
- Windows Command Line: Run
msbuildfrom the root of this repo (I assume).
- Linux GUI: Open the solution in MonoDevelop and hit build (F8)
- Linux Command Line: Run
xbuildfrom the root of this repo.
SpritePacker is currently a command line tool (Requests for a GUI are welcome), and intended to be easy to automate and integrate into your existing workflow. Despite that, it's still easy to use. Here's an example of how you would pack 3 different images into the same file:
SpritePacker.exe /path/to/output.png picture1.png textureB.jpeg anotherimage.gif
Your next latest and greatest project will probably have a lot more than just 3 images, making specifying them all one by one a pain in the neck. Thankfully, SpritePacker supports (recursive!) directories of images:
SpritePacker.exe /path/to/output.png /path/to/image/directory
Packing sprites is all very well, but your program needs to be able to tell where each individual sprite was placed in the final image. SpritePacker tells you by outputting some nice, easy to read text, but this isn't particularly machine-friendly. Alternatively, you can add the
--csv flag when you call SpritePacker. This will cause SpritePacker to output some nice, (hopefully) well-formatted CSV for your program to consume:
SpritePacker.exe /path/to/output.png /path/to/image/directory --csv
Note that any other text besides the CSV will be ouputted via stderr, so you can pipe the raw stdout to a file and have your program understand it.
SpritePacker.exe /path/to/output.png /path/to/image/directory --csv >SpriteLocations.csv
Additonal help can be found by running
This project is a work in progress. If you encounter any issues, please open an issue on the issue tracker if you have an account, otherwise please send an email to
bugs at starbeamrainbowlabs.com.
Once SpritePacker is somewhat stable, it will be moving to GitHub. I still intend to host a mirror at this address though, so you can bookmark this address.
If you would like to contribute (before the move to GitHub sometime in the future), please an email to the aforementioned address and I'll create you an account with which you can contribute.