Skip to content

Install

Requirements

  • A Mac with Apple Silicon (M1 or later)
  • macOS 14 or later
  • About 500 MB free: the app and the face model it downloads on first launch

Install

  1. Download Vaquero-arm64.dmg, the latest release. Every version is on Releases.
  2. Open it and drag Vaquero onto Applications.
  3. Open Vaquero from Applications. The first launch downloads the face model (about 290 MB); scanning waits until it finishes.

Vaquero is signed with a Developer ID and notarized by Apple.

Permissions

macOS asks once for each kind of place Vaquero opens. Click Allow.

Vaquero Needs
Downloads the face model, checks for updates Nothing
Keeps its settings, logs and model Nothing
Reads photos on an external drive or network share, or in Desktop, Documents or Downloads A one-time Allow for that place
Copies or moves the matches The same Allow for the destination
Reads photos anywhere else in your home folder, such as Pictures Nothing

Vaquero checks access to the chosen folders at launch and before each scan. If a place was denied, it shows a window with an Open Settings button and the steps to turn access back on.

Updates

Vaquero > Check for Updates… downloads the latest release and restarts the app. Vaquero also checks when it opens and asks only when an update exists; turn that off in Vaquero > Settings….

Uninstall

Drag Vaquero from Applications to the Trash. Its data, safe to delete:

  • ~/Library/Application Support/Vaquero: the face model and the move journal
  • ~/Library/Logs/Vaquero: logs and scan reports
  • ~/Library/Preferences/com.bitwise.Vaquero.plist: settings
  • ~/Library/Caches/com.bitwise0x.vaquero and ~/Library/HTTPStorages/com.bitwise0x.vaquero: download caches