# gPhotos2Immich

gPhotos2Immich is a self-hosted backup app. 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... It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7218/gphotos2immich

## Description

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.

## Health score

59/100 (Fair), based on 3 of 4 factors.
- Maintained: 86 (last commit 32 days ago)
- Popular: 46 (200 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_637f60bde99adb8c
- GitHub: https://github.com/warreth/gPhotos2Immich

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/7218/gphotos2immich), the self-hosted and open-source app directory.