GitHub Project

spyphotoclean

Εφαρμογή desktop για τον εντοπισμό και την εκκαθάριση παρόμοιων ή διπλότυπων φωτογραφιών.

spyphotoclean Screenshot

📖 Τεκμηρίωση (README)

🔍 SpyPhotoClean

Εντοπισμός και εκκαθάριση παρόμοιων φωτογραφιών

Το SpyPhotoClean είναι μια desktop εφαρμογή για Windows που εντοπίζει οπτικά παρόμοιες
ή διπλότυπες φωτογραφίες σε έναν φάκελο (και τους υποφακέλους του), τις ομαδοποιεί
και σας επιτρέπει να τις διαγράψετε με ασφάλεια — μέσω παραθύρου επιβεβαίωσης.

Χρησιμοποιεί τον αλγόριθμο perceptual hashing (pHash), ο οποίος συγκρίνει
φωτογραφίες βάσει οπτικής ομοιότητας και όχι βάσει ονόματος αρχείου ή μεγέθους.


📋 Δυνατότητες

  • Αναδρομική σάρωση φακέλου και υποφακέλων
  • Υποστηριζόμενοι τύποι: JPG, JPEG, PNG, GIF, BMP, TIFF, WebP
  • Ρυθμιζόμενο κατώφλι ομοιότητας (0–30)
  • Προεπισκόπηση thumbnails με πληροφορίες αρχείου (μέγεθος, διαστάσεις, φάκελος)
  • Άνοιγμα φωτογραφίας στην προεπιλεγμένη εφαρμογή προβολής
  • Οριστική διαγραφή με παράθυρο επιβεβαίωσης
  • Real-time ενημέρωση μπάρας προόδου κατά τη σάρωση
  • Ακύρωση σάρωσης ανά πάσα στιγμή

🚀 Εκτέλεση

Ως εκτελέσιμο (.exe)

Αν έχετε το αρχείο SpyPhotoClean.exe, απλά κάντε διπλό κλικ. Δεν χρειάζεται
εγκατάσταση Python ή οτιδήποτε άλλο.

🎯 Οδηγίες Χρήσης

1. Επιλογή Φακέλου

  • Πληκτρολογήστε ή επικολλήστε τη διαδρομή του φακέλου στο πεδίο κειμένου.
  • Πατήστε το εικονίδιο 📁 για να επιλέξετε φάκελο μέσω διαλόγου Windows.
  • Πατήστε το εικονίδιο 🔗 για να ανοίξετε τον φάκελο στον Windows Explorer.

2. Ρύθμιση Συντελεστή Ομοιότητας

Χρησιμοποιήστε το slider για να ρυθμίσετε πόσο «αυστηρή» θα είναι η σύγκριση:

Τιμή Περιγραφή
0 Μόνο πανομοιότυπα αρχεία
1–9 Σχεδόν πανομοιότυπα
10–19 Πολύ παρόμοια (Προτεινόμενο)
20+ Χαλαρό φιλτράρισμα (πιθανά λάθη)

3. Σάρωση

Πατήστε «Έναρξη Αναζήτησης». Η εφαρμογή θα:
1. Εντοπίσει όλες τις εικόνες στον φάκελο (αναδρομικά)
2. Υπολογίσει το perceptual hash κάθε εικόνας
3. Συγκρίνει τα hashes μεταξύ τους
4. Εμφανίσει τις ομάδες παρόμοιων φωτογραφιών

4. Διαχείριση Αποτελεσμάτων

  • 👁️ Προβολή: Ανοίγει τη φωτογραφία σε πλήρη ανάλυση
  • 🗑️ Διαγραφή: Διαγράφει οριστικά το αρχείο (με επιβεβαίωση)

⚠️ Προσοχή: Η διαγραφή είναι μόνιμη — τα αρχεία δεν πηγαίνουν στον Κάδο Ανακύκλωσης.


🔧 Αντιμετώπιση Προβλημάτων

Η εφαρμογή δεν εμφανίζει αποτελέσματα

Βεβαιωθείτε ότι ο φάκελος περιέχει εικόνες σε υποστηριζόμενες μορφές
(JPG, PNG, GIF, BMP, TIFF, WebP).


📦 Εξαρτήσεις

Βιβλιοθήκη Χρήση
flet UI Framework (desktop εφαρμογή)
Pillow Επεξεργασία εικόνας & thumbnails
imagehash Υπολογισμός perceptual hash (pHash)

Ανάπτυξη: 2026 — Python & Flet

📂 Δομή Κώδικα & Αρχείων

📄 .gitignore
📄 README.md
📄 SpyPhotoClean.spec
📁 assets
  📄 icon.ico
  📄 icon.png
  📄 splash.png
📄 main.py

🚀 Εκδόσεις & Releases

🏷️ v1.1.1
Published: 16 Jul 2026, 21:05

Release v1.1.1 – Πρώτη δημόσια έκδοση για τον εντοπισμό και την εκκαθάριση παρόμοιων φωτογραφιών.

Assets: