Aspose.PSD FOSS
Python
Aspose.PSD FOSS for Python — Frequently Asked Questions

Aspose.PSD FOSS for Python — Frequently Asked Questions

Licensing & Open Source

What is the licensing model?

Aspose.PSD FOSS for Python is MIT licensed. You can use, modify, and redistribute it under the terms of the MIT license.

Can I use it in commercial products?

Yes. The MIT license permits commercial use, modification, and redistribution without royalties.

Installation & Requirements

How do I install Aspose.PSD FOSS for Python? 

git clone https://github.com/aspose-psd-foss/Aspose.PSD-FOSS-for-Python.git
cd Aspose.PSD-FOSS-for-Python
# No packaging manifest is published yet -- run from this folder,
# or add it to PYTHONPATH:
export PYTHONPATH=$PWD:$PYTHONPATH

Are there any native dependencies?

No. The library is pure Python with no third-party package dependencies.

Format Support

Which formats can Aspose.PSD FOSS for Python read and write?

It loads and saves PSD and PSB (Photoshop large document) files. Image.load() and PsdImage.load() open a document from a file path or stream; PsdImage.save() writes it back to PSD/PSB.

Does it render or export pixel data to other image formats?

No. This FOSS build loads and edits PSD/PSB document structure and layer metadata — it does not rasterize or export to other raster formats like PNG or JPEG.

API Usage

What is the main entry-point class?

PsdImage (a subclass of Image). Load a document with PsdImage.load(), then read its layers collection and header properties.

How do I inspect a document’s layers?

Read the layers property on a loaded PsdImage to get its collection of Layer objects. Each Layer exposes metadata such as name, visibility, opacity, clipping, blend mode, and bounds.

Can I modify layer metadata?

Yes — Layer exposes a working setter for several properties (for example, visibility and name can be changed), and PsdImage.layers itself has a working setter for replacing the collection. Some specific properties are not supported in this FOSS build — see Known Limitations below.

How do I save changes back to a file?

Call PsdImage.save() with a destination path or stream after making your changes.

Known Limitations

What is not supported in this FOSS build?

Several property setters raise NotSupportedException rather than applying the change: PsdImage.active_layer, PsdImage.image_resources, PsdImage.global_layer_resources, and PsdImage.has_transparency_data setters; Layer.channel_information, Layer.layer_mask_data, and Layer.layer_blending_ranges_data setters. Each raises with a clear FOSS-specific message (for example, “Changing the active layer is not supported by this FOSS build.”) so the limitation is discoverable at runtime.

Will these limitations be removed in a future version?

Not documented. Check the project’s release notes for updates.

See Also