Home
About
Open source Mobile apps Frequently asked questions Migrating from Google Photos About us
Pricing Blog
Help Center
Account Immich Other Contact 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