mostlystable/immich-album-digest repository overview

This image runs a Python-based digest service for Immich shared albums.

The service performs the following steps:

1. Connects to an Immich instance using an API key
2. Retrieves assets from a specified album
3. Filters assets added since the last successful digest run
4. If a minimum threshold is met, selects three representative assets (first, middle, last)
5. Downloads and processes thumbnails into square previews
6. Generates a stylized collage image (polaroid-style layout)
7. Sends an HTML email with the collage embedded inline
8. Updates a persistent state file to track the last successful digest

The container is designed to run as a scheduled task and exits after execution.

Configuration is provided via environment variables. State and generated output are persisted using mounted volumes.

This image does not include any secrets. Credentials must be provided at runtime.