immich-go

An alternative to the immich-CLI command that doesn't depend on nodejs installation. It tries its best for importing google photos takeout archives.

Automatically checked · GitHub checked 2026-11-14

immich-go

Overview

Immich-Go is an open-source tool designed to streamline uploading large photo collections to your self-hosted Immich server. - Immich V3 Ready: Full compatibility with Immich V2 and V3 - Multiple Sources: Upload from Google Photos Takeouts, iCloud, local folders, ZIP archives, and other Immich servers - Large Collections: Successfully handles 100,000+ photos - Smart Management: Duplicate detection, burst photo stacking, RAW+JPEG handling - Cross-Platform: Available for Windows, macOS, Linux, and FreeBSD - Use --ban-file to exclude junk artifacts. Patterns ending with / apply to directories (for example, --ban-file .Spotlight-V100/), while patterns without the trailing slash apply to individual files (for example, --ban-file .DS_Store). - Immich-Go ships with sensible defaults that already skip common clutter such as @eaDir/, @thumb/, SYNOFILE_THUMB., Lightroom Catalog/, thumbnails/, .DS_Store, /., .Spotlight-V100/, .photostructure/, and Recently Deleted/. - Add additional patterns as needed to keep uploads focused on real photos. See the banned files reference for details. immich-go offers a versatile set of commands to handle your photo and video uploads. Whether you're uploading from a simple folder, migrating from a Google Photos Takeout, or transferring assets between Immich servers, the tool provides intelligent features to preserve your metadata and organization. - from-folder: The basic command for uploading from any local folder. It can create albums from your directory structure and read XMP sidecar files. - from-google-photos: A powerful command to migrate from a Google Photos Takeout. It intelligently matches photos with their JSON metadata to preserve albums, descriptions, and locations. - from-immich: A server-to-server migration tool that allows you to copy assets between two Immich instances with fine-grained filtering. - from-picasa: A specialized version of from-folder that automatically reads .picasa.ini files to restore your Picasa album organization. - Albums and Tags: Automatically creates albums and tags on the server to match your source organization. - Stacking: Groups related images, like RAW+JPEG pairs or photo bursts, into stacks. - Duplicate Detection: Avoids re-uploading files that already exist on the server. - Efficient Uploads: Can pause Immich's background jobs (like thumbnailing) during an upload for better performance. This project is licensed under the terms specified in the LICENSE file.