{"id":20789551,"url":"https://github.com/victorqribeiro/groupimg","last_synced_at":"2025-04-09T09:09:39.520Z","repository":{"id":40976581,"uuid":"153881661","full_name":"victorqribeiro/groupImg","owner":"victorqribeiro","description":"A script in python to organize your images by similarity.","archived":false,"fork":false,"pushed_at":"2024-05-20T03:43:43.000Z","size":90,"stargazers_count":237,"open_issues_count":2,"forks_count":36,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-02T07:09:51.609Z","etag":null,"topics":["image-classification","image-comparison","k-means","machine-learning-algorithms","python","script"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/victorqribeiro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"victorqribeiro"}},"created_at":"2018-10-20T07:39:09.000Z","updated_at":"2025-03-18T08:02:00.000Z","dependencies_parsed_at":"2024-02-21T16:12:51.706Z","dependency_job_id":"05cdc1e8-bc34-4777-acf7-f1c204f9f700","html_url":"https://github.com/victorqribeiro/groupImg","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorqribeiro%2FgroupImg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorqribeiro%2FgroupImg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorqribeiro%2FgroupImg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorqribeiro%2FgroupImg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/victorqribeiro","download_url":"https://codeload.github.com/victorqribeiro/groupImg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248008630,"owners_count":21032556,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image-classification","image-comparison","k-means","machine-learning-algorithms","python","script"],"created_at":"2024-11-17T15:24:53.483Z","updated_at":"2025-04-09T09:09:39.503Z","avatar_url":"https://github.com/victorqribeiro.png","language":"Python","funding_links":["https://patreon.com/victorqribeiro","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=victorqribeiro%40gmail%2ecom\u0026lc=BR\u0026item_name=Victor%20Ribeiro\u0026item_number=donation\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted"],"categories":[],"sub_categories":[],"readme":"# groupImg\n\nA python script to organize your images by similarity.\n\nIt uses a [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithm to separatem them in clusters.\n\nWatch it working below.\n\n[![groupImg](http://img.youtube.com/vi/M6ntIaynKCg/0.jpg)](http://www.youtube.com/watch?v=M6ntIaynKCg)\n\n## Why ?\n\nIt was about one year since I made the switch from Windows to Linux, and I wanted to get better at the terminal. I always thought it was cool to master it. To make a long story short, one day I did mount a linux image on my external backup drive instead of the pen drive. Some basic */dev/sd\\** confusion. Anyway's, I overwrited all my photos; so I used [Foremost](https://en.wikipedia.org/wiki/Foremost_(software)) (which is a great tool) to recover them. It recovered 350.000 images; miniatures, textures, profile pictures, wallpapers... and among all that my personal photos. So I wrote a little script to divide the images in folders, 1000 images per folder, if I'm not mistaken. I went through all the folders separating my photos from the random images that weren't important. To end the story, I came up with this script to \"cluster\" the photos by similiraty and makes things a little easier for me.\n\n## How to use\n\nNavigate to the folder you want. CLI - Command Line Interface or GUI - Graphic User Interface\n\nInstall the requirements.txt\n\n```\npip install -r requirements.txt\n```\n\n### CLI\n\nCall the script passing the image folder you want to organize.\n\n```\npython groupimg.py -f /home/user/Pictures/\n```\n\n## Parameters\n\n\\-f folder where your images are (use absolute path).\n```groupimg -f /home/user/Pictures```\n\n\\-k number of folders you want to separate your images. \n```groupimg -f /home/user/Pictures -k 5```\n\n\\-m if you want to move your images instead of just copy them.\n\n\\-s if you want the algorithm to consider the size of the images as a feature.\n\n### GUI\n\n![groupImgGUI](screenshot-GUI.png)\n\nJust call the groupImgGUI.py file.\n\n```\npython groupImgGUI.py\n```\n\nClick the button Select folder to select the folder with the pictures you want to organize.\n\nYou can adjust the settings by checking the settings box.\n\nN. Group - How many groups should the images be separated in.\n\nResample - Size to resample the image before comparing (small sizes gives fast results).\n\nMove - Move the images instead of copy them (useful if you have low space on your hard drive).\n\nSize - Consider the size of the images to organize them (useful if you want to separate thumbnails from real pictures).\n\n[![Donations](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=victorqribeiro%40gmail%2ecom\u0026lc=BR\u0026item_name=Victor%20Ribeiro\u0026item_number=donation\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorqribeiro%2Fgroupimg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictorqribeiro%2Fgroupimg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorqribeiro%2Fgroupimg/lists"}