AI Photo Trainer PhotoRater

Rating Workflow

Master the core workflow for rating photos, analyzing quality metrics, and managing your photo collection with AI-powered insights.

Rating Individual Photos

The primary function of the AI Photo Trainer is to analyze and rate individual photos. Here's how to rate a new image:

Manual Rating Process

  1. Navigate to the Images view from the sidebar
  2. Click the "Rate New Image" button
  3. Browse and select a photo from your computer (supported formats: JPG, JPEG, PNG)
  4. Wait 5-10 seconds while the AI analyzes the image
  5. The image appears in the grid with its quality rating

[IMAGE: Rate New Image Button]

Images view showing "Rate New Image" button

Rate new image button in Images view

Pro Tip: For faster bulk analysis, use Hot Folder Monitoring to automatically rate photos as they're added to a watched folder.

What Gets Analyzed

Each photo is analyzed using multiple AI models to provide comprehensive quality assessment:

Metric Description
Quality Rating Overall score from 0-10 based on all analysis factors
Brightness Lighting level (0-255 scale)
Contrast Dynamic range between light and dark areas
Blur Score Sharpness and focus quality measurement
Smile Detection Facial expression analysis
Eye Detection Open, closed, or blinking eyes
Glasses Detection Presence of eyeglasses and reflections
Pose Analysis Head tilt, shoulder angles, and body positioning
Exposure Problems Detection of over-exposed or under-exposed areas
Glare Issues Reflections, lens flare, and hot spots

Viewing Photo Details

Click any photo thumbnail in the grid to open the detailed analysis view.

[IMAGE: Photo Grid with Quality Ratings]

Grid of photos showing quality badges

Photo grid displaying quality ratings

Quality Rating Badge

Each photo displays a colored badge indicating its quality level:

  • Green (9-10): Excellent quality
  • Blue (7-8.9): Good quality
  • Yellow (5-6.9): Fair quality
  • Red (<5): Poor quality

Detail Panel Sections

The photo detail panel is organized into five sections:

  1. Overview

    • Overall quality rating
    • Image dimensions
    • File size
    • Analysis timestamp

  2. Technical Metrics

    • Brightness level
    • Contrast ratio
    • Blur/sharpness score
    • Color balance

  3. Facial Analysis

    • Smile detection results
    • Eye state (open/closed)
    • Glasses presence and glare
    • Pose angle measurements

  4. Quality Issues

    • ⚠️ Warning flags for detected problems
    • Exposure issues (over/under)
    • Glare and reflection problems
    • Focus/blur issues

  5. Recommendations

    • Suggested improvements
    • Technical advice
    • Best practices

[IMAGE: Photo Detail Panel]

Detailed analysis panel showing all metrics

Detailed photo analysis with quality metrics

Pose Profile: The detail view shows which pose profile was used for analysis. Different profiles weight factors differently. See Pose Profile Selector for details.

Advanced Detection Controls

Available in v0.11.2+ — The Advanced Detection Controls allow you to selectively re-analyze specific images with different detection settings without changing global settings.

The Detection button appears in the Images view toolbar, next to the Pose Profile Selector.

Using Detection Toggles

To adjust detection settings for a specific image:

  1. Select an image in the grid view
  2. Click the "Detection" button in the toolbar
  3. A dropdown menu appears with two toggle options:
    • Background Analysis: Analyzes background clutter and distractions
    • Object Detection: Detects unwanted objects in the frame
  4. Toggle features on or off as desired
  5. Click "Re-analyze Image" to apply changes
  6. The image is re-processed with your selected settings

[IMAGE: Detection Toggles Dropdown]

Dropdown showing Background Analysis and Object Detection toggles

Advanced Detection Controls dropdown menu

Visual Indicators

The Detection button icon changes color based on enabled features:

Icon State Color Meaning
Eye Icon Green Both features enabled
Eye Icon Yellow One feature enabled
Eye Slash Icon Red Both features disabled

Within the dropdown, each toggle shows:

  • Green CheckCircle: Feature is enabled
  • Red XCircle: Feature is disabled

Common Use Cases

1. Troubleshooting Unexpected Ratings

Scenario:

You expect a photo to rate 8.0+ but it's showing 6.5

Solution:

  1. Select the photo
  2. Open Detection controls
  3. Disable "Object Detection"
  4. Click "Re-analyze Image"
  5. If rating improves significantly, object detection may have a false positive

2. A/B Testing Detection Impact

Scenario:

You want to see how background analysis affects a specific photo's rating

Workflow:

  1. Select a photo with a cluttered background
  2. Note the current rating (e.g., 7.2)
  3. Disable "Background Analysis" and re-analyze
  4. Compare the new rating (e.g., 8.0)
  5. Re-enable to confirm the difference

3. Speed Optimization

Scenario:

You need to process 500 images quickly and only need detailed analysis on select photos

Workflow:

  1. Go to Settings → Advanced Detection
  2. Disable both features globally
  3. Process all 500 images (saves ~125ms per image = 62.5 seconds total)
  4. Use Detection toggles to selectively re-analyze specific images with features enabled

Performance Impact

Setting Time Saved
Background Analysis disabled ~50ms per image
Object Detection disabled ~75ms per image
Both disabled ~125ms per image

Settings Update: When you use Detection toggles, the global settings are updated temporarily. To permanently configure these features, visit Settings & Thresholds.

Providing Feedback on Detections

Available in v0.11.1+ — You can help improve PhotoRater AI accuracy by providing feedback on detection results.

How to Provide Feedback

When viewing photo details, you'll see thumbs up/down buttons below each detection result:

  1. Open a photo in the Detail view
  2. Scroll to the detection results section
  3. For each detection (Pose, Eyes, Glare, Smile, Blur), you'll see two buttons:
    • Thumbs Up (Purple): Click if the AI detection was correct
    • Thumbs Down (Red): Click if the AI detection was incorrect
  4. Once clicked, the button becomes disabled (one submission per detection)

[IMAGE: Feedback Buttons Below Detection]

Thumbs up/down buttons for providing feedback

Feedback buttons in Image Detail view

What You Can Provide Feedback On

Detection Type What It Detects
Pose Detection Head angle, shoulder angle, body positioning
Eyes Detection Open, closed, or blinking eyes
Glare Detection Glasses glare and reflections
Smile Detection Facial expression and smile presence
Blur Detection Sharpness and focus quality

Viewing Your Feedback

After providing feedback, you can review it in the Session Feedback view:

  • Navigate to Feedback in the sidebar (purple thumbs-up icon)
  • See accuracy charts for each detection type
  • View all photos where you provided feedback
  • Track how well PhotoRater AI is performing in your session

Completely Optional: Feedback is entirely optional and doesn't affect photo ratings. You can rate photos normally without using feedback buttons. See Session Feedback for complete details.

Searching & Filtering

Search Bar

Use the search bar at the top of the Images view to quickly find photos:

  • Search by filename
  • Real-time filtering as you type
  • Case-insensitive matching

Filter Options (Coming Soon)

Advanced filtering capabilities are planned for future releases:

  • Quality Range: Show only photos rated 8-10, for example
  • Date Range: Filter by analysis date
  • Issue Status: Show only photos with issues or only clean photos
  • Problem Types: Filter by specific issues (blur, glare, exposure, etc.)
  • Pose Profile: Show photos analyzed with a specific profile

Exporting Data

Export your photo analysis data for reporting, record-keeping, or further analysis.

Export Process

  1. Navigate to the Statistics view
  2. Click the "Export" button
  3. Choose your export format:
    • CSV: Excel-compatible spreadsheet format
    • JSON: Raw structured data for developers
    • Excel: Formatted XLSX file with charts and formatting
  4. Select destination folder
  5. Data exports instantly

What Gets Exported

The export includes comprehensive data for all analyzed photos:

  • All photo metadata (filename, path, dimensions, file size)
  • Quality ratings and individual scores
  • All technical measurements (brightness, contrast, blur, etc.)
  • Issue flags and detailed descriptions
  • Analysis timestamps
  • Pose profile information
  • Photographer session data (if applicable)

Google Drive Integration (Optional)

For cloud-based storage, you can export directly to Google Drive:

  1. Select "Export to Google Drive" option
  2. Sign in with your Google account if not already authenticated
  3. Select or create a folder in Google Drive
  4. The file auto-uploads after export completes

Privacy Note: Google Drive integration requires granting the application access to your Drive. Your data is uploaded directly and is not stored on our servers. You can revoke access at any time from your Google account settings.

Next Steps