This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description


Version 0.1.0

Convert one or more PSD files to JPG format. Thumbnail and optimize them, or don’t.

I keep many of the assets I use for web development in PSD format. This lets me perform non-destructive edits and crops in Photoshop and come back to edit the originals later. I built psdtojpg to make it easier to generate, downsize, and optimize JPGs from my asset PSDs.


This is a Python 3 script, so use pip3 to install:

pip3 install psdtojpg

After this, run psdtojpg --help from your terminal to verify it’s installed properly.


Basic Conversion

psdtojpg my_file.psd
  • my_file.psd ➔ Converted/Original/my_file.jpg (original size, default quality: 80)

Downsizing Images

psdtojpg -w 640 -t 480 my_file.psd
  • my_file.psd ➔ Converted/Original/my_file.jpg (original size)
  • my_file.psd ➔ Converted/Resized/my_file.jpg (max size: 640x480 px)

psdtojpg -w 640 -t 480 -n my_file.psd
  • my_file.psd ➔ Converted/Resized/my_file.jpg (max size: 640x480 px)

Quality and Optimization

psdtojpg -q 60 my_file.psd
  • my_file.psd ➔ Converted/Original/my_file.jpg (original size, quality: 60)

psdtojpg -o my_file.psd
  • my_file.psd ➔ Converted/Original/my_file.jpg (original size, optimized with ImageOptim)

Custom Output Folders

psdtojpg -w 800 -t 600 -g orig -r thumb/sm my_file.psd
  • my_file.psd ➔ orig/my_file.jpg (original size)
  • my_file.psd ➔ thumb/sm/my_file.jpg (max size: 800x600 px)


Python 3. (Tested with Python 3.4.1 on Mac OS X 10.9.3.)

Relies on the following packages:

Optional dependencies:

  • For image optimization on OS X: ImageOptim CLI—install with npm install -g imageoptim-cli


Command: psdtojpg --help

usage: psdtojpg [-h] [-w MAX_WIDTH] [-t MAX_HEIGHT] [-q QUALITY] [-o] [-n]
                [-g ORIGINAL_FOLDER] [-r RESIZED_FOLDER]
                psd_file [psd_file ...]

Convert PSD files to JPG images.

positional arguments:
  psd_file              One or more PSD files to be converted

optional arguments:
  -h, --help            show this help message and exit
  -w MAX_WIDTH, --max-width MAX_WIDTH
                        The maximum width of resized output files in pixels.
  -t MAX_HEIGHT, --max-height MAX_HEIGHT
                        The maximum height of resized output files in pixels.
  -q QUALITY, --quality QUALITY
                        The output quality of JPG files. Default is 80.
  -o, --optimize        Optimize output files with ImageOptim after
                        conversion. Requires the imageOptim CLI to be
  -n, --no-originals    Do not output original-size JPGs.
                        The name of the output folder for original-size JPGs.
                        Can be nested.
  -r RESIZED_FOLDER, --resized-folder RESIZED_FOLDER
                        The name of the output folder for resized JPGs. Can be


Bug reports, fixes, or features? Feel free to open an issue or pull request any time. You can also tweet me at mplewis or email me at


Copyright (c) 2014 Matthew Lewis. Licensed under the MIT License.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
psdtojpg-0.1.0-py3-none-any.whl (7.2 kB) Copy SHA256 Checksum SHA256 3.4 Wheel Jul 21, 2014
psdtojpg-0.1.0.tar.gz (4.7 kB) Copy SHA256 Checksum SHA256 Source Jul 21, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting