Skip to content
A Python Perceptual Image Hashing Module
Python
Branch: master
Clone or download
Pull request Compare This branch is 24 commits behind bunchesofdonald:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
photohash
.gitignore
CHANGES.txt
LICENSE.txt
MANIFEST.in
README.rst
requirements.txt
setup.py

README.rst

PhotoHash

This was mainly created just for my own use and education. It's a perceptual hash algorithm, used to find if two images are similar.

Installation

pip install PhotoHash

Usage

average_hash

Returns the hash of the image using an average hash algorithm. This algorithm compares each pixel in the image to the average value of all the pixels.:

import photohash
hash = photohash.average_hash('/path/to/myimage.jpg')

distance

Returns the hamming distance between the average_hash of the given images.:

import photohash
distance = photohash.distance('/path/to/myimage.jpg', '/path/to/myotherimage.jpg')

is_look_alike

Returns a boolean of whether or not the photos look similar.:

import photohash
similar = photohash.is_look_alike('/path/to/myimage.jpg', '/path/to/myotherimage.jpg')

is_look_alike also takes an optional tolerance argument that defines how strict the comparison should be.:

import photohash
similar = photohash.is_look_alike('/path/to/myimage.jpg', '/path/to/myimage.jpg', tolerance=3)

TODO

  • Add more hash algorithms.
You can’t perform that action at this time.