Nodes/ComfyUI-PSD2Layer/Load PSD File
ComfyUI Node

Load PSD File

One path string, two outputs, zero Photoshop

By Nolan0722·Created 2 months ago·Updated about a month ago· 7
Load PSD File
    • psd
    • flat_preview
    psd_file

    ComfyUI is genuinely weird about Photoshop files. PNG, JPEG, even EXR get first-class treatment, but a .psd is the format the ecosystem mostly pretends doesn't exist - and the community has been feeling that gap for a while. On r/comfyui people who want to run a Qwen pass on one layer and rebuild a layered document end up doing side-by-side PNGs plus a Photoshop action or an ImageMagick script, because nothing in the graph could just do it. This pack is the fix, and Load PSD File is where every one of its workflows starts.

    The node is aggressively simple: one text box, two outputs. Type a path, run, and you get a PSD reference on one pin and a flattened preview on the other. No model to download, no GPU, no API key, no Adobe installation. It's a file opener wearing a node costume - which is exactly right, because the interesting stuff happens downstream.

    What comes out

    • psd - the pack's own PSD data type. It's a lightweight reference to the file (a dict holding the absolute path), not the whole document, so it's nearly free to pass around a graph. You never re-type the path anywhere; wire this pin and forget it.
    • flat_preview - the entire PSD composited onto a transparent background and handed to you as a normal IMAGE tensor, so you can eyeball what you loaded or feed it into a preview/compare node.

    The one input

    Just psd_file, a plain string. The path resolution is the only thing that'll trip you: it accepts an absolute path, or a relative one that's resolved against ComfyUI's input/ folder. So portrait.psd looks in ComfyUI/input/portrait.psd. If the file isn't where you said, you get a clear PSD file not found error - no silent empty output.

    Install

    Same story for every node in this pack. With ComfyUI Manager, search the pack title ComfyUI-PSD2Layer (it's on the Comfy Registry under publisher nolan0722) and hit install. Or the manual route:

    cd ComfyUI/custom_nodes
    git clone https://github.com/Nolan0722/ComfyUI-PSD2Layer
    pip install -r requirements.txt
    

    Restart ComfyUI (or hit Refresh in Manager). Dependencies are light: psd-tools, Pillow, and numpy - all pure Python, no weights to fetch.

    Where people get burned

    The flat_preview is transparent-background RGBA. In the default preview pane that reads as black, which makes people think their PSD loaded wrong. It didn't - drop a Preview Image or Save Image on it, or look at it in anything that composites alpha. And if the file truly won't load, it's usually one of two things: a path typo, or a PSD feature psd-tools chokes on (it's the open-source library doing all the work here, so exotic Photoshop features like some smart-object or PSB variants can be hit-or-miss). For a normal layered document you'll be fine - which is more than you could say before this pack existed.

    CategoryPSD2Layer

    Inputs (1)

    NameTypeDefaultDescription
    psd_fileSTRING

    Outputs (2)

    NameTypeDescription
    psdPSD
    flat_previewIMAGE