Skip to main content

psd2pngs

CI Status Documentation Status

Test coverage percentage uv Ruff prek

PyPI Version Supported Python versions License


Documentation: https://psd2pngs.readthedocs.io

Source Code: https://github.com/34j/psd2pngs


Convert a PSD file to PNG files while maintaining the layer hierarchy.

Introduction

psd2pngs converts a psd file to png files while maintaining the layer hierarchy and performing the appropriate renaming, using multiprocessing. You do not have to read this long docs, just download Executable and open a psd file with it!

Example

Screenshot GIF

Note that this GIF is in fast forward.

Usage

Using as an app

  • Just open .psd file with this app. (Executable version only.)
  • Alternatively, this app can also be used with command prompt.
> psd2pngs -h
Usage: psd2pngs [OPTIONS] PSD_PATH

Options:
  -v, --version              Show the version and exit.
  -o, --out PATH             Output directory path. If not specified, output
                             to the same directory as the PSD file.
  -s, --single-process       Force not to use multiprocessing.
  -t, --tasks-count INTEGER  Number of tasks. Recommended to be less than or
                             equal to the number of CPUs (32) because the
                             process maximizes the use of CPUs.
  -j, --json                 Output JSON file containing layer information in
                             snake case.
  -jc, --json-camel-case     Output JSON file containing layer information in
                             camel case.
  -h, -?, --help             Show this message and exit.

The type of content of Output JSON file (snake_case) is the following.

class LayerInfo(NamedTuple):
    local_path: str
    name: str
    safe_name: str
    is_visible: bool
    is_group: bool
    children: "Iterable[LayerInfo]"

The type of content of Output JSON file (camelCase) is the following.

class LayerInfo(NamedTuple):
    localPath: str
    name: str
    safeName: str
    isVisible: bool
    isGroup: bool
    children: "Iterable[LayerInfo]"

Using as a module

See the documentation (readthedocs.io).

Installation

Option 1. Executable version

Download the latest release from Releases.

Option 2. Python version using pip install

py -m venv venv
"./venv/Scripts/Activate.bat"
pip install psd2pngs
psd2pngs from.psd

Option 3. Python version using git clone

git clone https://github.com/34j/psd2pngs.git
cd ./psd2pngs
py -m venv venv
"./venv/Scripts/Activate.bat"
pip install .
python -m psd2pngs from.psd

Option 4. Executable version - Compiling yourself using pip

py -m venv venv
"./venv/Scripts/Activate.bat"
pip install .
pip install pyinstaller
pyinstaller venv/Lib/site-packages/psd2pngs/__main__.py --onefile -n psd2pngs
move "./dist/psd2pngs.exe" "./"
./psd2pngs from.psd

Option 5. Executable version - Compiling yourself using git

git clone https://github.com/34j/psd2pngs.git
cd ./psd2pngs
py -m venv venv
"./venv/Scripts/Activate.bat"
pip install .
pip install pyinstaller
pyinstaller src/psd2pngs/__main__.py --onefile -n psd2pngs
move "./dist/psd2pngs.exe" "./"
./psd2pngs from.psd

日本語の説明

psd2pngsは、psdファイルをレイヤーの階層構造を維持したままpngファイルに変換し、適切なリネームを行うアプリケーションです。 1ファイルにまとまったWindows用実行ファイルpsd2pngs.exeも配布しています。

インストール方法

  • Releasesから最新のリリースをダウンロードします。

使い方

  • psdファイルを右クリックし、プログラムから開くを使ってこのアプリで開きます。

Metadata

Release files for psd2pngs 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for psd2pngs 1.0.0
File Size Uploaded Provenance Actions
psd2pngs-1.0.0.tar.gz 11.6 kB With provenance Details for psd2pngs-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for psd2pngs 1.0.0
File Interpreter ABI Platform Actions
psd2pngs-1.0.0-py3-none-any.whl Python 3 none any Details for psd2pngs-1.0.0-py3-none-any.whl

Total release size: 22.6 kB

Release files / psd2pngs-1.0.0.tar.gz

Download URL psd2pngs-1.0.0.tar.gz
Size 11.6 kB
Tags Source
SHA-256 checksum
How to use checksums
e91688798671c0912fdfc65b91b684535fc3922d50cff5441075e0472b6c273e
BLAKE2b-256 checksum
How to use checksums
83286b82d695fcae03784f78b71bfabfb034ea75ec86a45642ef05a8c9d1d109
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / psd2pngs-1.0.0-py3-none-any.whl

Download URL psd2pngs-1.0.0-py3-none-any.whl
Size 11.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bf2f1df6148bc7c283ada7229a36871e52ac75cb73a7aaacf970e6ca6c72e77f
BLAKE2b-256 checksum
How to use checksums
f0591a35588a3ef2ccc73ef1be5236d675e7b129abf3e7165d54a9ad499783e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for psd2pngs 1.0.0

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for psd2pngs-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page