Skip to content

Retrieve image metadata using ImageMagick's identify command

License

Notifications You must be signed in to change notification settings

mediapolis/node-im-metadata

 
 

Repository files navigation

im-metadata

Build status NPM downloads NPM version Node version Dependency status

Retrieve image metadata as a JSON object using ImageMagick's identify command.

Requiremets

  • Node.JS v0.10 or newer
  • ImageMagick v6.8 or newer

Install

npm install im-metadata --save

API

var metadata = require('im-metadata');

metadata(string src, object opts, function callback)

Return metadata object for a given src image.

  • string src - path to the image on disk
  • object opts - metadata parsing options
    • boolean exif - return exif data or not (default false)
    • boolean autoOrient - auto-orient height/width (default false)
    • integer timeout - command timeout length (default 5000)
  • function callback - callback function (Error error, object data)
    • Error error - error output if command failed
    • object data - parsed metadata object

Return

Returns an object with parsed metada:

  • string path - original image path
  • string name - original image name
  • string size - image file size in bytes (ex. 4504682)
  • string format - image format (JPEG, PNG, TIFF etc.)
  • string colorspace - image colorspace (RGB, CMYK etc.)
  • integer height - image pixel height
  • integer width - image pixel width
  • string orientation - image orientation

Example

metadata('/path/to/image.jpg', {exif: true}, function(error, metadata) {
  if (error) { console.error(error); }
  console.log(metadata);
  console.log(metadata.exif);
});

About

Retrieve image metadata using ImageMagick's identify command

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%