1. Open an .aseprite or .ase file
Open the studio and choose File → Open…, or press Ctrl+O (⌘+O on a Mac). Select the .aseprite or .ase file. You can also drag the file onto the editor window. Each file opens as a document in its own tab, and up to eight documents can be open at once.
The file is read entirely inside your browser. Nothing is uploaded, which makes this a quick way to look at a sprite someone sent you on a computer that does not have Aseprite installed.
RGBA, grayscale and indexed Aseprite files can all be opened. Indexed files open as indexed documents with their palette, keeping up to 256 colours.
2. What comes across on import
Most of a typical Aseprite project carries over:
- Layers and groups, including nested groups, visibility, locks, opacity and reference layers.
- Blend modes: Normal, Multiply, Screen, Overlay, Darken, Lighten, Difference and Add. Other modes are set to Normal.
- Frames, with their durations, plus linked cels and cel opacity.
- Tags, with their direction (forward, reverse or ping-pong) and the closest matching tag colour.
- Tilemaps and tilesets, including flipped tiles. If a tileset is stored in a separate file, the editor asks you to pick it.
- Slices with 9-patch centres and pivots (animated slices keep their first key), and the pixel aspect ratio.
Text user data is not kept. When anything cannot be carried over exactly, an import summary lists what changed, so you are never left guessing.
3. Edit and keep a project copy
Once open, the file is an ordinary document: draw, add frames, adjust the palette and play the animation as normal. Your work is autosaved in the browser, but that copy stays in this browser profile only.
To keep everything exactly as it is in Tiny Pixel Editor, choose File → Save project and save a .pxl file. It stores layers, frames, tilemaps and settings in the editor's own format. The saving guide explains autosave and project files in more detail.
4. Export an Aseprite file
To send work back to someone using Aseprite, choose File → Export… and set Format to Aseprite (editable RGBA). The exported file keeps:
- layers and groups, blend modes, opacity, visibility, locks and reference layers;
- frames, durations, linked cels and cel opacity;
- tags with their direction and colour;
- slices with 9-patch and pivot data, and the pixel aspect.
A few things are simplified on the way out. The file is always 32-bit RGBA at the original size, so an indexed palette is not written. Tilemap layers become ordinary pixel layers, and pixels that were moved off the edge of the canvas are left out.
5. Check the file in Aseprite
Open the exported file in Aseprite and check the layer list, tags and timing before you continue there. If you converted from indexed colour, use Aseprite's own colour mode command to switch back after checking the palette.
For game engines that read Aseprite's JSON format rather than .aseprite files, export a Sprite sheet (PNG) and its Sprite sheet metadata (JSON) instead. The JSON uses an Aseprite-style structure with frame rectangles, durations and tags. See how to export a sprite sheet.