Skip to content

Getting Started

Install SnapByFace, add reference photos, index your photo and video folders, and review matches. Face detection and search run locally on your Mac or PC.

SnapByFace answers one question: given an ID-style photo of a person, which photos and videos in your folders contain that person? Detection, 512-D face embeddings, and vector search all run on your own computer.

The three-step workflow

  1. Add people. Point SnapByFace at a folder of reference photos, with each file named after the person — the file name becomes their name. Sub-folders are scanned recursively.
  2. Add media folders. Point it at your photo and video folders; SnapByFace scans them recursively.
  3. Review matches. Browse results by person or by media file, check a similarity percentage for every hit, and double-click to open a preview.

Your first session

  1. Install SnapByFace (about 300 MB, models included).
  2. In the wizard, add one clear frontal reference photo (an ID-style photo works best) and name the person.
  3. Add a single media folder with a few hundred photos — small enough to finish quickly.
  4. Look at the top matches and decide whether the default threshold (0.45) fits your material.
  5. When the results look right, add the rest of your library and let it run in the background.

How matching works

  • Faces are detected with the bundled det_10g.onnx detector and encoded into 512-D embeddings by w600k_r50.onnx.
  • A hit is reported when the cosine similarity between two embeddings is at or above the threshold — 0.45 by default, adjustable from 0.30 to 0.80.
  • Vectors are searched with FAISS; if FAISS is unavailable, SnapByFace falls back to a NumPy search that returns the same matches more slowly.

What stays on your computer

All recognition and search run locally. Your photos, videos, and face embeddings never leave the machine, and no image or video is uploaded.

:::note SnapByFace keeps its SQLite database, face data, and logs in ~/.snapbyface/ (your user folder on macOS and Windows). There is no account, so nothing is synced anywhere. :::

The only data that leaves your computer is an optional device statistics ping — machine code, app version, operating system, language, activation state, and plan. It contains no photos, videos, face data, file paths, library sizes, or search activity. It is on by default and can be switched off in Settings.

What SnapByFace does not do

  • It does not upload images, video, or face data to any server.
  • It does not rename, move, or modify your files — your media is read-only to it.
  • It does not find people you never added; every match is against a reference photo you supplied.
  • It does not require an account or a login.

System requirements

macOSmacOS 12 or later, Apple Silicon or Intel
WindowsWindows 10 or later
Download sizeAbout 300 MB (face models are bundled — no runtime download)
ImagesJPG, JPEG, PNG, BMP, TIFF, WebP, HEIC/HEIF
VideoMP4, MOV, AVI, MKV, M4V, WebM, TS

Trial and activation

Without a license you still get a full local search; the results view shows up to 5 matches per person and 20 matches per search, and you can start up to 100 analyses in total. Activating unlocks every match already found — you do not need to re-run the search.

Next steps