immich/cli
renovate[bot] 7d3ed6bd55
chore(deps): update typescript-projects (#13453)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2024-10-16 04:57:57 -04:00
..
src fix(cli): allow special characters in paths (#13282) 2024-10-09 18:15:50 +02:00
.editorconfig feat(cli) Add new CLI (#3066) 2023-07-06 09:37:47 -05:00
.gitignore test(cli): e2e testing (#5101) 2023-12-18 20:29:26 -06:00
.npmignore chore(cli): clean up files (#7955) 2024-03-14 13:09:27 -04:00
.nvmrc chore(deps): update dependency node to v20.18.0 (#13271) 2024-10-07 22:42:33 -04:00
.prettierignore refactor: open api (#6334) 2024-01-12 07:36:27 -05:00
.prettierrc chore(cli): auto-sort imports (#7116) 2024-02-14 09:55:40 -05:00
Dockerfile chore(deps): update node (#13449) 2024-10-15 14:39:55 -04:00
eslint.config.mjs chore: object shorthand linting rule (#12152) 2024-08-30 14:38:53 -04:00
LICENSE Change license to AGPLv3 (#7046) 2024-02-12 15:31:59 +00:00
package-lock.json chore(deps): update typescript-projects (#13453) 2024-10-16 04:57:57 -04:00
package.json chore: version v1.118.1 2024-10-15 20:44:10 +00:00
README.md fix(cli): Update build instructions for CLI (#11874) 2024-08-28 13:25:58 +00:00
tsconfig.json chore(cli): clean up files (#7955) 2024-03-14 13:09:27 -04:00
vite.config.ts fix(cli): handle patterns correctly on Windows (#10430) 2024-06-21 17:09:02 -07:00
vitest.config.ts chore: migrate CLI to ESM and vitest (#6777) 2024-01-30 18:23:33 -05:00

A command-line interface for interfacing with the self-hosted photo manager Immich.

Please see the Immich CLI documentation.

For developers

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:

$ npm install
$ npm run build

Then, to build the open-api client run the following in the open-api folder:

$ ./bin/generate-open-api.sh

To run the Immich CLI from source, run the following in the cli folder:

$ npm install
$ npm run build
$ ts-node .

You'll need ts-node, the easiest way to install it is to use npm:

$ npm i -g ts-node

You can also build and install the CLI using

$ npm run build
$ npm install -g .