2023-11-19 23:16:24 +01:00
|
|
|
A command-line interface for interfacing with the self-hosted photo manager [Immich](https://immich.app/).
|
2023-07-06 16:37:47 +02:00
|
|
|
|
2025-10-02 17:42:14 +02:00
|
|
|
Please see the [Immich CLI documentation](https://docs.immich.app/features/command-line-interface).
|
2023-11-19 23:16:24 +01:00
|
|
|
|
|
|
|
|
# For developers
|
|
|
|
|
|
2024-08-28 15:25:58 +02:00
|
|
|
Before building the CLI, you must build the immich server and the open-api client. To build the server run the following in the server folder:
|
|
|
|
|
|
2025-10-06 18:39:23 +02:00
|
|
|
$ pnpm install
|
|
|
|
|
$ pnpm run build
|
2024-08-28 15:25:58 +02:00
|
|
|
|
|
|
|
|
Then, to build the open-api client run the following in the open-api folder:
|
|
|
|
|
|
|
|
|
|
$ ./bin/generate-open-api.sh
|
|
|
|
|
|
2023-11-19 23:16:24 +01:00
|
|
|
To run the Immich CLI from source, run the following in the cli folder:
|
|
|
|
|
|
2025-10-06 18:39:23 +02:00
|
|
|
$ pnpm install
|
|
|
|
|
$ pnpm run build
|
2023-11-19 23:16:24 +01:00
|
|
|
$ ts-node .
|
|
|
|
|
|
2025-10-06 18:39:23 +02:00
|
|
|
You'll need ts-node, the easiest way to install it is to use pnpm:
|
2023-11-19 23:16:24 +01:00
|
|
|
|
2025-10-06 18:39:23 +02:00
|
|
|
$ pnpm i -g ts-node
|
2023-07-06 16:37:47 +02:00
|
|
|
|
2023-11-19 23:16:24 +01:00
|
|
|
You can also build and install the CLI using
|
2023-07-06 16:37:47 +02:00
|
|
|
|
2025-10-06 18:39:23 +02:00
|
|
|
$ pnpm run build
|
|
|
|
|
$ pnpm install -g .
|
2024-08-28 15:25:58 +02:00
|
|
|
****
|