A terminal-based photo manager with AI-powered features. Browse, organize, and catalog your photo collection from the command line.
- File Browser - Three-pane vim-style navigation with image previews
- Photo Scanning - EXIF extraction, thumbnails, and metadata indexing
- Duplicate Detection - Find exact and visually similar duplicates
- AI Descriptions - Generate descriptions via local or cloud LLMs
- Face Recognition - Detect, cluster, and name people in photos
- Semantic Search - Find photos by natural language descriptions
- File Operations - Move, rename, rotate, and trash with undo
- Gallery & Slideshow - Visual browsing modes
Browse photos in a grid layout with keyboard navigation and batch selection.
Generate detailed image descriptions using local or cloud LLMs.
Index photos to extract EXIF metadata, generate thumbnails, and enable search.
Quick reference for all keyboard shortcuts, organized by category.
# Build from source (SQLite)
cargo build --release
./target/release/clepho
# Build with PostgreSQL support
cargo build --release --features postgres
# Or run directly with Nix (no install)
nix run github:barrulus/clepho
# Or install with Nix
nix profile install github:barrulus/clephoNavigate with h/j/k/l, press s to scan, ? for help.
See docs/installation.md for NixOS configuration and other install methods.
Clepho uses Yazi-compatible keybindings:
| Key | Action | Key | Action |
|---|---|---|---|
h/j/k/l |
Navigate | y/x |
Cut |
d |
Trash | p |
Paste |
r |
Rename | . |
Toggle hidden |
s |
Scan | u |
Duplicates |
i |
AI describe | / |
Search |
? |
Help | q |
Quit |
See docs/keyboard-shortcuts.md for complete reference.
cp config.example.toml ~/.config/clepho/config.tomlSee config.example.toml for all options or docs/configuration.md for detailed documentation.
| Topic | Description |
|---|---|
| Installation | Build requirements and setup |
| Running | TUI and daemon setup, systemd, NixOS |
| Navigation | File browser and preview pane |
| Scanning | Photo indexing and metadata |
| Duplicates | Finding and managing duplicates |
| AI Features | LLM descriptions and CLIP search |
| Faces | Face detection and people |
| File Operations | Move, rename, and organize |
| Centralise | Organize photos into library |
| Database | SQLite, PostgreSQL, and migration |
| Keyboard Shortcuts | Complete keybinding reference |
GPL-3.0
