Hi everyone,
I’ve released PSD Support, a free and open-source extension for importing layered PSD/PSB files and exporting documents back to PSD/PSB.
Highlights
- Layered PSD and PSB import and export
- Photoshop frame timeline reconstruction
- Automatic cross-frame layer association and linked-cel restoration
- Preservation of supported groups, visibility, opacity, positions, and frame durations
- Structured information-loss reporting
A different approach
The community already has useful Lua tools: Tin-01’s importer handles an RGB/RGBA 8-bit PackBits PSD subset, while Tsukina-7mochi’s script provides PSD export.
This project takes a different approach: conversion is performed by a bundled external tool instead of entirely within Lua. This enables broader PSD/PSB handling, Photoshop timeline reconstruction, automatic layer association across frames, linked-cel restoration, and detailed conversion-loss diagnostics.
The trade-off is that the converter needs platform-specific builds rather than being a single portable Lua script. Packages are provided for Windows x64, Linux x64, macOS Intel, and macOS Apple Silicon; the universal package bundles all of them.
Current limitation
Native File > Open and File > Save As… integration is currently blocked by #6007. The upstream fix has been merged and is targeted for 1.3.18.4.
Until that release, use File > Import > Import PSD/PSB… and File > Export > Export PSD/PSB…. Imported files become .aseprite documents, so normal saving defaults to that format.
On first use, Aseprite may ask for permission to launch the bundled converter.
Feedback and real-world PSD/PSB samples are welcome!