---
title: "immich-folder-album-creator"
description: "immich-folder-album-creator, a powerful command-line tool that bridges the gap between your local folders and Immich albums"
url: "https://pixelunion.eu/blog/immich-folder-album-creator/"
date: "2025-06-17"
author: "Team PixelUnion"
categories: ["User guide","Tooling"]
tags: ["Tooling","immich","immich-folder-album-creator","Photo management"]
---


# Effortlessly Organize Your Photos with immich-folder-album-creator

If you’re like most of us, your photo collection is a sprawling collection of folders, albums, and images scattered across your devices. The PixelUnion based on the open-source [Immich](https://github.com/immich-app/immich) platform makes it easier to manage your photos privately and efficiently-but what if you want your carefully organized folder structure to translate seamlessly into albums within PixelUnion?

Enter [immich-folder-album-creator](https://github.com/Salvoxia/immich-folder-album-creator), a powerful command-line tool that bridges the gap between your local folders and Immich albums.

## What is immich-folder-album-creator?

Created by [@Salvoxia](https://github.com/Salvoxia), immich-folder-album-creator is a lightweight utility that automatically creates albums in your PixelUnion instance to match the folder structure of your uploaded photos. No more manual album creation or painstaking organization-this tool does the heavy lifting for you.

## Key Features

- **Automatic Album Creation:** Scans your local photo directories and creates corresponding albums in PixelUnion.
- **Folder-to-Album Mapping:** Maintains your existing folder hierarchy, making navigation in PixelUnion intuitive and familiar.
- **Batch Processing:** Handles large collections efficiently, perfect for users migrating extensive libraries.
- **Customizable Options:** Supports various configurations to suit different workflows and preferences.

## How Does It Work?

1. **Prepare Your Photos:** Ensure your photos are organized in folders on your local machine as you’d like them to appear in PixelUnion.
2. **Upload to PixelUnion:** Use Immich’s official import or sync tools to upload your photos.
3. **Run immich-folder-album-creator:** Point the tool at your photo root directory and provide your PixelUnion server credentials. The tool scans your folders and creates albums to match.
4. **Enjoy Effortless Organization:** Open PixelUnion and see your albums neatly organized, ready to browse and share.

## Getting Started

1. **Install the Tool:**  
   Download or clone from [GitHub](https://github.com/Salvoxia/immich-folder-album-creator) and follow the installation instructions in the README.

2. **Configure and Run:**  
   The tool can be run from the command line with simple arguments. For example:
   ```sh
   python3 ./immich_auto_album.py \
    /path/to/external/lib \
    https://<your-username>.pixelunion.eu/api \
    thisIsMyApiKeyCopiedFromImmichWebGui
   ```
   (Check the repo for full usage options and details.)

3. **Sit Back and Relax:**  
   Let the tool organize your albums while you focus on enjoying your photos.

## Why Use immich-folder-album-creator?

For anyone migrating to PixelUnion or looking to maintain a well-organized digital photo library, this tool is a game-changer. It saves time, reduces manual effort, and ensures your albums in PixelUnion mirror your trusted folder structure.

Whether you’re a photographer, a digital archivist, or simply a photo enthusiast, give immich-folder-album-creator a try and streamline your photo organization today.

---

Try it out and join the conversation on [GitHub](https://github.com/Salvoxia/immich-folder-album-creator/issues) to share feedback or contribute!

*Happy organizing!*

Cover image by [Lucas Favre](https://unsplash.com/photos/silver-macbook-beside-battery-charger-4x-67z_TaGo)