Aseprite Batch Resizer Script

Using Aseprite? You have a LOT of assets? Need to publish it in DIFFERENT SIZES but too TIRED and TEDIOUS to do it one by one?  

Introducing to you:

Aseprite Batch Resizer script for Aseprite v1.3.xx and above!

Tested on:

✔️WIndows

❌Mac

❌Linux

How to Install:

1. Download the script code
2. Copy it in the script folder (if you're using Windows, usually in C:\Users\[YOUR USERNAME]\AppData\Roaming\Aseprite\scripts)
3. Open Aseprite
4. In Aseprite, press F5 button (or click File >> Script >> Rescan Scripts Folder)

How to do Batch Resize:

1. Get your files ready as .png, .ase, or .aseprite file format in one folder, just ONE folder
2. Open Aseprite
3. Click File >> Script >> Aseprite
4. Fill the required form in the dialog box (scale factor, suffix, input, and output). 
5. Just follow the dialog box instruction if you get an error
6. Click process
7. Check your output folder for result
8. Done

FAQ:

Q: What's the interpolation used in this resizer?

A: Nearest neighbor

Q: Can I change the interpolation?

A: By default? No. But you can tweak the script code if you want.

Q: Why I have to type the full filepath? It is so annoying! 

A: Unfortunately, Aseprite's Lua API does not provide a built-in file or folder picker dialog, so that's why I can't implement folder picker

Q: Still, I DON'T WANT to type the full filepath!!! It is so uncomfortable! 

A: In Windows 8 and above, you can open Windows Explorer and navigate to the folder where your file is/will be located.  Once there, without selecting any file, click the Explorer's address bar then press Ctrl + C (or left click, and select copy). Paste what you have copied into the filepath. That's how you do it without typing in Windows OS. I don't know how you'll deal with it in Linux or Mac., but it should be the same

Q: Do you use AI when writing this script?

A: Yes, but partially and it has a story! The original code was only for my personal use; it has no filepath validation, just one-click, always look in the same input folder, and always export in one very specific folder at fixed 2x and 3x upscale factor. Then I decided to go for more flexible and friendlier user interface: adding a nice dialog box, custom upscale, and custom directory path. But it gave errors! When I tried to google for help, an OP of updated 2019 post in the official Aseprite community encourage/recommend the use of AI to debug the code instead of sharing headaches together (see https://community.aseprite.org/t/aseprite-scripts-collection/3599). I finally use ChatGPT to produce that beautiful dialog box and debug why in the world the original code always export the output in the Aseprite's installation folder. Because the result is good, I want to share it with you all.

Q: Can I resell/redistribute this script?

A: About that, please read and understand the License Information first.

v1.00 - First release

License Information:

Copyright (c) 2025 VectoRaith

Permission is hereby granted to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.