Usage

Usage

Processing a set of photos

Upload. Drag photos or a ZIP onto the upload area, or click to browse. Accepted: JPG, PNG, GIF, BMP, WEBP, TIFF, and ZIP archives containing them. Every file is validated as a real image, not just by extension, so a renamed file is rejected rather than crashing the pipeline.

Adjust settings first, if you want. "Processing Settings" below the upload button exposes crop padding and match tolerance. Both only affect the run you are about to start. See Configuration.

Watch it run. Upload starts processing automatically and takes you to the progress page. Faces appear as they are discovered. You can pause, resume, or cancel.

Browse the results. Two views, switchable in the header.

List view

A card per person, showing their face and every photo they appear in. Click a photo to open it full size; the arrow keys move through that person's photos.

Hovering any face or thumbnail pops up a larger preview.

Graph view

Photos and people as a node network, with an edge wherever a person appears in a photo.

• Square layout puts photos in a grid with faces spread around all four sides. Radial packs photos in a spiral with faces on an outer ring.
• Hovering a face highlights only its photos and dims everything else.
• Drag nodes, scroll to zoom, drag the background to pan. There is a minimap and a fullscreen toggle.
• Double-click a photo to edit which faces are assigned to it.
• The Filter panel shows or hides individual people, either greying them out or removing them entirely.

Large sets get heavy. The app suggests turning effects off past about 30 images, and the Effects dialog in the sidebar toggles edge animation, glow, shadows, hover highlighting, transitions, and the minimap independently.

Fixing the results

Automatic matching is not perfect. Everything it decides can be corrected.

Rename a person by clicking their name.

Merge two cards that are the same person: open Faces in the header, select them, and merge. Nothing is deleted — they are grouped, so you can ungroup later or change which face is shown. Wrong merges are always recoverable.

Disable a person to hide them from results without losing the data. Useful for faces detected in a poster or a reflection.

Delete removes a person and their matches for good.

Assign by hand with "Edit Faces" on any photo: add a person the detector missed, optionally dragging a rectangle to mark where they are, or remove a wrong assignment. Skip the rectangle to assign without a box.

Working with sessions

Sessions are listed in the sidebar with their status.

Add Images uploads more photos into an existing session and re-processes it. People already found are recognised rather than recorded twice.

Delete removes the session, its database records, and its files from disk.