Commands

Command	What it does
videre scan	Read a folder and record what’s in it. Run this first.
videre dedupe	List duplicate copies you could delete
videre report	Generate an HTML gallery, or serve the face-naming UI
videre search	Find photos by description, example image, person, category, or place
videre embed	Prepare photos for search (one-time, resumable)
videre faces	Detect and group faces
videre classify	Tag photos as photo/screenshot/document/meme
videre locations	Group photos by where they were taken
videre fix-dates	Set each file’s date from its EXIF shoot date
videre prune	Remove database entries for files that no longer exist
videre watch	Background loop keeping everything current
videre stats	Library totals and what has run recently
videre config	Show or change defaults
videre mcp	Expose search to AI agents

Every command also takes --help.

Common options

Most commands share these:

Option	Effect
--db <path>	Use a specific database instead of the resolved default
--silent	Suppress progress output on stderr
--json	Print one JSON object on stdout instead of human-readable text
--model <id>	Use a specific search model (embed, search, classify, report, mcp)

What needs what

To run	You first need
dedupe, report, fix-dates, prune, stats, locations	scan
search (text or image)	embed
search --person	faces, then naming via report --faces
search --category	classify (which needs embed)
search --location	GPS data in your photos

Workflows has the full dependency map, what to run afterwards (prune is the one people forget), recipes for the common jobs, and rough costs for the long ones.