A Node.js utility for determining the dimensions of an image
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.travis.yml beforeinstall Dec 9, 2013
LICENSE initial commit Apr 16, 2013
package.json canvas as devdep too Dec 9, 2013
test.js initial commit Apr 16, 2013


sz Build Status

Determine the size of an image

Depends on node-canvas which has special build instructions as it requires Cairo to be installed on your system.


  • crp crops images
  • rsz resizes images
  • thmb makes thumbnails from images

API & Example

You may provide either a String specifying the path to the image or a Buffer containing the image data and you will receive an object with 'height' and 'width' properties on your callback

var sz = require('sz')
  , fs = require('fs')

sz('/path/to/nyancat.gif', function (err, size) {
  // where `size` may look like: { height: 280, width: 400 }

var buf = fs.readFileSync('/path/to/nyancat.gif')

sz(buf, function (err, size) {
  // where `size` will be the same as above


sz is Copyright (c) 2013 Rod Vagg @rvagg and licensed under the MIT licence. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.