ComfyUI APZmedia PSD Tools

Custom ComfyUI nodes for seamless PSD file integration with Photoshop. Save and load images as PSD layers with mask support.

Features

• Multi-layer PSD Creation: Save 1-10 images as separate layers in a single PSD file
• PSD Layer Loading: Extract specific layers and masks from existing PSD files
• Mask Support: Apply masks to individual layers with automatic canvas positioning
• Flexible Inputs: All layer inputs are optional - connect only what you need
• Auto-dependency Installation: Dependencies install automatically on first load

Installation

1. Copy to ComfyUI custom nodes directory:

   ComfyUI/custom_nodes/APZmedia-ComfyUI-PSDtools/
   

2. Restart ComfyUI

Dependencies will install automatically. If installation fails, see troubleshooting.

Nodes

APZmedia PSD Multilayer Saver

Category: image/psd

Saves up to 10 images as layers in a PSD file.

Inputs (all optional):

• output_dir (STRING): Output directory (default: "./output")
• filename_prefix (STRING): Filename prefix (default: "output")
• layer1-layer10 (IMAGE): Images for each layer
• mask1-mask10 (MASK): Masks for each layer
• layer_name1-layer_name10 (STRING): Custom layer names

Outputs: None (writes to disk)

APZmedia PSD Layer Loader

Category: image/psd

Loads PSD files and extracts specific layers.

Inputs:

• psd_file (STRING): Path to PSD file
• layer_index (INT): Layer index to extract (0-based)
• load_mask (COMBO): Load mask ("true"/"false", default: "true")

Outputs:

• image (IMAGE): Extracted layer
• mask (MASK): Layer mask
• layer_name (STRING): Layer name
• layer_count (INT): Total layers in PSD

Usage Examples

Basic Multi-layer Saving

1. Connect images to layer1, layer2, etc.
2. Set custom layer names: "Background", "Character", "Effects"
3. Add masks if needed
4. Run workflow to create PSD

Loading PSD Files

1. Set PSD file path
2. Select layer index (0-based)
3. Choose whether to load mask
4. Use extracted image and mask in workflow

Mask Extraction

The loader uses a sophisticated multi-method approach:

1. Mask Object Extraction: Primary method for PSD layer masks
2. Alpha Channel Extraction: Fallback for transparency-based masks
3. Channel Data Extraction: Advanced fallback for complex PSD structures

Canvas Positioning: Automatically handles mask positioning to match full image dimensions.

Troubleshooting

Common Issues

"No layers or masks are being saved"

• Connect at least one layer input

"Failed to save PSD file"

• Check output directory permissions
• Ensure sufficient disk space

"Layer index out of range"

• Verify layer index is within valid range (0 to layer_count-1)

Dependencies not installing

• Check internet connection
• Try manual installation: pip install psd-tools>=1.9.0

Manual Installation

If auto-installation fails:

cd ComfyUI/custom_nodes/APZmedia-ComfyUI-PSDtools/
python install_for_comfyui.py

Technical Details

Dependencies: psd-tools, Pillow, torch, numpy File Format: Adobe Photoshop PSD (CS6+ compatible) Performance: Optimized for ComfyUI tensor operations

License

MIT License - see LICENSE for details.

Changelog

v0.2.1

• Simplified to essential nodes only
• Removed pytoshop dependency
• Improved mask handling with PIL compositing
• Enhanced error handling and auto-installation

---

For support, open an issue on GitHub.