Svarn

Before you start

• Aseprite 1.3, installed and licensed separately. Checked with Aseprite 1.3.18.6-dev on Linux; other versions and Windows or macOS are not checked yet.
• A document saved to disk, with at least one rectangular slice inside the canvas. Animated slice bounds are not detected.
• RGB or Indexed colour mode. Grayscale is not supported.
• The free svarn-preview-20260929.zip exporter, or the optional paid svarn-0.1.1-guide-bundle.zip package. Both contain the same exporter; payment is not required to export slices.

Your first result

1. Get the exporter and practice files

   Download the free exporter using the button above and extract svarn-preview-20260929.zip. Download the guide & practice files ZIP from Worked example below and extract it separately. If you bought the optional guide bundle instead, extract svarn-0.1.1-guide-bundle.zip, then its program/svarn-preview-20260929.zip. Either way, app/, extension/, samples/ and docs/ below refer to the extracted program folder. The paid bundle puts the same exporter, guide and practice files into one prepared download; it does not add exporter features.

2. Install the extension

   In Aseprite open Edit › Preferences › Extensions › Add Extension…, choose app/svarn-0.1.0.aseprite-extension, and restart Aseprite if asked. The command Svarn: Batch Export Slices... then appears in the File menu, just below the Export submenu.

3. Prepare the sprite

   Open the sprite, make sure its slices are where you want them, and save it (File › Save). Svarn refuses unsaved documents. If you use Save As, open Svarn again afterwards so it follows the new file.

4. Open Svarn

   Choose Svarn: Batch Export Slices... from the File menu. The window Svarn - batch slice export 0.1.0 shows the Document (File, Saved in, Canvas), then Scope, Naming, Output and Preview. It stays open while you keep working.

5. Choose what to export

   Scope: Slices is All slices or Slices selected in the timeline; Frames is All frames, Current frame or Custom range (for example 1-3,5). Naming: pick a Profile such as slice_frame {slice}_{frame} or type your own Template, set Frame digits (default 2), and choose whether Spaces are replaced with _ and whether to force lowercase.

6. Choose where it goes

   Output: Base folder must be a full path; Use document folder fills in the sprite's own folder. Every run writes a new <name>-slices-NNN folder inside it (001, 002, …) and never writes into an existing folder.

7. Preview, then Export

   Click Preview to see the file count, the target folder and the first file names, plus any problem such as a name collision or a slice outside the canvas. Export stays disabled until the plan is valid. Click Export; if Aseprite asks for file access for the script, allow it. The Status row then reads, for example, Exported and verified 6 of 6 files in hero-slices-001.

8. Check the result

   Open the new folder: one PNG per slice and frame, plus svarn-manifest.json listing expected files, actual files, failures, warnings and settings, with status complete, complete_with_warnings or incomplete. Your dialog choices are remembered by Aseprite for next time; Svarn makes no network requests and writes nothing outside the folder you chose. To remove it: Edit › Preferences › Extensions, select Svarn, Uninstall.

A worked example

Export two pickup icons

Input: examples/svarn/pickups.png (a fictional 32 × 16 image with a coin and a gem) and examples/svarn/slices.csv, which lists the two slices to draw: coin at x 0, y 0, 16 × 16 and gem at x 16, y 0, 16 × 16.

1. In Aseprite open examples/svarn/pickups.png.
2. With Aseprite's Slice tool draw the two slices from slices.csv and name them coin and gem in each slice's properties.
3. Save the sprite with File › Save As… as pickups.aseprite (the .aseprite format keeps slices).
4. From the File menu choose Svarn: Batch Export Slices... and keep All slices, All frames, profile slice_frame and Frame digits 2. Click Use document folder, then Preview, then Export.

Expected result: Preview plans 2 PNG files (coin, frame 1 -> coin_01.png and gem, frame 1 -> gem_01.png). Export creates a folder pickups-slices-001 next to pickups.aseprite containing coin_01.png and gem_01.png (16 × 16 each) and svarn-manifest.json with status complete; the Status row reads Exported and verified 2 of 2 files in pickups-slices-001. Exporting again creates pickups-slices-002 instead of overwriting.

Troubleshooting

Compatibility & limits

• Rectangular static slices only. No colour conversion, atlas packing, game-engine import, GIF or video export, and no cancel button while an export runs.
• Checked in Aseprite 1.3.18.6-dev on Linux only; Windows, macOS and large production documents are not checked yet. Keep a copy of your source file.
• No automatic updates: to update, add a newer package over the old one in Edit › Preferences › Extensions.
• The original program keeps its included preview permissions: you may use it, including for real work, and keep what you create, but not sell or redistribute it (see PREVIEW-PERMISSION.md). Aseprite has its own licence.
• Aseprite licensed separately. Linux 1.3.18.6-dev GUI verified; Windows, macOS, large projects and upgrades unverified. No grayscale or animated slice bounds.

Need a hand?

Tell us the product, host application and version, what you tried, and the exact error. Contact support with a fictional example; keep private customer files and passwords out of your message.