[Script] Import PSD to Aseprite

PSD to Aseprite - Download

Key Features

Feature Description
RGB / RGBA (8 bpc) Support Recognizes both 3-channel (RGB) and 4-channel (RGBA) formats; automatically generates opaque alpha if missing
Perfect Group Structure Restoration Interprets PSD lsct (Section Divider) Types 0-3 → Converts to Aseprite folders with Layer.isGroup = true
PackBits RLE Decompression Implements only the compression used by the export script, reducing complexity while increasing speed
UTF-8 Safe Name Handling Converts luni (UTF-16BE) layer names → UTF-8, automatically replaces invalid bytes to prevent crashes
CLI & GUI Support Both Aseprite UI dialog and aseprite -b -script ... --filename=… command-line usage
Automatic Debug Logging Generates PSD Import Debug Log.txt in the same folder for layer tree and error tracking

Support Coverage / Limitations

Item Status
8 bpc Bit Depth :check_mark:
RGB Color Mode :check_mark:
Alpha Channel (-1) :check_mark: (Auto-opaque if missing)
Group (Folder) Hierarchy :check_mark:
Layer Masks :multiply: Ignored
Adjustment/Text Layers :multiply: Ignored (not rasterized)
16/32 bpc, CMYK, etc. :multiply: Not supported

Installation

  1. Copy import from psd.lua to:
    Aseprite ▶ File ▶ Scripts ▶ Open Scripts Folder
  2. Restart Aseprite or use Scripts ▶ Rescan Scripts Folder
  3. If you see File ▶ Scripts ▶ import from psd in the menu, installation is complete

Usage

  1. Select Scripts :play_button: import from psd
  2. Choose your .psd file → Click Import
  3. The imported sprite will open in a new tab

2 Likes