node package manager


Bindings for node.js to pHash


node-pash is pHash bindings for node.js.

Phash is a library that will create a "perceptual hash" of media files, so similar files will return similar hashes. Typically to compare hashes, a simple Hamming distance between the two hashes is a good indicator of how similar two media files are.

Current version supports only image hashing. (no video & audio hashing)

node-phash depends on CImg, pHash, ImageMagicK.

On Ubuntu:

sudo apt-get install cimg-dev libphash0-dev libmagickcore-dev


brew install phash imagemagick

Then, install using npm:

$ npm install phash
// asynchronous hash 
imageHash(filename, function(err, hash));
// synchronous hash 
var hash = imageHashSync(filename);
hammingDistance(hash1, hash2);
var pHash = require("phash");
pHash.imageHash("file.jpg", function(err, hash) {
    if (err) {
        throw err;
    // hash is the pHash of file.jpg 
var hashA = pHash.imageHashSync("a.jpg");
var hashB = pHash.imageHashSync("b.png");
var hammingAB = pHash.hammingDistance(hashA,hashB);
console.log("Hamming Distance A -> B: " + hammingAB);