Psdtags is a Python library to read and write the Adobe Photoshop(r) specific ImageResources (#34377) and ImageSourceData (#37724) TIFF tags, which contain image resource blocks, layer and mask information found in a typical layered TIFF file created by Photoshop.
The format is specified in the Adobe Photoshop TIFF Technical Notes (March 22, 2002) and Adobe Photoshop File Formats Specification (November 2019).
Adobe Photoshop is a registered trademark of Adobe Systems Inc.
- Author:
- License:
BSD-3-Clause
- Version:
2026.1.29
- DOI:
Quickstart
Install the psdtags package and all dependencies from the Python Package Index:
python -m pip install -U psdtags[all]
View the layer image and metadata stored in a layered TIFF file:
python -m psdtags file.tif
See Examples for using the programming interface.
Source code, examples, and support are available on GitHub.
Requirements
This revision was tested with the following requirements and dependencies (other versions may work):
CPython 3.11.9, 3.12.10, 3.13.11, 3.14.2 64-bit
NumPy 2.4.1
Imagecodecs 2026.1.14 (required for compressing/decompressing image data)
Tifffile 2026.1.28 (required for reading/writing tags from/to TIFF files)
Matplotlib 3.10.8 (required for plotting)
Revisions
2026.1.29
Fix code review issues.
2026.1.8
Improve code quality.
2025.12.12
Make boolean and optional parameters keyword-only (breaking).
2025.9.19
Write MTrn key before layers (#17).
2025.9.15
Add CAI, GENI, and OCIO keys.
Drop support for Python 3.10.
2025.5.10
Support Python 3.14.
2025.1.1
…
Refer to the CHANGES file for older revisions.
Notes
The API is not stable yet and might change between revisions.
This library has been tested with a limited number of files only.
Additional layer information is not yet supported.
Consider psd-tools and pytoshop for working with Adobe Photoshop PSD files.
Layered TIFF files can be read or written by Photoshop, Affinity Photo, and Krita.
See also Reading and writing a Photoshop TIFF.
Examples
Read the ImageSourceData tag value from a layered TIFF file and iterate over all the channels:
>>> isd = TiffImageSourceData.fromtiff('layered.tif')
>>> for layer in isd.layers:
... layer.name
... for channel in layer.channels:
... ch = channel.data # a numpy array
...
'Background'
'Reflect1'
'Reflect2'
'image'
'Layer 1'
'ORight'
'I'
'IShadow'
'O'
Read the ImageResources tag value from the TIFF file, iterate over the blocks, and get the thumbnail image:
>>> res = TiffImageResources.fromtiff('layered.tif')
>>> for block in res.blocks:
... blockname = block.name
...
>>> res.thumbnail().shape
(90, 160, 3)
Write the image, ImageSourceData and ImageResources to a new layered TIFF file:
>>> from tifffile import imread, imwrite
>>> image = imread('layered.tif')
>>> imwrite(
... '_layered.tif',
... image,
... byteorder=isd.byteorder, # must match ImageSourceData
... photometric='rgb', # must match ImageSourceData
... metadata=None, # do not write any tifffile specific metadata
... extratags=[isd.tifftag(maxworkers=4), res.tifftag()],
... )
Verify that the new layered TIFF file contains readable ImageSourceData:
>>> assert isd == TiffImageSourceData.fromtiff('_layered.tif')
>>> assert res == TiffImageResources.fromtiff('_layered.tif')
View the layer and mask information as well as the image resource blocks in a layered TIFF file from a command line:
python -m psdtags layered.tif
Refer to the layered_tiff.py example in the source distribution for creating a layered TIFF file from individual layer images.
1 maintainer
Metadata
1 maintainer
Release files for psdtags 2026.1.29
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| psdtags-2026.1.29.tar.gz | 42.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| psdtags-2026.1.29-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 73.3 kB
Security for psdtags 2026.1.29
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
