Immich Album Exporter
2026 - PresentCLI utility to export Immich albums into a local folder structure using configurable folder and filename templates. Preserves timestamps and leaves source media unchanged in Immich.
Immich Album Exporter provides a reliable way to export albums from Immich into an organized local archive. The goal is to mirror album structures and metadata without altering the source, ensuring that both personal and shared albums can be safely backed up or migrated. The solution focuses on predictable folder hierarchies, template-based naming, and accurate timestamp preservation to maintain context outside of Immich.
The exporter authenticates against the Immich API, queries album contents, and writes media to disk using configurable templates for folders and filenames. It preserves creation and modification timestamps, handles shared content, and avoids duplicate downloads. The implementation emphasizes CLI ergonomics, robust error handling, and efficient file system I/O so it can be run repeatedly for backups, migrations, or offline browsing.
The design prioritizes predictability, safety, and clear observability. Defaults are conservative to prevent unintended changes to the Immich source, while logs and configuration options make behavior transparent and repeatable. This makes the tool well-suited for scheduled exports, long-term archiving, and scenarios where a clean local folder structure is required.
