Skip to content

SuperAugust09/Photo-Auto-Rater

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

📷 Photo Auto-Rater

Automatically grade and sort your photos by quality and subject — entirely on your own PC.

Windows License Version


✨ Features

  • Automatic star rating (1–5 ★) based on sharpness, exposure and composition
  • AI subject sorting — copies photos into folders like People, Vehicles, Nature etc.
  • Works with RAW files — CR2, CR3, NEF, ARW, ORF, DNG, RW2 and more
  • 100% private — your photos never leave your computer
  • Pause & resume — stop analysis and pick up where you left off
  • Save progress — close the app and continue in a new session
  • Sort & filter results by rating, sharpness, exposure or composition

🚀 Getting Started

1. Download the app

Go to the Releases page and download PhotoRater.zip.

Unzip it — your folder should look like this:

PhotoRater\
    PhotoRater.exe
    README.txt
    exiftool-13.58_64\
        exiftool.exe
        exiftool_files\

2. Install Ollama (for AI subject sorting)

Ollama runs the AI model locally on your PC. Your photos never leave your computer.

  1. Download and install from https://ollama.com
  2. Open PowerShell and run:
    ollama pull llava
    This downloads the LLaVA vision model (~4.7 GB). You only need to do this once.

3. Run the app

Double-click PhotoRater.exe and you're ready to go!


🖥️ How to Use

Button What it does
Browse Pick your photo folder
▶ Analyse Start grading all photos
⏸ Pause / Resume Pause and continue at any time
💾 Save Progress Save and continue later
✅ Save Ratings to Files Write XMP star ratings into photo metadata
📁 Sort into Folders Use AI to copy photos into subject folders
🔄 Reset Clear results and start fresh

⭐ How the Rating Works

Each photo is scored on three criteria:

Criteria Weight What it measures
Sharpness 40% Laplacian edge variance — blurry photos score low
Exposure 35% Mid-tone brightness, contrast, penalises clipping
Composition 25% Rule-of-thirds edge distribution

The scores are combined into a 1–5 star rating and written as XMP:Rating metadata — compatible with Lightroom, Capture One, Windows Photos and macOS Finder.


📁 Subject Categories

The AI sorting feature uses Ollama LLaVA to look at each photo and copy it into the best matching folder:

  • 🐾 Animals
  • 👥 People
  • 🌿 Nature / Landscape
  • 🏛️ Buildings / Architecture
  • 🍕 Food
  • 🚌 Vehicles
  • 🏙️ Street / Urban
  • ⚽ Sport
  • 📦 Other

Originals are never moved or deleted — only copies are made.


📋 Requirements

  • Windows 10 or 11 (64-bit)
  • Ollama with LLaVA model (for subject sorting only)
  • ExifTool (included in the download)
  • ~500 MB disk space for the app
  • ~5 GB disk space for the Ollama LLaVA model

🛠️ Built With


📄 License

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


🙋 Issues & Feedback

Found a bug or have a suggestion? Open an issue and I'll take a look!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages