gPhotos2Immich

gPhotos2Immich syncs Google Photos shared albums to Immich on a schedule, without any Google API key: it reads public shared-album links, downloads…

  • Backup
  • Cloud
  • Media Applications
gPhotos2Immich syncs Google Photos shared albums to Immich on a schedule, without any Google API key: it reads public shared-album links, downloads full-quality photos and videos with their taken dates and skips items already uploaded. The web UI shows live logs and has a Sync Now button; a sync can also be triggered with POST /api/sync (e.g. from Home Assistant). First launch: create config.json (see Requires), open the WebUI, enter the Immich API URL (e.g. http://192.168.1.10:2283/api) and an Immich API key with the asset.read, asset.upload, album.create, album.read, album.update, albumAsset.create and user.read permissions (or All), then add your shared album links. Changes apply without a restart. Only public shared links work: check that the album opens in a private browser window. The web UI has no password: never expose its port to the internet.

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

59/100 Fair

Maintained
86last commit 32 days ago
Popular
46200 GitHub stars
Easy to install
201 install platform, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
200
Open issues
1
Last commit
2026-09-20
Latest release
v1.7.4
License
AGPL-3.0
Activity
stale

Checked today - source: GitHub (warreth/gPhotos2Immich)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

Alternatives

No alternatives collected yet.

Common questions

Do I need a Google API key for gPhotos2Immich?

No. It reads public shared-album links and only requires that the album is publicly accessible, so check that it opens in a private browser window.

What permissions should the Immich API key have?

Use an API key with asset.read, asset.upload, album.create, album.read, album.update, albumAsset.create and user.read, or All.

How can I trigger a sync from Home Assistant?

Send a POST request to the sync endpoint. The Web UI also has a Sync Now button and shows live logs.

Will gPhotos2Immich download media that is already in Immich?

No. It skips items that have already been uploaded.

Do I need to restart the app after changing settings?

No. Changes apply without a restart.

Answers sourced from github.com

Community

No community discussions collected yet.