← statichum.studio

Continuous macOS Apple Photos Library Sync to a Self-Hosted Immich Server, Native, With Album and Keyword Metadata Intact

desktop app real project •• multiple requests

Mac-first households who don't carry an iPhone have no clean way to keep a self-hosted Immich library in lockstep with their primary photo workflow on macOS. Immich's iOS app handles continuous background backup beautifully, but the macOS side is bulk-upload-once or nothing, and bulk export silently drops keywords, faces, and album structure. The builder opportunity is a daemon that reads the Apple Photos SQLite database directly and streams diffs to Immich.

builder note

Reading Photos.sqlite directly is the only path that preserves keywords, faces, and album structure... everything else loses data. The trap is assuming you can use Apple's PhotoKit framework, it's read-limited and won't surface enough metadata. Distribute as a signed .app with a launchd agent so non-engineers can install it like any normal Mac app.

landscape (4 existing solutions)

Every existing path either ignores Apple's metadata model (file-mirror approaches) or treats sync as a one-shot bulk export (osxphotos). The clean path requires reading the Photos SQLite database directly and watching for diffs, and only one volunteer project (mirror-immich) has even started down that road.

Immich iOS mobile app Solves iPhone-side background upload but does nothing for Mac-only owners or for photos that enter the library via AirDrop, ingest from a camera card, or RAW imports edited on the desktop
osxphotos + Immich CLI Script-and-cron workflow, not a continuous sync, and metadata round-trip is lossy because Apple's export silently drops keywords and persons in many cases
mirror-immich Right design (reads Photos.sqlite directly for true metadata) but very early, single-maintainer, no GUI, and no installer non-technical users can run
Syncthing-based folder mirror Treats the Photos library as opaque files, loses album/face/keyword data and breaks Live Photos pairing

sources (3)

other https://github.com/immich-app/immich/discussions/14842 "no way to continuously sync Apple MacOS Photos library with Immich" 2024-12-21
other https://www.answeroverflow.com/m/1444386460135587890 "tried about 40 different options, none work 100%" 2025-09-08
other https://github.com/flowlogix/mirror-immich "Apple Photos macOS sync to Immich including all metadata" 2026-02-15
self-hostedphotosmacosimmichmetadata-sync