Home
About
Open source Mobile apps Frequently asked questions Migrating from Google Photos About us
Pricing FAQ Blog Support
Get Started
User guide Tooling

immich-folder-album-creator

Team PixelUnion
2 min read
#Tooling #immich #immich-folder-album-creator #Photo management
immich-folder-album-creator

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 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, 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, 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 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:

    1
2
3
4

    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 to share feedback or contribute!

Happy organizing!

Cover image by Lucas Favre