Skip to content

psd-tools/psd-tools

Folders and files

NameName
Last commit message
Last commit date
Oct 23, 2024
Jan 20, 2025
Feb 25, 2025
Nov 25, 2024
Jan 4, 2024
Feb 21, 2024
Jan 4, 2024
Feb 25, 2025
Jan 24, 2019
Jan 5, 2024
Sep 26, 2024
Feb 19, 2025
Jan 4, 2024

Repository files navigation

psd-tools

psd-tools is a Python package for working with Adobe Photoshop PSD files as described in specification.

PyPI Version Build Document Status

Features

Supported:

  • Read and write of the low-level PSD/PSB file structure
  • Raw layer image export in NumPy and PIL format

Limited support:

  • Composition of basic pixel-based layers
  • Composition of fill layer effects
  • Vector masks
  • Editing of some layer attributes such as layer name
  • Basic editing of pixel layers and groups, such as adding or removing a layer
  • Blending modes except for dissolve
  • Drawing of bezier curves

Not supported:

  • Editing of various layers such as type layers, shape layers, smart objects, etc.
  • Composition of adjustment layers
  • Composition of many layer effects
  • Font rendering

Installation

Use pip to install the package:

pip install psd-tools

Getting started

from psd_tools import PSDImage

psd = PSDImage.open('example.psd')
psd.composite().save('example.png')

for layer in psd:
    print(layer)
    layer_image = layer.composite()
    layer_image.save('%s.png' % layer.name)

Check out the documentation for features and details.

Contributing

See contributing page.

Note

PSD specification is far from complete. If you cannot find a desired information in the documentation, you should inspect the low-level data structure.