# Salvoxia/immich-folder-album-creator

Automatically create and populate albums in Immich from a folder structure in external libraries

Repository: https://github.com/Salvoxia/immich-folder-album-creator
Canonical: https://ross.abutalabs.com/products/immich-folder-album-creator
Homepage: https://hub.docker.com/r/salvoxia/immich-folder-album-creator
Language: Python
License Family: other
Topics: album, folders, immich
Last push: 2026-07-10T18:42:31+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 91, longevity 65
- inputs: {"age_days": 921, "days_push": 54, "days_rel": 60, "gap_med": 13, "n_releases_24m": 30}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1124, forks 58 (observed 2026-08-28T04:03:40.645497+00:00)

## What it is
A Python script and Docker image that automatically creates and populates albums in the Immich self-hosted photo server based on folder structures in external libraries. It runs alongside the Immich compose stack and uses the Immich API via the immichpy client.

## Use cases
- automatically create immich albums from folder structure
- populate immich albums from external library directories
- run album sync script in immich docker compose stack
- mirror my photo folder hierarchy as immich albums
- filter which assets get added to immich albums
- schedule automatic album creation for new photos in immich

## When to choose
- you self-host Immich with external libraries and want albums to match your folder layout
- you want a set-and-forget Docker container that keeps albums in sync with directories
- you need filtering, regex album naming, or album level range control

## When to avoid
- you don't use Immich as your photo server
- you want manual, hand-curated album organization
- you run an Immich version older than v1.106.1 or need a different photo platform

## Facets
- artifact type: cli-tool
- maturity: active
- function: workflow-automation, developer-tools
- domain: self-hosted, photography, media, files
- platform: python, self-hosted, cli
- tags: immich, photo-management, album-creation, docker-image, external-libraries, automation, docker

## Member repositories
- Salvoxia/immich-folder-album-creator (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:40.645497+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:39:37.793767+00:00, confidence not recorded.
  - readme: https://github.com/Salvoxia/immich-folder-album-creator (fetched 2026-08-28T04:03:40.645497+00:00, sha a5fa81536fc8)
  - homepage: https://hub.docker.com/r/salvoxia/immich-folder-album-creator (fetched 2026-08-29T12:44:14.761685+00:00, sha 2b29cd913560)
  - site_page: https://docs.docker.com/docker-hub (fetched 2026-08-29T12:44:14.770950+00:00, sha caaa18892709)
  - site_page: https://www.docker.com/docs (fetched 2026-08-29T12:44:14.772749+00:00, sha aeada2272712)
  - site_page: https://www.docker.com/company (fetched 2026-08-29T12:44:14.774626+00:00, sha 05ab59b2bc29)
- Data as of 2026-08-30T08:39:29.467469+00:00.