GitLocker: The Coding Marketplace

Description:

psdtojpg 0.1.0

psdtojpg
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.

Installation
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.

Usage

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)

Requirements
Python 3. (Tested with Python 3.4.1 on Mac OS X 10.9.3.)
Relies on the following packages:

Pillow, the Python 3 PIL fork
psd-tools

Optional dependencies:

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

Help
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
installed.
-n, --no-originals Do not output original-size JPGs.
-g ORIGINAL_FOLDER, --original-folder ORIGINAL_FOLDER
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
nested.

Contributions
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
matt@mplewis.com.

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