node-image-hash

1.1.0 • Public • Published

node-image-hash npm version

Perceptual image hash for node.js

Installation

npm install node-image-hash

Basic usage

const imageHash = require('node-image-hash');

imageHash
  .hash('buffer/or/path/to/file/', 8, 'hex')
  .then((hash) => {
    console.log(hash.hash); // '83c3d381c38985a5'
    console.log(hash.type); // 'blockhash8'
  });

API

.hash(filepath[, bits][, format])

Returns: ES6 Promise, resolved returns hash string in specified format and length (e.g. 83c3d381c38985a5)

Parameters:

  • filepath - path to the image, or Buffer
  • bits (optional) - hash length [default: 64]
  • format (optional) - output format [default: hex] (Available: hex, latin1, base64, binary)
.syncHash(filepath[, bits][, format])

By default, .hash generates new node.js processes to calculate the hash. .syncHash will calculate the hash in the same node.js process (About 2.3x times slower, depending on your CPU)

.close()

Close all underlying workers. If you use the asynchronous hashing algorithm, you need to call this at the end of your program to close all currently open workers. Otherwise, your program may keep running until manually interrupted.

Package Sidebar

Install

npm i node-image-hash

Weekly Downloads

24

Version

1.1.0

License

MIT

Unpacked Size

545 kB

Total Files

20

Last publish

Collaborators

  • niciusb