Immich Albums is a tool designed to create albums in Immich from a folder structure. Assets needs to be loaded as external library in Immich then you can launch script to create albums.

• Immich instance running
• Python installed
• Poetry installed - https://python-poetry.org/docs/#installation

1. Clone the repository:

   git clone https://github.com/alvistar/immich-albums.git

2. Navigate to the project directory:

    cd immich-albums

3. Install dependencies:

4.  poetry install

5. Activate virtual environment:

    poetry shell

6. Test installation:

    im --help

You can get help of various args by running:

im --help

The following are required arguments:

• --api-key - Immich API key
• --api-host - Immich API host
• --original-path - Path to local albums
• --replace-path - Path as seen by Immich host

Original path is the path to your local albums. If for example your albums are stored in /home/user/albums and you mounted that path under docker as /mnt/albums you need to pass /home/user/albums as --original-path and /mnt/albums as --replace-path.

Example:

cd /home/user/albums
im --api-key YOUR_API_KEY --api-host YOUR_API_HOST --original-path /home/user/albums --replace-path /mnt/albums .

Instead of passing every argument you can create a config file in yaml format. Default config file name is config.yaml and it should be placed in your home directory under ".config/immich-albums/config.yml"

Example config file:

api-key: YOUR_API_KEY
api-host: YOUR_API_HOST
original-path: /path/to/local/albums
replace-path: /path/as/seen/by/immich

Alternatively you can pass config file path as argument:

im --config /path/to/config/file

Contributions to Immich Albums are welcome!

This project is licensed under the MIT license - see the LICENSE.txt file for details.

Big thanks to Immich for the incredible job!