# \[Script\] Import PSD to Aseprite

**URL:** https://community.aseprite.org/t/script-import-psd-to-aseprite/26415
**Category:** Scripts & Extensions
**Created:** [July 19, 2025, 7:09am UTC](https://community.aseprite.org/t/script-import-psd-to-aseprite/26415 "2025-07-19T07:09:18Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![fairy](https://community.aseprite.org/letter_avatar/fairy/32/5_5575768a8748004e209b776fc1b2916d.png) [@fairy](https://community.aseprite.org/u/fairy)
#### Post date: [July 19, 2025, 7:09am UTC](https://community.aseprite.org/t/script-import-psd-to-aseprite/26415/1 "2025-07-19T07:09:18Z")

</div>

# PSD to Aseprite - [Download](https://github.com/Tin-01/aseprite-psd-scripts)

## 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 | ✔ |
| RGB Color Mode | ✔ |
| Alpha Channel (-1) | ✔ (Auto-opaque if missing) |
| Group (Folder) Hierarchy | ✔ |
| Layer Masks | ✖ Ignored |
| Adjustment/Text Layers | ✖ Ignored (not rasterized) |
| 16/32 bpc, CMYK, etc. | ✖ 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 ▶ import from psd**
2. Choose your `.psd` file → Click **Import**
3. The imported sprite will open in a new tab

* * *