Metadata-Version: 2.0
Name: imagedupes
Version: 1.2.8
Summary: Python 3 CLI application for finding visually similar images
Home-page: https://github.com/ghemsley/imagedupes
Author: Graham Hemsley
Author-email: ghemsley@protonmail.ch
License: GPL3+
Keywords: image search deduplication
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Multimedia :: Graphics
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: ImageHash
Requires-Dist: Pillow
Requires-Dist: rawpy
Requires-Dist: imageio

==========
imagedupes
==========
--------------------------------------------------------
Python 3 application for finding visually similar images
--------------------------------------------------------
usage: imagedupes [-h] [-a ALGORITHM] [-d DIRECTORY] [-D DATABASE] [-l]
                   [-o OPTIONS] [-p PROGRAM] [-r] [-R] [-s HASH_SIZE]

Finds visually similar images and opens them in an image viewer, 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 members of a group of matches at once), and does not follow
symbolic links or use a persistent database.

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.
  -D DATABASE, --database DATABASE
                        Use a database to cache hash results and speed up hash
                        comparisons. Argument should be the path to which you
                        want to save or read from the database. Warning:
                        runnning the program multiple times with the same
                        database but a different hash algorithm (or different
                        hash size) will lead to missed matches. Defaults to no
                        database 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.
  -R, --raws            Process and hash raw image files. Note: Very slow. You
                        might want to leave it running overnight for large
                        image sets. Using the --database option in tandem is
                        highly recommended. Defaults to off if not specified.
  -s HASH_SIZE, --hash_size HASH_SIZE
                        Resolution of the hash; higher is more sensitive to
                        differences. Some hash algorithms require that it be a
                        power of 2 (2, 4, 8, 16...) so using a power of two is
                        recommended. Defaults to 8 if not specified. Values
                        lower than 8 may not work with some hash algorithms.


