Skip to content
/ imgdups Public

Tool to group images from a given folder based on their perceptual hash.

Notifications You must be signed in to change notification settings

zkvL/imgdups

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Image Dups

imgdups groups images from a given folder based on their perceptual hash.

Install & Usage

Once Go is installed and configured, run:

❯❯❯ go install github.com/zkvL/imgdups@latest
❯❯❯ imgdups -h
Usage of imgdups:
  -dir string
        Images folder path
  -quiet
        If true, won't print the moved files (default false)
  -workers int
        Number of workers to run concurrently (default 100)

For a given folder structure containing images, such as:

❯❯❯ tree ss
ss
β”œβ”€β”€ img1.png
β”œβ”€β”€ img2.png
β”œβ”€β”€ img3.png
β”œβ”€β”€ img4.png
[...]

After running imgdups the images will be grouped by its perceptual hash into subfolders for easy review.

❯❯❯ imgdups -dir ss/ -workers 50 -quiet
❯❯❯ tree ss
ss
β”œβ”€β”€ hashed
β”‚Β Β  β”œβ”€β”€ 0000000000000000
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img5.png
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img7.png
β”‚Β Β  β”‚Β Β  └── img3.png
β”‚Β Β  β”œβ”€β”€ 0c08000000000000
β”‚Β Β  β”‚Β Β  └── img6.png
β”‚Β Β  β”œβ”€β”€ c000000000000000
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img8.png
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img10.png
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img2.png
β”‚Β Β  └── f177700000000000
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img9.png
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img1.png
β”‚Β Β  β”‚Β Β  β”œβ”€β”€ img4.png
[...]

About

Tool to group images from a given folder based on their perceptual hash.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages