https://github.com/34j/psd2pngs
[Onefile .exe / Multiprocessing]🖼 psd2pngs converts a PSD file to PNG files with a single click or via CLI while maintaining the layer hierarchy and performing the appropriate renaming.
https://github.com/34j/psd2pngs
executable psd python windows
Last synced: 2 months ago
JSON representation
[Onefile .exe / Multiprocessing]🖼 psd2pngs converts a PSD file to PNG files with a single click or via CLI while maintaining the layer hierarchy and performing the appropriate renaming.
- Host: GitHub
- URL: https://github.com/34j/psd2pngs
- Owner: 34j
- License: mit
- Created: 2022-08-08T14:20:23.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-08-29T09:47:19.000Z (over 3 years ago)
- Last Synced: 2025-08-20T17:23:08.326Z (3 months ago)
- Topics: executable, psd, python, windows
- Language: Python
- Homepage:
- Size: 146 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: License.txt
Awesome Lists containing this project
README
# psd2pngs
[](./License.txt)
[](https://github.com/34j/psd2pngs/releases)
[](#日本語の説明)
[](https://pypi.org/project/psd2pngs/)
## 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 [](https://github.com/34j/psd2pngs/releases) and open a psd file with it!
## Example
Note that this GIF is in fast forward.
## Usage
### Using as an app
- Just open `.psd` file with this app. ([Executable version](https://github.com/34j/psd2pngs/releases) only.)
- Alternatively, this app can also be used with command prompt.
```shell
> 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.
```python
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.
```python
class LayerInfo(NamedTuple):
localPath: str
name: str
safeName: str
isVisible: bool
isGroup: bool
children: "Iterable[LayerInfo]"
```
### Using as a module
[](https://psd2pngs.readthedocs.io/)
See the [documentation (readthedocs.io)](https://psd2pngs.readthedocs.io/).
## Installation
### Option 1. Executable version
Download the latest release from [Releases](https://github.com/34j/psd2pngs/releases).
### Option 2. Python version using pip install
[](https://pypi.org/project/psd2pngs/)
[](https://pypi.org/project/psd2pngs/)
```shell
py -m venv venv
"./venv/Scripts/Activate.bat"
pip install psd2pngs
psd2pngs from.psd
```
### Option 3. Python version using git clone
```shell
git clone https://github.com/34j/psd2pngs.git
cd ./psd2pngs
py -m venv venv
"./venv/Scripts/Activate.bat"
pip install -r requirements.txt
python -m psd2pngs from.psd
```
### Option 4. Executable version - Compiling yourself using pip
```shell
py -m venv venv
"./venv/Scripts/Activate.bat"
pip install psd2pngs
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
```shell
git clone https://github.com/34j/psd2pngs.git
cd ./psd2pngs
py -m venv venv
"./venv/Scripts/Activate.bat"
pip install -r requirements.txt
pip install pyinstaller
pyinstaller psd2pngs/__main__.py --onefile -n psd2pngs
move "./dist/psd2pngs.exe" "./"
./psd2pngs from.psd
```
## 日本語の説明
psd2pngsは、psdファイルをレイヤーの階層構造を維持したままpngファイルに変換し、適切なリネームを行うアプリケーションです。
1ファイルにまとまったWindows用実行ファイル[`psd2pngs.exe`](https://github.com/34j/psd2pngs/releases)も配布しています。
### インストール方法
- [Releases](https://github.com/34j/psd2pngs/releases)から最新のリリースをダウンロードします。
### 使い方
- psdファイルを右クリックし、`プログラムから開く`を使ってこのアプリで開きます。
[](https://github.com/34j/psd2pngs/graphs/contributors)