Smriti Manual

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

User guide

• Importing Google Photos — migrate a Google Takeout export directly from its ZIP files.

• 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. tags.

Privacy and data

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