How viozenium/imgtoolkit works
ImgToolkit is a cross-platform Tkinter desktop suite for finding similar images, reviewing matches, converting images to JPG, and consulting an integrated manual. The main workflow is to launch Finder, scan a folder with CLIP embeddings and FAISS, save matching pairs, then review those pairs and move selected files. Conversion and help are separate capabilities. Source excerpts show the Finder and Reviewer interfaces and core operations; some launcher wiring and workflow links are documented only in the README.
Main entry points: launcher.py Launcher · theme.py Shared theme · reviewer_core.py Review and file operations · finder.py Finder UI
Components 14
Launch and shared UI
- Launcher
launcher.py - Shared theme
theme.py - About window
info.py - User manual
manual.py
Similarity search
- Finder UI
finder.py - CLIP and FAISS search
finder_core.py - Pair results file
Pair review
- Reviewer UI
reviewer.py - Review and file operations
reviewer_core.py - Review state file
- Duplicate folder
Image conversion
- Converter UI
converter.py - JPG conversion
converter_core.py
Other components
- User
Connections 19
- User → Launcher: opens
README.md - Launcher → Finder UI: launches
README.md - Launcher → Reviewer UI: launches
README.md - Launcher → Converter UI: launches
README.md - Launcher → User manual: opens
README.md - Launcher → About window: opens
launcher.py - Finder UI → CLIP and FAISS search: calls
finder.py - CLIP and FAISS search → Pair results file: writes pairs
README.md - Pair results file → Review and file operations: provides pairs
README.md - Reviewer UI → Review and file operations: calls
reviewer.py - Review and file operations → Review state file: saves decisions
reviewer_core.py - Review and file operations → Duplicate folder: moves images
reviewer_core.py - Converter UI → JPG conversion: calls
converter.py - Finder UI → Shared theme: uses styles
finder.py - Reviewer UI → Shared theme: uses styles
reviewer.py - Converter UI → Shared theme: uses styles
converter.py - Launcher → Shared theme: uses styles
launcher.py - About window → Shared theme: uses styles
info.py - User manual → Shared theme: uses styles
README.md