ImageHash
A image hashing library written in Python. ImageHash supports:
average hashing (aHash)
perception hashing (pHash)
difference hashing (dHash)
wavelet hashing (wHash)
Rationale
Why can’t we use md5, sha-1, etc.?
Unfortunately, we cannot use cryptographic hashing algorithms in our implementation. Due to the nature of cryptographic hashing algorithms, very tiny changes in the input file will result in a substantially different hash. In the case of image fingerprinting, we actually want our similar inputs to have similar output hashes as well.
Requirements
Based on PIL/Pillow Image, numpy and scipy.fftpack (for pHash) Easy installation through pypi.
Basic usage
>>> from PIL import Image
>>> import imagehash
>>> hash = imagehash.average_hash(Image.open('test.png'))
>>> print(hash)
d879f8f89b1bbf
>>> otherhash = imagehash.average_hash(Image.open('other.bmp'))
>>> print(otherhash)
ffff3720200ffff
>>> print(hash == otherhash)
False
>>> print(hash - otherhash)
36
The demo script find_similar_images illustrates how to find similar images in a directory.
Source hosted at github: https://github.com/JohannesBuchner/imagehash
Changelog
3.5: image data handling speed-up
3.2: whash now also handles smaller-than-hash images
- 3.0: dhash had a bug: It computed pixel differences vertically, not horizontally.
I modified it to follow dHash. The old function is available as dhash_vertical.
2.0: added whash
1.0: initial ahash, dhash, phash implementations.
Metadata
Release files for ImageHash 3.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ImageHash-3.5.tar.gz | 294.6 kB | Without provenance | Details for ImageHash-3.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ImageHash-3.5-py2.7.egg | Legacy Egg format | - | - | Details for ImageHash-3.5-py2.7.egg |
Total release size: 595.2 kB
Release files / ImageHash-3.5.tar.gz
| Download URL | ImageHash-3.5.tar.gz |
|---|---|
| Size | 294.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5b78812a78109b7cfdc0c4d92b15a24416d8af27e3f915db1b83f074dc5ec912
|
|
BLAKE2b-256 checksum How to use checksums |
4f2b39e13c004a745a130da64a07940c277320687cd3d3534f6b5fabac5ef6ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / ImageHash-3.5-py2.7.egg
| Download URL | ImageHash-3.5-py2.7.egg |
|---|---|
| Size | 300.6 kB |
| Tags | Egg |
|
SHA-256 checksum How to use checksums |
959248dc766acce97a4ee18300ce4c56bf49b55b8ad16efb09c30c44abf60456
|
|
BLAKE2b-256 checksum How to use checksums |
0660d840f929be0e7b9b1d771c552ddd81046b57725b2cedbf03036ec55239ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for ImageHash 3.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.