Skip to content

faabiosr/imt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

26 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

imt

Build Status Codecov branch Go Report Card Release License

๐ŸŽ‰ 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:

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.

About

A collection of command-line tools for Immich

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published