psd-toolkit

A Python toolkit for batch processing Adobe Photoshop PSD files. Automatically hide text layers and export to PNG format.

Features

• 🚀 Batch process multiple PSD files in a directory
• ⚡ Parallel processing for faster execution
• 📊 Progress bar with detailed status
• 📝 Automatically hide all text layers
• 🖼️ Export processed files as PNG (default) or other formats
• 📁 Support for recursive directory processing
• ⚡ Preserve folder structure in output

Installation

Install using pip:

pip install psd-toolkit

Or using uv:

uv add psd-toolkit

Usage

Command Line

Process PSD files in a directory:

psd-toolkit -d /path/to/psd/files

Process recursively, specify output directory, and use JPEG format:

psd-toolkit -d /path/to/psd/files -o /path/to/output -r -f jpeg

Options

• -d, --dir: Input directory containing PSD files (required)
• -o, --output: Output directory for processed files (default: input directory)
• -f, --output-format: Output image format (default: png)
• -r, --recursive: Process subdirectories recursively

Python API

You can also use psd-toolkit as a Python library:

from psd_toolkit.psd.processor import PSDProcessor
from psd_toolkit.job import BatchJob

# Process a single file
processor = PSDProcessor("image.psd")
processor.load()
processor.hide_text_layers()
processor.export("output.jpg", format="jpeg")

# Batch process
job = BatchJob(
    input_dir="./psd_files",
    output_dir="./output",
    recursive=True,
    output_format="png",
    max_workers=4
)
job.run()

Requirements

• Python >= 3.10
• psd-tools >= 1.12.0
• pillow >= 12.0.0
• tqdm >= 4.67.1

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Issues

Report bugs and request features on GitHub Issues.