Smriti Manual

The full user guide and contributor reference for Smriti, the offline photo library.

User guide

• Getting Started — first run, picking a library, where data lives.
• Indexing Photos — what scanning does, what it skips, how to refresh.
• Timeline — the main view, navigation, keyboard shortcuts.
• People and Faces — face detection, naming, merging, reviewing.
• Albums — manual albums and suggested trips / events.
• Memories — “this day, N years ago” cards.
• Map View — geographic exploration and tile caching.
• Insights — heatmaps, top people, top locations.
• Search — query syntax and examples.
• Cleanup — duplicates, bursts, and the trash workflow.
• Settings — every preference and what it changes.
• Keyboard Shortcuts — full list.
• FAQ — quick answers to common questions.
• Troubleshooting — common issues and fixes.

For contributors

• Build from Source — toolchain setup per OS.
• Architecture Overview — the three-crate split: engine, Tauri shell, frontend.
• Database — schema and migration model.
• Services — domain workflows.
• ML Pipeline — face detection + embedding + clustering.
• Face GPU Bridge — opt-in remote GPU acceleration.
• Testing — the test pyramid and what’s enforced in CI.
• Future Scope — open items, complexity, skill tags.

Privacy and data

• Privacy policy — every outbound HTTP request, enumerated.
• Security — private vulnerability disclosure.
• Third-party licenses — full attribution list.