Skip to content

Using Vaquero

Vaquero after a scan, with the matches listed in the log

A scan, start to finish

  1. Reference faces: pick a folder with three to five photos of the person. See Reference photos.
  2. Folder to scan: pick where to look. Turn on Scan subfolders to look inside its folders too.
  3. Destination: pick where the matches go. It is created if missing and never scanned.
  4. Click Scan. Nothing moves yet.
  5. Check the matches in the log. Click any file name to open it.
  6. Choose Copy or Move, then click Execute.

Options

Option Default Description
Reference faces Folder of photos of the person to find
Folder to scan Folder searched for that person
Destination Where matches go; created if missing
Move / Copy Move What Execute does with the matches
Name exists Keep both A name already in the destination: keep both, the new file numbered (IMG_1 2.png), or overwrite
Model buffalo_l Installed model pack
Scan subfolders off Also scan subfolders; hidden folders and the destination are skipped, and matches land flat in the destination
Include videos on Also scan videos
Frames 10 Frames sampled per video, spread evenly through it; more catch a person who appears briefly, and take longer
Match threshold 0.35 Minimum score to count as a match

Settings persist between launches.

File types

Kind Extensions
Photos .jpg, .jpeg, .heic, .heif, .png, .webp, .tif, .tiff, .bmp
Videos .mov, .mp4, .m4v, .avi, .mkv

Other files are left alone. Hidden files and folders are skipped.

Scores and the threshold

A file's score is how closely its best-matching face resembles the person, from -1 to 1. Photos of the same person usually score 0.5 to 0.8; different people rarely pass 0.25. The default threshold is 0.35.

Matches from 0.35 to 0.45 are where hard shots (small, blurred, side-on or heavily filtered faces) and lookalikes overlap. They are logged as review in orange, clearer matches as match in green. The done line counts the review matches.

Each match also shows refs N/M: how many of the M reference photos its face matches on its own. A real match usually matches most of them (5/5); a lookalike resembles the average face but few single photos (0/5, 1/5).

Changing the threshold after a scan updates the matches without scanning again. Raise it to drop doubtful matches; lower it to catch hard shots, and check the scan report around the cutoff.

Progress and cancelling

  • The progress bar tracks the model download, the scan and the copy or move. The line below it shows the count while running, then DONE or CANCELLED with a summary.
  • Cancel stops a scan, copy or move after the current file. A cancelled scan keeps the results it reached, and its matches can still be copied or moved. A cancelled copy or move leaves every file either fully done and journaled or untouched.
  • Closing the window during a run cancels it and waits up to 30 seconds for the current file.

The log

The log opens with the version and the engine in use, then splits into sections: Setup, Scanning, Matches, Result, then Move or Copy. Matches are green, review matches and warnings orange, errors red. Every file name is a link that opens the photo or video.

Each Scan clears the log view and starts a new log file; the copy or move that follows writes to the same file. See Files.