Settings

AI & Models

Ollama Connection

Ollama Host URL

Vision Model (required) Analyses photos, generates descriptions, and suggests filenames. Must support image input.

Text LLM for Search (optional) Enables natural-language search queries. Without this, search uses basic keyword matching.

Processing Modes

Catalogue Mode AI-catalogue only — no file renaming or XMP sidecar writing to disk

Rename Files AI-powered descriptive file renaming

Write AI Description to Metadata XMP sidecar — searchable in Immich, Lightroom, etc.

Write AI Tags to Metadata Keyword tags in XMP sidecar for searchability

Advanced: Prompt Library Customise the prompts sent to AI models

Vision Prompt

The main prompt sent to the AI model when processing photos

Active Prompt

Context Injection Template Injected into the vision prompt when you provide processing context

Active Template

Rename & Filenames

Rename Mode

Review — Propose names, wait for approval Auto — Rename immediately, revert via History Auto (Low Confidence Review) — Auto-rename confident results, flag uncertain ones

Confidence Threshold 0.6 For auto-low-confidence mode: below this threshold triggers review

Filename Template

Template Placeholders: {date}, {location}, {description}, {camera}

Case

Max Length

Metadata Options

Use EXIF date in filenames

Extract and reverse-geocode GPS coordinates

GPS Detail Level

Scanning & Scheduling

Watch Mode

Enable watch mode — detect new files via filesystem events Uses OS-level notifications (inotify/FSEvents) for instant detection. Use manual Scan for a full directory walk.

Processing

Process subdirectories

Concurrent Workers Be careful with VRAM — more workers = more parallel model calls

Schedule

Enable scheduled processing Only process during a daily time window

Start

End

Scans still discover new files anytime.

Dashboard

Photo Showcase

Display two random photos at the bottom of the dashboard. Refreshes on each page load.

Enable photo showcase on dashboard

Filter by tag (optional) Leave empty to show any processed photo at random.

Showcase rotate interval: 15s How often each showcase photo changes.

Mosaic speed: 3x faster (5s per tile) How many times faster tiles change on the mosaic vs the showcase.

Enable Ken Burns effect (slow zoom & pan)

Crossfade speed: 2.0s How long each photo dissolves into the next.

Storage & Security

Thumbnails

Max Size (px)

JPEG Quality

Destructive Mode

Controls whether delete and trash operations are available. Disable to prevent accidental data loss.

Library Allow trashing and permanently deleting library photos

Workspace Allow deleting workspace photos (enabled by default for triage)

Security

Enable password protection

Database Management

Saves to backups folder and downloads a copy

Check database records against files on disk

Restore from a backup — current data will be replaced