Automatically organize screenshots from a directory into date-based folders.

This CLI tool scans a directory for screenshot files and organizes them into folders based on their creation/modification date. It identifies screenshots based on common naming patterns and file extensions.

• 🔍 Smart Detection: Automatically identifies screenshots based on common naming patterns
• 📅 Date-Based Organization: Organizes files into folders by date (YYYY-MM-DD format)
• 🔄 Duplicate Handling: Automatically handles duplicate filenames
• 👁️ Dry Run Mode: Preview changes before moving files
• 🎯 Flexible Destination: Specify custom destination directory or use default
• 📊 Progress Feedback: Shows what's being moved in real-time

The tool recognizes files with these patterns in their names:

• screenshot
• screen shot or screen_shot
• capture
• scr_ followed by numbers
• img_ followed by numbers

• .png
• .jpg / .jpeg
• .gif
• .bmp
• .tiff
• .webp

python auto_screenshot_organizer.py /path/to/screenshots

This will create a Screenshots_Organized folder in the source directory and organize all screenshots by date.

python auto_screenshot_organizer.py /path/to/screenshots -d /path/to/destination

python auto_screenshot_organizer.py /path/to/screenshots --dry-run

This shows what would be moved without actually moving any files.

python auto_screenshot_organizer.py ~/Downloads

python auto_screenshot_organizer.py ~/Desktop -d ~/Pictures/Screenshots

python auto_screenshot_organizer.py ~/Desktop --dry-run

The tool creates a folder structure like this:

Screenshots_Organized/
├── 2024-10-15/
│   ├── screenshot_001.png
│   └── screen_capture_01.jpg
├── 2024-10-16/
│   └── screenshot_002.png
└── 2024-10-18/
    └── screen_shot_2024.png

• Python 3.6+
• No external dependencies (uses only standard library)

1. Download the script
2. Make it executable (optional):

   chmod +x auto_screenshot_organizer.py

Feel free to submit issues or pull requests for improvements!

This project is open source and available for anyone to use and modify.