@conneryn/immich v0.27.0

IMMICH CLI

CLI utilities to help with some operations with the Immich app

Features

• Upload assets (videos/images) from a directory to IMMICH server

Supported file type

Image

• heif
• heic
• jpeg
• png
• jpg
• gif
• heic
• heif
• dng
• x-adobe-dng
• webp
• tiff
• nef

Video

• mp4
• quicktime
• x-msvideo
• 3gpp

Getting Started

Install from NPM

1 - Install from NPM repository

npm i -g immich

2 - Run

Specify user's credential, Immich's server address and port and the directory you would like to upload videos/photos from.

immich upload --email testuser@email.com --password password --server http://192.168.1.216:2283/api -d your/target/directory

Parameters

Run via Docker

Be aware that as this runs inside a container, it mounts your current directory as a volume and for the -d flag you need to use the path inside the container.

docker run -it --rm -v "$(pwd)":/import ghcr.io/immich-app/immich-cli:latest upload --email testuser@email.com --password password --server http://192.168.1.216:2283/api -d /import

Optionally, you can create an alias:

alias immich="docker run -it --rm -v '$(pwd)':/import ghcr.io/immich-app/immich-cli:latest"
immich upload --email testuser@email.com --password password --server http://192.168.1.216:2283/api -d /import

Install from source

1 - Clone Repository

git clone https://github.com/alextran1502/immich-cli

2 - Install dependencies

npm install

3 - Run

npm run build

4 - Run

node bin/index.js upload --email testuser@email.com --password password --server http://192.168.1.216:2283/api -d your/target/directory