Back to app

Install & sign in

Download, sign in, and where your files live on disk.

The SnapFlow Sync desktop app Desktop app is for studio work — pulling your RAWs down to edit in Lightroom or Capture One, culling a big shoot fast, and pushing your finished selects back up. It runs alongside your editor and keeps a local copy of your albums on disk, so you work on real files, not a browser.

This chapter gets the app onto your Mac, signs you in, and gives you the lay of the land — the bottom stage bar that switches between work areas, and the Settings stage where the app keeps your account, your sync folder, and your theme.

Mac only, for now

SnapFlow Sync is a macOS app. It is signed and notarised by Apple, so it opens without a "this app is from an unidentified developer" warning.

Install the app

You download the app from the web side of SnapFlow, then drag it into your Applications folder. It lives in two places on the web — the Settings area and the older Profile page — and the card is identical in both.

  1. Open snap-flow.org in your browser and Sign in if you aren't already.
  2. Click your avatar (top-right) → Settings, then open the Integrations tab. — you'll see a SnapFlow Sync card with a blue Recommended pill.
  3. Click Download for Mac. — a .dmg disk-image file lands in your Downloads folder.
  4. Double-click the downloaded .dmg to open it. — a Finder window appears showing the SnapFlow Sync app icon and an Applications shortcut.
  5. Drag SnapFlow Sync onto the Applications folder. — the app copies in; you can now eject the disk image.
  6. Open Applications and double-click SnapFlow Sync to launch it. — the sign-in card appears (see the next section).

The SnapFlow Sync download card on the web Settings page The SnapFlow Sync card under Settings → Integrations: ① the Recommended pill, ② the Download for Mac button, ③ the line "Open the .dmg and drag SnapFlow Sync to the Applications folder." The same card also lives on your Profile page.

Where the download lives

Can't find the avatar menu? You can also reach the card from the older Profile page — both show the same Download for Mac button. See Account & settings for a tour of the Settings tabs.

Sign in

The first time you launch the app you'll see the Connect your photographer account card. You sign in with the very same email and password you use on the web — no separate desktop account.

  1. In the Server field, leave the default https://snap-flow.org as-is. — only change this if your studio is on a custom domain.
  2. Click the Email field and type the email address for your SnapFlow account. — the text appears as you type.
  3. Click the Password field and type your password. — it shows as dots.
  4. Click Connect (or just press Enter). — a brief "connecting" status shows, then the card disappears and the app shell opens with your albums.

The Connect sign-in card on first launch The first-launch sign-in card: ① the Server field (pre-filled with https://snap-flow.org), ② Email, ③ Password, ④ the blue Connect button. Pressing Enter does the same as clicking Connect.

When you're in, the app shell appears: a top bar with a search box, the main work area in the middle, and — most importantly — the bottom stage bar along the very bottom of the window, with Library highlighted as the starting area.

Your password is never stored

Signing in trades your password for a short-lived access token, kept in the macOS Keychain (the system's built-in password vault). The app refreshes that token quietly while you work, so you rarely sign in again. Your actual password is never written to disk.

Can't connect?

The Server must be an https:// address — the app rejects plain http://. If sign-in fails with a Keychain error, open the macOS Keychain Access app, allow the prompt, then try Connect again. If your session later expires, an amber "Your session expired — please sign in again" banner appears on the sign-in card; any pending uploads resume after you reconnect.

The bottom stage bar — your map of the app

Everything in SnapFlow Sync is reached from the stage bar along the bottom of the window. Each button is a separate work area (a "stage"). Click a button, or press its keyboard number. Reading left to right:

Button Shortcut What it's for
Library ⌘1 Browse, cull and rate your albums (the starting area).
Edit ⌘2 Develop RAWs locally and set an album's auto-edit style.
People ⌘3 Face and athlete recognition across all albums.
Deliver ⌘4 Galleries, client portal, proofing, watermark, embargo.
Styles ⌘5 Train and manage your auto-edit looks.
Metadata ⌘6 Abbreviations, photographer profiles, bulk metadata tools.
Settings ⌘7 Your account, sync folder, cache, theme.
Manage ▾ A small menu for the cross-album admin areas (see below).

The Manage ▾ button (far right) opens a little pop-up menu rather than a stage. It always lists Clients, Reports and Search, and — if you're on an organisation/agency account — also Projects and Organization.

The bottom stage bar with all seven stages and the Manage menu The bottom stage bar: ① Library (highlighted, ⌘1), ② Edit (⌘2), ③ People (⌘3), ④ Deliver (⌘4), ⑤ Styles (⌘5), ⑥ Metadata (⌘6), ⑦ Settings (⌘7), and ⑧ the Manage ▾ menu for Clients · Reports · Search.

Two search boxes — they do different things

The Search albums (⌘F) box in the top bar only filters the album list in the left sidebar. To search across your whole library — albums, photos and people — use Manage ▾ → Search. See Search across your library.

A few keyboard shortcuts worth knowing

  • ⌘K — opens the command palette, a quick switcher that jumps to any album or command by typing.
  • ⌘F — jumps your cursor into the Search albums box in the top bar.
  • ⌘, — opens the Settings stage (same as clicking Settings or pressing ⌘7).
  • ? — opens the keyboard cheat-sheet, listing every shortcut. (Press it any time you aren't typing in a field.)

The Settings stage

Press ⌘7 (or click Settings in the stage bar, or pick Settings from the avatar menu top-right) to open the Settings stage. This is where the app keeps all of its housekeeping. Here's what each section does:

  • Account — shows the server and the email you signed in with. View account ↗ opens your account on the web; Disconnect signs the app out.
  • Sync folder — the folder on your Mac where pulled originals and finals live. By default this is ~/SnapFlow Sync/, with one sub-folder per album. Click Change… to move it somewhere else (an external drive, for example).
  • Local cache — the thumbnails and previews kept on disk so albums open fast. Click Clear cache to free that space; thumbnails rebuild automatically the next time you open an album. A separate Editor previews row (with a size Limit dropdown) covers the develop-editor proxy cache.
  • Mounted volumes — click to expand and see the external drives and SD cards currently plugged in.
  • Storage — a used/limit bar showing how much of your plan's storage you've used. View detailed usage ↗ opens the full breakdown on the web.
  • Appearance (Theme) — pick Dark (the default, a Lightroom-neutral grey that's a steady reference for judging tone), Light, or System (follows your macOS appearance; the Edit stage stays dark either way).

Where your files actually live

Inside your Sync folder, each album gets its own sub-folder, and inside that the app keeps your originals and edits in raws, finals and proofed folders. You can open any album's folder straight from Finder via the album's menu → Show in Finder. See Syncing albums for how files flow up and down.

Three handy toggles in Settings

Lower down the Settings stage you'll find Launch at login (start the app automatically), Push notifications (native macOS alerts for sync events), and Write recognised names to sidecars (bakes detected people and numbers into each RAW's .xmp so Lightroom shows them). Each is a simple on/off switch.

Once you're installed and signed in, head to Syncing albums to start pulling photos down, or Importing from an SD card to ingest a fresh shoot straight from your camera card.