PhotoShelf Help

Local AI photo search. Fully offline. Your photos never leave your disk.

Getting Started

1. Download and extract PhotoShelf.zip. 2. Run PhotoShelf.exe. 3. Click Add Scan Folder and pick a directory with photos. 4. Wait for AI indexing (first scan takes a few minutes). 5. Type a search query and press Enter.

Search

Type natural language in the search bar: a dog on the beach, sunset mountain, portrait. Press Enter or click Search. Results appear in the grid.

Keyboard Shortcuts (Viewer)

← / → — previous / next photo
F — toggle favorite
R — rotate 90°
P — print
O — open in Explorer
Delete — move to trash
Esc — close viewer

Features

Timeline — browse by year/month.
Tags — filter by AI-generated tags.
People — face clusters by person.
Favorites — star your best photos.
Duplicates — find near-duplicate photos.
Map View — photos with GPS on a map.
Slideshow — full-screen presentation.
Folder Watch — auto-index new files.

Free vs Pro

Free — up to 5,000 photos, all core features.
Pro ($49) — unlimited photos, video frame extraction, face clusters, map view, HTML export.

Data Location

All data (database, thumbnails, config, license) is stored in the data/ folder next to PhotoShelf.exe. Move the whole folder to move your library.

Troubleshooting

No photos showing after scan? Check that the scan folder contains supported formats (JPG, PNG, WebP, HEIC, etc.).
First scan is slow? The CLIP model processes each image once. Subsequent scans only process new files.
Face detection not working? InsightFace models download on first use (internet required once).