Skip to main content

Python 3 CLI application for finding visually similar images

Project description

usage: imagedupes [-h] [-a ALGORITHM] [-d DIRECTORY] [-l] [-o OPTIONS]

[-p PROGRAM] [-r] [-s HASH_SIZE]

Finds visually similar images and opens them in the default image file handler, one group of matches at a time. If no options are specified, it defaults to searching the current working directory non-recursively using a perceptual image hash algorithm with a hash size of 8, opens images in the system default image handler (all at once), and does not follow symbolic links.

optional arguments:
-h, --help

show this help message and exit

-a ALGORITHM, --algorithm ALGORITHM

Specify a hash algorithm to use. Acceptable inputs: ‘dhash’ (horizontal difference hash), ‘dhash_vertical’, ‘ahash’ (average hash), ‘phash’ (perceptual hash), ‘phash_simple’, ‘whash_haar’ (Haar wavelet hash), ‘whash_db4’ (Daubechles wavelet hash). Defaults to ‘phash’ if not specified.

-d DIRECTORY, --directory DIRECTORY

Directory to search for images. Defaults to the current working directory if not specified.

-l, --links

Follow symbolic links. Defaults to off if not specified.

-o OPTIONS, --options OPTIONS

Option parameters to pass to the program opened by the –program flag. Defaults to no options if not specified.

-p PROGRAM, --program PROGRAM

Program to open the matched images with. Defaults to your system’s default image handler if not specified.

-r, --recursive

Search through directories recursively. Defaults to off if not specified.

-s HASH_SIZE, --hash_size HASH_SIZE

Resolution of the hash; higher is more sensitive to differences. Must be a power of 2 (2, 4, 8, 16…). Defaults to 8 if not specified. Values lower than 8 may not work with some hash algorithms.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imagedupes-1.0.1.tar.gz (18.1 kB view details)

Uploaded Source

Built Distribution

imagedupes-1.0.1-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file imagedupes-1.0.1.tar.gz.

File metadata

  • Download URL: imagedupes-1.0.1.tar.gz
  • Upload date:
  • Size: 18.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for imagedupes-1.0.1.tar.gz
Algorithm Hash digest
SHA256 b15da6a27d0ceab960ec7a0f2d21ced624b09d7ae001b22135ea55d9cd9367ef
MD5 d10f3d1199109368515bada3aae1b40d
BLAKE2b-256 71213b18bfbf759a99ac099ba5b98869124dedd8d2c98a342572a3a37c0cfd9d

See more details on using hashes here.

File details

Details for the file imagedupes-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for imagedupes-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 11afbac553a261e3bd5dd438830684924ff40505ea77632884471aebd9cbeb74
MD5 71059450f46783e62d4efbdd35cc7819
BLAKE2b-256 61170748034203fddc97710b79cdc31532977e66a3b643264b29c9a97156b347

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page