Photo Selector Documentation

Photo Selector is a state-of-the-art desktop photo curation and triage application engineered for professional photographers and photo editors handling large RAW & JPEG image libraries. Built with a local-first FastAPI backend and a responsive Angular frontend, it turns hours of tedious photo sorting into a fast, fluid, and AI-assisted workflow.

🌟 Key Features

• Multi-View Workspace: Effortlessly toggle between Grid View (batch management), Single View (detail inspection with zoom & pan), and Compare View (side-by-side burst sequence comparison).
• AI-Powered Quality Diagnostics: Automated background analysis for sharpness (Laplacian variance), facial eye detection (open vs. closed eyes), and burst shot deduplication.
• Burst Sequence Clustering: Automatically group similar photos taken in rapid succession and identify the ⭐ Best Shot in each burst.
• Smart Color-Coded Albums: Create custom albums with custom color palettes, set default assignment rules, and filter your workspace by album swatches.
• Nested Directory Export: Export selected photos organized automatically into structured sub-directories (Export_Dir / Project_Name / Album_Name) with live progress telemetry and instant cancellation.
• Instant Project Stats: Preview photo counts, selection progress, and album breakdowns directly from the Recent Projects dashboard without opening the full project.
• Optimized Folder Navigator: Fast drive enumeration with expand-on-demand folder tree browsing and inline + Folder creation.
• Theme & Dual-Language Support: Seamlessly toggle between Dark, Light, and System Default themes across all views, with full English & Kannada (ಕನ್ನಡ) internationalization.
• 100% Local & Private: Operates completely offline on your Windows desktop with no cloud uploads or monthly subscriptions.

📥 Installation & Download

Download the official setup installer: PhotoSelector_Setup.exe

Run PhotoSelector_Setup.exe to install Photo Selector on your Windows machine with desktop shortcuts.

💡 Why Use Photo Selector?

Sorting thousands of high-resolution RAW or JPEG files after a wedding, portrait session, or travel event can cause creative burnout. Photo Selector delivers a zero-latency, keyboard-driven triage environment paired with AI diagnostics so you can select the sharpest, best-composed shots in a fraction of the time.

📖 User Guide

For detailed step-by-step instructions on project setup, AI diagnostics, album exports, and keyboard shortcuts, explore the full User Guide.