Skip to main content

A toolkit for batch processing PSD files - hide text layers and export to PNG

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

psd_toolkit-0.2.0.tar.gz (67.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

psd_toolkit-0.2.0-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

Details for the file psd_toolkit-0.2.0.tar.gz.

File metadata

  • Download URL: psd_toolkit-0.2.0.tar.gz
  • Upload date:
  • Size: 67.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for psd_toolkit-0.2.0.tar.gz
Algorithm Hash digest
SHA256 4a0e2d855f71f964389edd21b38c6dde8dbb0311924c1243a29d03b26643ed7a
MD5 15cebfe640ead0a846b5de14843fbeff
BLAKE2b-256 95c284aa64c17595093d1685b02582256f2203090bfc5cafd39f18e685f370c1

See more details on using hashes here.

File details

Details for the file psd_toolkit-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: psd_toolkit-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 6.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for psd_toolkit-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2280bc5f237d2dae7544de34e568ffbe5b26e215d5c4e7dcb4a420090793ae8e
MD5 c3f7f04f9b976a5782e8dfe53f93ddac
BLAKE2b-256 24dafaec2c96527ba79833138d12b1a687a488533ffb402cfdb1db31e259ee5e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page