imt

🎉 Overview

A collection of command-line tools for Immich.

☺️ Motivation

Immich is a great tool for managing photos, however when you have a big collection of pictures, it is hard to manage albums, especially if you a different way to organize like me.

🎯 Installation

Unix-like

Manual installation

# by default will install into ~/.local/bin folder.
curl -sSL https://raw.githubusercontent.com/faabiosr/imt/main/install.sh | bash 

# install into /usr/local/bin
curl -sSL https://raw.githubusercontent.com/faabiosr/imt/main/install.sh | sudo INSTALL_PATH=/usr/local/bin bash

go

go install github.com/faabiosr/imt@latest

💎 Usage

Login using Immich API Key (please generate one before use)

imt login http://your-immich-server

Logout (remove the stored credentials)

imt logout

List albums

imt album list

Create albums based on folder structure

# will create albums for the folders inside the `/home/user/photos`.
imt album auto-create /home/user/photos/

# will create albums recursivelly for the folders inside the `/home/user/photos`.
imt album auto-create --recursive /home/user/photos/

# will create albums recursivelly and skip levels size for the folders inside the `/home/user/photos`.
imt album auto-create --recursive --skip-levels 2 -/home/user/photos/

# will create albums from config file.
imt album auto-create --from-config example_auto_create.json

# for more option please run:
imt album auto-create -h

Server info

# Shows server info
imt info

🧰 Development

Requirements

The entire environment is based on Golang, and you need to install the tools below:

• Install Go
• Install GolangCI-Lint - Linter

Makefile

Please run the make target below to see the provided targets.

$ make help

📃 License

This project is released under the MIT licence. See LICENSE for more details.