Immich-AutoAlbums

Immich Folder Album Creator is a Python tool that automatically creates and populates albums in Immich from a folder structure mounted into the Immich…

  • Automation
  • Media Applications
  • Tools & Utilities
Immich Folder Album Creator is a Python tool that automatically creates and populates albums in Immich from a folder structure mounted into the Immich container. It is for self-hosted Immich users who maintain external media libraries and want their albums to follow the directory layout without manual work.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

68/100 Good

Maintained
98last commit 23 days ago
Popular
621,193 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
206 GB minimum RAM, runs on ARM
Security check
85no serious findings, CI

Availability: platform listings confirmed today, links checked 52 days ago

GitHub stars
1,193
Open issues
5
Last commit
2026-10-29
Latest release
2.0.3
License
MIT
Activity
rising

Checked 20 days ago - source: GitHub (Salvoxia/immich-folder-album-creator)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 2 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Fill in your Immich connection settings Open the downloaded config.yaml and fill in immich_url and immich_api_key with your Immich server address and a valid API key. Without these required settings, the kiosk cannot find your Immich server or load photos. source
  • Download a starting config file Create a ./config folder and download the example config.yaml into it before starting anything. This gives you a complete starting file to edit, so you don't miss settings the app needs. source
  • Start the kiosk only after config After your config.yaml is filled in, run docker compose up -d to launch the kiosk in the background. Starting it too early with empty settings means the container runs but has no connection to your photos. source
  • Add to Immich Add the provided Docker image as an extra service in the Immich Docker Compose stack so it runs alongside Immich's other containers; the external library folder structure must be mounted into the container. source

Fetched 37 days ago - each note links to its source

Alternatives (12)

  • Ente Photos - Open-source, end-to-end encrypted backup and sharing for photos and videos, with multi-platform sync, original quality, privacy controls, a…
  • Frameleaf Manager - Frameleaf Manager is the guided installer and upgrade tool for the self-hosted Frameleaf photo and video library.
  • Go-vod - Go-vod is a minimal, self-hosted video transcoding server for the Memories Nextcloud photo app that exposes stored media as HTTP Live Strea…
  • Google Photos - Cloud storage offering 15 GB free space, automatic album and duplicate organization, AI editing, cross-platform sharing, and secure backups.
  • HomeGallery - HomeGallery is a self-hosted, open-source web gallery for browsing personal photos and videos while keeping your original file and folder s…
  • PhotoPrism - PhotoPrism is a self-hosted, AI-powered photo and video manager.
  • Piwigo - Piwigo is a self-hosted, open-source photo gallery for the web that lets you publish, organise, and share your picture collection with powe…
  • Proton Drive - Emphasizes privacy with end-to-end encryption, Proton Drive safely stores, synchronizes, and shares files across devices via web and mobile…
  • TinyCld - Open source suite for mail, calendar, drive, and contacts with self-hosting, privacy, zero cost, open standards, versioned files, and unifi…
  • foldergram - Foldergram is a self-hosted, local-first web gallery that scans folders for photos and videos and displays them in a fast, Instagram-style…
  • immich-server
  • librephotos - LibrePhotos is a self-hosted, open-source photo management service for organizing and browsing photo and video collections.

Checked 40 days ago - source: AlternativeTo

Common questions

Can the Docker image be added to the existing Immich compose stack?

Yes, the provided Docker image can be added to the Immich compose stack and run with the other Immich containers.

How should I choose the immichpy version if running the bare Python script?

Update requirements.txt so the immichpy package version matches your Immich server version. The supported server versions are listed in the immichpy compatibility mapping.

Does the script use the Immich API directly?

It uses the immichpy client for all API calls.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads