Convert PSD to PNG with Node.js

By  on  

Automating and manipulating media is a fascination of mine, partly because I don't understand the magic behind it and partly because the idea of turning one thing into another is fun and useful.  That latest media tool that has piqued my interest is a JavaScript tool called psd.js.

psd.js is a project that allows you to read PSD files, including:

  • Document structure and size
  • Layer/folder size + positioning, names, visibility, and opacity
  • Font data (via psd-enginedata)
    • Text area contents
    • Font names, sizes, and colors
  • Color mode and bit-depth
  • Vector mask data
  • Flattened image data
  • Layer comps

What the media converter and JavaScript lover in me found most awesome was one basic feature: converting a PSD to PNG with JavaScript!

var PSD = require('psd');'homepage.psd').then(function (psd) {
  return psd.image.saveAsPng('homepage.png');
}).then(function () {

That's a nice, tidy API there and I love that it doesn't require anything other than JavaScript (many other Node.js image libraries require ImageMagick on the machine).  Of course converting PSD to PNG is easy with ImageMagick too, but being able to use Node.js instead opens a whole host of opportunity!

Recent Features

  • By
    9 Mind-Blowing Canvas Demos

    The <canvas> element has been a revelation for the visual experts among our ranks.  Canvas provides the means for incredible and efficient animations with the added bonus of no Flash; these developers can flash their awesome JavaScript skills instead.  Here are nine unbelievable canvas demos that...

  • By
    CSS Filters

    CSS filter support recently landed within WebKit nightlies. CSS filters provide a method for modifying the rendering of a basic DOM element, image, or video. CSS filters allow for blurring, warping, and modifying the color intensity of elements. Let's have...

Incredible Demos

  • By
    Assign Anchor IDs Using MooTools 1.2

    One of my favorite uses of the MooTools JavaScript library is the SmoothScroll plugin. I use it on my website, my employer's website, and on many customer websites. The best part about the plugin is that it's so easy to implement. I recently ran...

  • By
    MooTools FontChecker Plugin

    There's a very interesting piece of code on Google Code called FontAvailable which does a jQuery-based JavaScript check on a string to check whether or not your system has a specific font based upon its output width. I've ported this functionality to MooTools. The MooTools...


  1. Simon

    Wow I have been thrilled to learn about this cool feature and implemented a small Node binary to deal with PSD files

    For those running Linux/Mac who are tired of opening a VM and/or cracking Photoshop just to be able to see the new web design you need to integrate… Just install this module :

    npm install -g psd-cli

    You are then ready to see the real rendered PSD in a PNG file, without lousy Gimp changes by typing :

    psd my-file.psd -o

    Link to the NPM package :

  2. Thanks for the shout out David! I know you’re primarily focused on Javascript, but for completeness sake I figured I would mention that the Ruby version of the library is currently more feature complete:

    I am planning on porting the rest of the features in the Ruby library to the JS version in the near future though!

  3. This is super! just been looking at jspdf also, Great what can be done on the client side these days.

  4. Doron

    Ryan, it’d be cool to see feature parity with the Ruby version! I wonder how much support is currently provided for working with PSD layers, e.g. applying transformations such as shadows and overlays (See: for examples).

Wrap your code in <pre class="{language}"></pre> tags, link to a GitHub gist, JSFiddle fiddle, or CodePen pen to embed!