Immich-AutoAlbums

Overview

Immich Folder Album Creator This is a python script designed to automatically create albums in Immich from a folder structure mounted into the Immich container. This is useful for automatically creating and populating albums for external libraries. Using the provided docker image, the script can simply be added to the Immich compose stack and run along the rest of Immich's containers.

Runtime arguments

Network: bridge
Shell: sh
Privileged: false

Template configuration

ROOT_PATHVariable

A single or a comma separated list of import paths for external libraries in Immich. (path inside Immich, NOT inside Unraid !)

API_URLVariable

The root API URL of immich, e.g. https://immich.mydomain.com/api/

Value: http://x.x.x.x:8080/api/

API_KEYVariable

The Immich API Key to use

ALBUM_LEVELSVariable

https://github.com/Salvoxia/immich-folder-album-creator#how-it-works

Value: 2

Host Key 5Variable

Do not ask for user confirmation after identifying albums.

Target: UNATTENDED
Default: 0
Value: 1

Host Key 6Variable

Confirm deletion of albums when running in mode CLEANUP or DELETE_ALL. If this flag is not set, these modes will perform a dry run only. Has no effect in mode CREATE

Target: DELETE_CONFIRM
Default: 0
Value: 0

Host Key 7Variable

Separator string to use for compound album names created from nested folders. Only effective if -a is set to a value > 1(default:

Target: album-separator
Value: -

Links

Template Docker Hub Project

Details

Repository

salvoxia/immich-folder-album-creator

Registry

https://registry.hub.docker.com/r/salvoxia/immich-folder-album-creator

Last Updated2026-03-31

First Seen2024-09-15

Run Immich-AutoAlbums on Unraid.

Immich-AutoAlbums is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS