declutrr 0.1.4

A Date-app-like interface for rapidly sorting photos

🎯 Declutrr

A Date-app-like interface for rapidly sorting photos into "keep" and "delete" categories. Perfect for photographers who need to quickly curate large collections of images.

✨ Features

• 🎨 Simple Interface: Clean, intuitive UI for rapid photo sorting
• 📅 Smart Sorting: Photos displayed in chronological order using EXIF data
• ⌨️ Keyboard Shortcuts: Quick sorting using arrow keys
• ↩️ Undo Support: Easily reverse any sorting decision
• ⏭️ Skip Option: Temporarily skip photos you're unsure about
• 📊 Progress Tracking: Clear status display of sorting progress

🚀 Installation

pip install declutrr

Usage

Launch declutrr from terminal/command line

declutrr

Controls

You can choose between two control schemes:

Arrow Keys (Default)

• → (Right Arrow): Keep photo
• ← (Left Arrow): Delete photo
• ↓ (Down Arrow): Skip photo

Vim-style Keys

• L: Keep photo
• J: Delete photo
• K: Skip photo

Global Controls

• Z: Undo last action
• O: Open new folder
• Q: Quit application
• T: Toggle between Arrow/JKL controls

File Organization

• Kept photos are prefixed with "G_"
• Deleted photos are moved to a "delete" subfolder

📋 Requirements

• 🐍 Python 3.10+
• 🖼️ Pillow (PIL) 11.0.0+

🛠️ Additional Tools

📋 Requirements

• 🐍 Python 3.10+
• 🖼️ Pillow (PIL) 11.0.0+
• 👁️ OpenCV (cv2)
• 🤖 ultralytics (YOLOv11)
• 🎨 tkinter (included with Python)

🏷️ Auto Tagger (scripts/auto_tagger.py)

Automatically tags photos using AI-powered object detection:

• 🤖 Uses YOLOv11 for object detection and classification
• 🎯 Adds Finder tags based on detected content
• 📁 Perfect for organizing photos by content

🔍 Blur Detector (scripts/blur_detector.py)

Identifies and separates blurry photos:

• 📊 Uses Laplacian variance to detect image blur
• 📂 Moves blurry photos to a separate folder
• ✨ Helps maintain photo collection quality

📱 Screenshot Detector (scripts/screenshot_detector.py)

Identifies and organizes screenshots:

• 🤖 Uses AI and traditional CV methods
• 🔍 Detects UI elements and screen contents
• 📂 Separates screenshots from regular photos

🔧 Utility Scripts

• 📅 move.sh: Organizes photos into YYYYMM folders
• ✏️ renamer.sh: Renames photos using EXIF date/time
• 📱 screenshot.sh: Quick screenshot organization

🤝 Contributing

Contributions are welcome! Feel free to submit a pull request or open an issue.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.