Caution
Breaking Change
The deprecated option --archive/-v or Docker environment variable ARCHIVE has been removed, as it has been superseded by --visibility or VISIBILITY in version 0.19.0.
If you are still using the old --archive/-v option or Docker environment variable ARCHIVE, you must replace it with
--visibility archivefor plain Python script-e VSIBILITY="archive"for Docker CLIVISIBILITY: "archive"for Docker Compose
Features
- feat: Support Multiple Configurations
Added new option--api-keyallowing to specify additional API keys to the one provided in the positional argument. This option may be repeated multiple times to add multiple API keys for processing, similar to--root-path.
If--api-key-type fileis used, the API key secrets file may not contain one API key per line. It is also possible to specify multiple API key secrets files.
For Docker,API_KEYmay now contain a colon:separated list of API keys to process. Alternatively,API_KEY_FILEmay contain a colon:separated list to API key secrets files.
The script now logs the first 5 characters of the API key it is going to process next.
This feature eliminates he need to run multiple instances of this Docker container if the only difference in options is the API key.
Enhancements
- enh: Log nice error message on API connection error
If the initial connection to the Immich API fails (fetching the server version), the script no longer prints a full stack trace which might confuse the user.
Instead, the a clear error message is logged with CRITICAL log level.
The full error stack trace is logged to DEBUG log level. That way, it is still possible to get to the exact cause of the error.
Misc
- chore: Added Python version 3.13 to workflow linting matrix
- chore: Docker: Pinned base image to python:3.13-alpine3.22
Full Changelog: 0.20.0...0.21.0