T

Christoph 326175b176 refactor(core): clean up code style and improve readability

This commit addresses various minor structural improvements across the codebase, primarily focusing on simplifying syntax and enhancing robustness. Several instances of overly verbose string concatenation and unnecessary line breaks have been cleaned up for better adherence to Python best practices.

- Simplified dictionary comprehensions in asset retrieval functions
- Improved error message formatting using f-strings
- Updated .gitignore to exclude agent and codex directories

2026-07-23 16:54:23 +02:00

src

refactor(core): clean up code style and improve readability

2026-07-23 16:54:23 +02:00

tests

refactor(config): Set correct default sync interval and documentation

2026-07-23 14:25:03 +02:00

.dockerignore

Based on the structure and content of the data you provided, this is a listing of **platform-specific binary wheels (.whl files)** for the Python package charset_normalizer version 3.4.9.

2026-07-23 13:41:41 +02:00

.env.example

feat(sync): enable scheduled asset synchronization mode

2026-07-23 14:04:13 +02:00

.gitignore

refactor(core): clean up code style and improve readability

2026-07-23 16:54:23 +02:00

.python-version

Based on the structure and content of the data you provided, this is a listing of **platform-specific binary wheels (.whl files)** for the Python package charset_normalizer version 3.4.9.

2026-07-23 13:41:41 +02:00

compose.yaml

feat(sync): enable scheduled asset synchronization mode

2026-07-23 14:04:13 +02:00

Dockerfile

Based on the structure and content of the data you provided, this is a listing of **platform-specific binary wheels (.whl files)** for the Python package charset_normalizer version 3.4.9.

2026-07-23 13:41:41 +02:00

pyproject.toml

Based on the structure and content of the data you provided, this is a listing of **platform-specific binary wheels (.whl files)** for the Python package charset_normalizer version 3.4.9.

2026-07-23 13:41:41 +02:00

README.md

refactor(config): Set correct default sync interval and documentation

2026-07-23 14:25:03 +02:00

uv.lock

Based on the structure and content of the data you provided, this is a listing of **platform-specific binary wheels (.whl files)** for the Python package charset_normalizer version 3.4.9.

2026-07-23 13:41:41 +02:00

README.md

Immich external library to albums

This script creates Immich albums from the directory names in an external library and adds the corresponding assets to them. It does not move or modify the original files.

For example, with:

EXTERNAL_ROOT=/mnt/nextcloud-photos
ALBUM_MODE=root

the asset:

/mnt/nextcloud-photos/Korea_2016_07_08/photo.jpg

is added to an album named Korea_2016_07_08. Files in nested directories below Korea_2016_07_08 are added to the same album.

Configuration

Required environment variables:

IMMICH_URL: Immich server URL, for example http://immich-server:2283
IMMICH_API_KEY: API key with asset.read, album.read, album.create, and albumAsset.create permissions
IMMICH_LIBRARY_ID: ID of the external Immich library

Optional environment variables:

EXTERNAL_ROOT: Path stored in Immich's originalPath; defaults to /mnt/nextcloud-photos
ALBUM_MODE: root (default), leaf, or relative
ALBUM_SEPARATOR: Separator for relative mode; defaults to -
PAGE_SIZE: Immich search page size; defaults to 1000
DRY_RUN: Set to true to log planned work without changing albums
SYNC_INTERVAL_SECONDS: Delay between runs; defaults to 1800 seconds (30 minutes). Set it to 0 for a single run

Run the script after Immich has scanned the external library:

uv run python src/main.py

Docker Compose

Copy the example configuration and insert your Immich API key and external library ID:

cp .env.example .env
docker compose up --build

The example starts with DRY_RUN=true. Check the output, then set DRY_RUN=false in .env and run docker compose up again.

When Immich publishes port 2283 on the same Docker host, use:

IMMICH_URL=http://host.docker.internal:2283

For an Immich server on another machine, use its normal HTTP(S) URL instead. The photo directory does not need to be mounted into this container: EXTERNAL_ROOT is matched against the path recorded in Immich's originalPath field.

The Compose service stays running and synchronizes every 30 minutes. Change SYNC_INTERVAL_SECONDS in .env to use another interval. The delay starts after a synchronization finishes. Temporary API errors are logged and retried on the next scheduled run.

The script only adds missing assets. It never removes assets from albums and never deletes albums.