LyAhn 0ab156d2d9 fix: startup crash, watcher count, timeline date fallback
db.rs:
- Move idx_images_taken_at creation to after ensure_column so it never
  runs against a schema where taken_at doesn't exist yet; this was causing
  a startup panic on any DB that predates Phase 1
- COALESCE(taken_at, created_at) → COALESCE(taken_at, modified_at) since
  created_at is never populated (modified_at is always set)
- Remove dead is_tagging_job_cancelled function (superseded by
  is_tagging_job_processing) and unused thumbnail_path from ImagePathRecord

indexer.rs:
- Watcher create path now calls update_folder_count after commit_batch and
  emits folder-counts-changed so the sidebar count stays in sync; the
  notification is only emitted when the DB write actually succeeds

store.ts / Timeline.tsx:
- compareImages taken_asc/taken_desc: fall back to modified_at not
  created_at (created_at is always null)
- Timeline groupImages: same fallback fix so images group by month
  correctly for libraries not yet re-indexed for EXIF
- subscribeToProgress: listen for folder-counts-changed and call
  loadFolders() to keep the sidebar image count live
2026-06-08 22:09:50 +01:00
2026-04-05 19:12:48 +01:00

Phokus

A local-first desktop media library for browsing, filtering, and curating image and video folders.

Features

  • Add and remove media folders; background indexing with live progress
  • Browse all media or filter by folder, type (image/video), favorites, or star rating
  • Filename search, semantic search (/s query), and tag search (/t tag)
  • Similar image search — find visually similar media by image or selected region
  • AI tagging via WD tagger (ONNX, CPU/DirectML) with confidence threshold control
  • Explore view — visual cluster map and tag cloud for browsing by theme
  • Duplicate finder — scan for exact duplicates by file hash with bulk delete
  • Lightbox preview with keyboard navigation, inline tag editing, and rating controls
  • Sort by date, name, size, rating, or duration
  • Grid density controls (compact / comfortable / detail)

Supported formats

Images Videos
jpg, jpeg, png, gif, bmp mp4, mov, m4v
tiff, tif, webp, avif, heic, heif webm

Stack

  • Tauri 2 + Rust backend
  • React 19 + TypeScript + Zustand
  • SQLite + sqlite-vec (vector search)
  • ONNX Runtime (ort) for AI tagging
  • Candle (Rust ML) for visual embeddings
  • FFmpeg sidecar for video thumbnails and metadata
  • Vite + Tailwind CSS v4

Development

Prerequisites: Node.js 20+, pnpm, Rust toolchain, Tauri system prerequisites for Windows.

pnpm install

# Run with hot-reload (frontend + Rust)
pnpm dev:app

# Frontend only
pnpm dev:vite

# Production build
pnpm build:app

How it works

  1. Add a folder from the sidebar — the Rust indexer walks it recursively.
  2. Supported files are written to SQLite with metadata (path, dimensions, media type, etc.).
  3. Background workers generate thumbnails, compute visual embeddings, and run AI tagging.
  4. Progress events stream back to the UI while the gallery updates incrementally.
  5. Embeddings power semantic search and the similar images feature via an HNSW index.
S
Description
Local-first image gallery with semantic search and AI tagging (Tauri + React + Rust)
Readme MIT 14 MiB
Languages
TypeScript 60.4%
Rust 37.5%
CSS 1.3%
Shell 0.4%
JavaScript 0.2%
Other 0.2%