photo-scan

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

How it works

  1. Get an Immich account on pics.deverall.nz (ask Craig if you don't have one).
  2. In Immich, go to Account Settings → API Keys and create a key called photo-scan.
  3. Install the daemon for your computer (see below). The installer will open a browser-based setup wizard automatically.
  4. In the wizard, paste your API key, pick (or create) an album, and choose a folder to watch — that's it.
  5. Drop scanned pages (JPG / PNG / TIFF) into that folder. Each photo on the page becomes its own asset in your library.

Install — pick your platform

Windows 64-bitx86_64
  1. Move photoscand-windows-amd64.exe out of Downloads into somewhere permanent — e.g. %USERPROFILE%\photoscand\ — and (optionally) rename it to photoscand.exe. The setup wizard registers a Scheduled Task pointing at this path, so it shouldn't move later.
  2. Double-click it.
  3. A console window opens and your browser opens the setup wizard. Paste your Immich API key, pick an album and a folder to watch, and tick Start photoscand on login.
First launch: Windows SmartScreen will say "Windows protected your PC" because the binary isn't code-signed. Click More info → Run anyway.

After that, leave the console window open (or close it — the Scheduled Task will start photoscand again on next login).

Recommended: one-liner that downloads, unquarantines, and installs the daemon for you. Inspect it first at /install.sh if you like.

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

Or do it by hand:

Apple SiliconM1 / M2 / M3 / M4
Intel Macx86_64
macOS will quarantine the binary on first launch because it isn't code-signed.

Lift the quarantine, mark it executable, and put it on your PATH:

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

Then run the setup wizard:

photoscand setup

Recommended: one-liner that downloads and installs the daemon for you. Inspect it first at /install.sh if you like.

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

Or do it by hand:

Linux 64-bitx86_64
 
chmod +x ~/Downloads/photoscand-linux-amd64
mkdir -p ~/.local/bin
mv ~/Downloads/photoscand-linux-amd64 ~/.local/bin/photoscand
photoscand setup

Setup will offer to register a systemd --user unit so the daemon starts on login.