Photo Offloader

Insert a card and walk away. Once the upload starts, your photos appear live on your phone, or on any device signed in to Google Photos.

Insert a camera card into your Mac and Photo Offloader does the rest. It copies everything to the Mac and checks each copy with SHA-256, mirrors the archive to a USB drive, and can upload JPGs and video to Google Photos. It never deletes anything from the card and never overwrites an existing file.

Camera card  →  Mac (verified)  →  USB drive (optional)  →  Google Photos (optional, no RAW)

The Photo Offloader dashboard during an import

Features

Requirements

Install, upgrade, uninstall

From a clone of this repository:

./install.sh                   # install, or upgrade after a git pull
./uninstall.sh --dry-run       # preview what uninstalling removes
./uninstall.sh                 # uninstall; your photos and catalog stay

The dashboard opens when the install finishes, and its icon, an SD card, appears in the menu bar. Insert a card to start. To open it again later, double-click Photo Offloader on your Desktop or in ~/Applications.

macOS may ask whether Photo Offloader can find devices on your local network. It doesn’t need to: cards and the USB drive are local disks, Google Photos is reached over the internet, and the dashboard only talks to Photo Offloader on your own Mac. You can choose Don’t Allow, and change it later in System Settings › Privacy & Security › Local Network.

Treat this as backup infrastructure, not your only copy. After installing or upgrading, check the files in the archive before you format a card.

Where things are

The archive folders and the USB drive are defaults. To change them, choose Edit settings… in the dashboard’s ⋯ menu (details).

What Where
Photos, video and other files ~/Pictures/CameraImports
RAW files ~/Pictures/CameraImportsRaw
USB backup /Volumes/Photos/CameraImports
Import log ~/.camera_transfer.log (or ⋯ › View logs in the dashboard)
Start, stop, status ~/Library/Application Support/PhotoOffloader/scripts/service.sh

Status

Photo Offloader is a personal project that’s used for real, but by one person so far:

If you try it, an issue saying what worked, or what didn’t, with your camera and macOS version, is very welcome. Keep your own backup until you trust it.

Documentation

These pages are also on the project website.

How it was built

Photo Offloader was written with Claude Code, Anthropic’s AI coding tool, working to the rules in CODE_QUALITY.md and CLAUDE.md: a failing test first for each change and safety rules that every change must keep. A person reviews every pull request before it’s merged, then tries the change on real cards.

License

MIT