Nodes/ComfyUI_LayerStyle_Advance/LayerUtility: Load PSD(Advance)
ComfyUI Node Runs on cloud

LayerUtility: Load PSD(Advance)

Load PSD — pull individual Photoshop layers straight into ComfyUI

By chflame163·Created 2 years ago·Updated 4 months ago· 696
LayerUtility: Load PSD(Advance)
    • flat_image
    • layer_image
    • all_layers
    image
    file_path
    include_hidden_layerfalse
    find_layer_by
    layer_index0
    layer_name

    If your source material lives in Photoshop and you want a specific layer - not a flattened export - this is the node that reads a .psd file directly and gives you access to its layer structure without you having to pre-flatten anything in Photoshop first. It's genuinely useful if you're pulling assets from a layered composition someone else built: character on one layer, background on another, and you only want one of them.

    image is a dropdown of .psd files already sitting in ComfyUI/input - anything you've previously loaded shows up here for quick re-selection. file_path is the alternative: a full path and filename if the PSD isn't in the input folder. include_hidden_layer decides whether layers that are toggled off/invisible in the PSD still get counted and made available - off by default, which matches what you'd expect (a hidden layer usually means the artist didn't want it used). find_layer_by switches between two ways of picking a layer: layer_index (numbered from the bottom of the stack up, starting at 0) or layer_name (must match exactly, including capitalization and punctuation - a common source of "why isn't this working" when the name looks right at a glance but has a trailing space or different case). layer_index also accepts -1 as a shortcut for the topmost layer, which is handy when you don't know or care about the exact stack position and just want whatever's on top. Note that a layer group in the PSD counts as a single layer for indexing purposes - it doesn't expand into its members. Three outputs come out of this: flat_image (a full preview of the PSD flattened, useful for seeing the whole composition at a glance), layer_image (specifically the layer you selected via index or name), and all_layers (every layer in the file as a batch, if you want to work with the whole stack downstream rather than picking just one).

    Install the pack through ComfyUI Manager (search "ComfyUI Layer Style Advance") or git clone https://github.com/chflame163/ComfyUI_LayerStyle_Advance into custom_nodes/, restart. This node depends specifically on the psd_tools Python package, which isn't always installed cleanly by the standard requirements step - the README calls it out as its own separate note, which is a signal it's a common enough failure to warn about up front.

    The single most common problem with this node is exactly that: ModuleNotFoundError: No module named 'psd_tools'. If you hit it, close ComfyUI and run python_embeded/python.exe -s -m pip install psd_tools (adjust the path for your ComfyUI flavor) from a terminal opened in the plugin directory. If that install then fails with ModuleNotFoundError: No module named 'docopt', psd_tools has a dependency that doesn't always resolve cleanly through pip - download docopt's wheel file directly (piwheels.org hosts it) and install that specific wheel manually before retrying psd_tools. This two-step failure (psd_tools missing, then docopt missing underneath it) is common enough that the pack ships prebuilt wheels for exactly this and runs the fix automatically as part of the standard dependency-install script - so if you're setting this up fresh, running the full install_requirements.bat (or the Aki equivalent) from the start avoids the manual detour entirely.

    Category😺dzNodes/LayerUtility/SystemIO

    Inputs (6)

    NameTypeDefaultDescription
    imageCOMBO0 options:
    file_pathSTRING
    include_hidden_layerBOOLEANfalse
    find_layer_byCOMBO2 options: layer_index, layer_name
    layer_indexINT0-1–999
    layer_nameSTRING

    Outputs (3)

    NameTypeDescription
    flat_imageIMAGE
    layer_imageIMAGE
    all_layersIMAGE