Immich-Face-To-Album

The 'immich-face-to-album' tool is a CLI-based program that allows you to import a user's face from Immich into an album, in a way similar to the Google photos "auto-updating album" feature.

Installation

Built as a Python package, it can be installed using pip:

pip install immich-face-to-album

Usage

Start by grabbing both the face id and album id from Immich. You can find the face id by clicking on a face in the "Faces" tab, and the album id by clicking on an album in the "Albums" tab. The face id is the last part of the url, and the album id is the last part of the url.

To use the tool, you need your API key, Immich server url, face id and album id.

immich-face-to-album --key xxxxx --server https://your-immich-instance.com --face xxxxx --album xxxxx

Make sure to specify the protocol and port in the server url. For example, if your server is running on port 8080, you should specify the url as http://your-server-url:8080.

You can repeat the --face multiple times to add multiple faces to the same album.

On a schedule

The easiest way to keep face(s) synced with an album is to create a cron job that runs the command on a schedule.

For example, to run the command every hour, you can add the following to your crontab:

0 * * * * immich-face-to-album --key your-key --server your-server-url --face face-id --album album-id

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

immich_face_to_album-1.0.15.tar.gz (20.9 kB view details)

Uploaded Jul 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

immich_face_to_album-1.0.15-py3-none-any.whl (8.0 kB view details)

Uploaded Jul 27, 2026 Python 3

File details

Details for the file immich_face_to_album-1.0.15.tar.gz.

File metadata

Download URL: immich_face_to_album-1.0.15.tar.gz
Upload date: Jul 27, 2026
Size: 20.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for immich_face_to_album-1.0.15.tar.gz
Algorithm	Hash digest
SHA256	`f32739ebab40141ed325c0e8ac581c8265df2542521d3fc80abf031184a136c0`
MD5	`0e823a1c184d0740c598e415e64673e2`
BLAKE2b-256	`d30e44f7314a04e9e360a7c2a231b4d13d4b2468594ab94ec431df53491cd4c0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for immich_face_to_album-1.0.15.tar.gz:

Publisher: release-to-pip.yml on romainrbr/immich-face-to-album

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: immich_face_to_album-1.0.15.tar.gz
- Subject digest: f32739ebab40141ed325c0e8ac581c8265df2542521d3fc80abf031184a136c0
- Sigstore transparency entry: 2257117333
- Sigstore integration time: Jul 27, 2026
Source repository:
- Permalink: romainrbr/immich-face-to-album@528f2966acff81ced6b03337563087de31eefdd4
- Branch / Tag: refs/tags/1.0.15
- Owner: https://github.com/romainrbr
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-to-pip.yml@528f2966acff81ced6b03337563087de31eefdd4
- Trigger Event: push