← 返回命令列表

Linux command

immich-go 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Upload photos

immich-go upload [/path/to/photos]

Upload Google Photos Takeout archive

immich-go upload --google-photos [takeout.zip]

Create album per folder

immich-go upload --create-album-folder [/path/to/photos]

Dry run to preview upload

immich-go upload --dry-run [/path/to/photos]

Set server and API key

immich-go upload --server [url] --api-key [api-key] [/path/to/photos]

Upload with date range filter

immich-go upload --date-range [2023-01-01,2023-12-31] [/path/to/photos]

说明

immich-go is a Go-based alternative CLI for the Immich self-hosted photo management server. It provides efficient bulk uploads with support for Google Photos Takeout, iCloud exports, and Picasa archives. The tool handles date parsing from various metadata sources including EXIF, JSON sidecars, and file names. It is distributed as a single binary with no runtime dependencies, making it faster and easier to deploy than the official Node.js-based CLI for large uploads.

参数

upload
Upload files to the Immich server.
archive
Export assets from an Immich server to local storage.
stack
Organize related photos into stacks (RAW+JPEG pairs, bursts, etc.).
--server _URL_
Immich server URL.
--api-key _KEY_
API key for authentication.
--google-photos
Parse Google Photos Takeout archive.
--icloud
Parse iCloud photo export.
--create-album-folder
Create albums from folder names.
--dry-run
Simulate upload without making changes.
--date-range _RANGE_
Upload only photos within a date range.
--help
Display help information.

FAQ

What is the immich-go command used for?

immich-go is a Go-based alternative CLI for the Immich self-hosted photo management server. It provides efficient bulk uploads with support for Google Photos Takeout, iCloud exports, and Picasa archives. The tool handles date parsing from various metadata sources including EXIF, JSON sidecars, and file names. It is distributed as a single binary with no runtime dependencies, making it faster and easier to deploy than the official Node.js-based CLI for large uploads.

How do I run a basic immich-go example?

Run `immich-go upload [/path/to/photos]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does upload do in immich-go?

Upload files to the Immich server.