photo-scan

Drop scans of old photos into a folder. They get straightened, cropped, and uploaded to your Immich library.

Download the daemon

macOS — Apple SiliconM1/M2/M3/M4 macOS — Intelx86_64 Windowsx86_64 Linuxx86_64

Getting started

  1. Make sure you have an Immich account on pics.deverall.nz (ask Craig if you don't).
  2. In Immich, go to Account Settings → API Keys and create a key called photo-scan. Copy it somewhere safe.
  3. Download the daemon for your OS using the buttons above.
  4. Open a terminal and run photoscand setup. It will ask for your Immich URL, the API key, the folder to watch, and which album to upload to.
  5. Drop scanned pages (JPG/PNG/TIFF) into your chosen folder. Each photo on the page becomes its own asset in your Immich library.

Quick install (macOS & Linux)

One-liner that does the download + quarantine fix + PATH placement for you. Inspect the script first at /install.sh if you'd like.

curl -fsSL https://photo-scan.deverall.nz/install.sh | sh

macOS — manual install

Because the binary isn't signed, macOS will quarantine it on first launch. The quick-install script handles this for you; if you'd rather do it manually after using the buttons above:

xattr -d com.apple.quarantine ~/Downloads/photoscand-darwin-arm64
chmod +x ~/Downloads/photoscand-darwin-arm64
mv ~/Downloads/photoscand-darwin-arm64 /usr/local/bin/photoscand