https://github.com/logbarron/duplicate-image-detector
A tool for finding duplicate and near-duplicate images. Then removing those files using a simple UI.
https://github.com/logbarron/duplicate-image-detector
duplicate-detection image-processing macos python
Last synced: 5 months ago
JSON representation
A tool for finding duplicate and near-duplicate images. Then removing those files using a simple UI.
- Host: GitHub
- URL: https://github.com/logbarron/duplicate-image-detector
- Owner: logbarron
- License: gpl-3.0
- Created: 2025-07-04T01:41:25.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-11-13T20:26:16.000Z (7 months ago)
- Last Synced: 2025-11-13T22:19:35.401Z (7 months ago)
- Topics: duplicate-detection, image-processing, macos, python
- Language: Python
- Homepage:
- Size: 1.33 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Duplicate Image Detector
A tool for finding duplicate and near-duplicate images. Then removing those files using a simple UI.
Read the story on my personal website: [Small Software: Duplicate Detector](https://loganbarron.com/posts/2025-07-21-smallsoftware-duplicates/)
## Get started
```bash
# Install uv package manager
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone repository
git clone https://github.com/logbarron/duplicate-image-detector
cd duplicate-image-detector
# Make script executable
chmod +x duplicate-detector.py
# Run to start
./duplicate-detector.py /path/to/your/images
# Web interface opens at
http://localhost:5555
```
## Image Pipeline
```bash
1. Scan & Find Images (non-recursive)
2. Extract Metadata
3. Generate Neural ML Features
4. Find Similar Pairs
5. Geometric Verification
6. Group Duplicates
7. Web UI Review
```
## Documentation
For detailed technical information, advanced configuration options, and troubleshooting, see [TECHNICAL.md](TECHNICAL.md).
## Important Note
**This tool permanently modifies your photo files**. Selected files for deletion will be deleted. Always maintain backups.
**AI-Assisted Development**: This project was developed with AI language models. While extensively tested, please review the implementation for your specific use case.
## License
[GPL v3](LICENSE) - Copyright © 2025 Logan Barron