Note
There was an issue with immich versions between v1.91.0 and v1.92.x Make sure to use an immich version higher or equal to 1.93.x
This tool can migrate albums and favorites from Photoprism to Immich. It does not migrate your photo files.
- The tool will only work if you keep the same file structure in immich that you already had in photoprism. This is the case if you take the
originals
folder from photoprism and use it in immich as external library. - Photoprism and Immich must both be running at the same time, because the tool communicates with both APIs.
- The tool fetches all photos with a
favorite
tag from your photoprism instance - For each photo, it retrieves the original
filename
and its respectivepath
- It connects to immich, tries to find the photo by
filename
and validates potential candidates on the immich side by comparing the filepath
- If a match was found, it marks the photo on immich as
favorite
- The tool fetches all photos of a certain
album
from your photoprism instance - For each photo, it retrieves the original
filename
and its respectivepath
- It connects to immich, tries to find the photo by
filename
and validates potential candidates on the immich side by comparing the filepath
- If a match was found, it creates a new
album
in immich and adds the matched photos
pip install ppim-migrator
Create a config.yaml
file in the working directory where you want to run the command.
photoprism:
base_url: https://photoprism.example.com
username:
password:
immich:
base_url: https://immich.example.com
api_key:
python -m ppim-migrator migrate-favorites
To get an album-id
just open the album in photoprism. The id is part of the url.
Example:
- Url, when opening the album:
https://photoprism.example.com/library/albums/aqrcixa2uf1q45iq/view
Thealbum-id
would beaqrcixa2uf1q45iq
python -m ppim-migrator migrate-album <album-id-here>