simulot/immich-go
Immich Go
immich-go is a command-line tool for managing a self-hosted Immich photo server. It provides direct utilities for inspecting server state, uploading photos and videos, and performing server-side maintenance tasks like duplicate detection and photo stacking, all without requiring a web interface.
The tool distinguishes itself through its ability to process Google Takeout archives, extracting photos, videos, and album structure while preserving original metadata including GPS location and capture dates. It also offers a concurrent upload pipeline that balances throughput to avoid overwhelming the server, and a server-side deduplication strategy that identifies duplicate assets by file name and capture date, replacing inferior copies with the best version.
Beyond these core capabilities, immich-go supports importing from local directories, directory trees, and ZIP archives, with asset selection and archive content analysis for debugging import issues. It also enables photo stacking to group burst sequences and raw/JPEG pairs, and provides export functionality for downloading photos and albums for backup or migration.
The tool is distributed as a command-line binary and requires no additional runtime dependencies beyond the Immich server it manages.
Features
- Concurrent Upload Pipelines - Ships a concurrent upload pipeline that balances throughput to avoid overwhelming the server.
- Photo Server Managers - Provides command-line utilities for inspecting, deduplicating, and organizing a self-hosted photo server.
- Photo Uploaders - Uploads large photo collections from local folders and archives with parallel transfer and metadata preservation.
- Deduplication and Stacking - Finds and removes duplicate photos on a server, then groups related images into stacks to reduce clutter.
- Google Takeout Importers - Imports Google Takeout archives into a photo server, extracting photos with original dates, GPS, and album organization.
- Metadata Importers - Extracts and retains original EXIF, GPS, and album metadata from source files during import.
- Server-Side Deduplication Engines - Identifies duplicate assets by file name and capture date, replacing inferior copies with the best version.
- Photo Upload CLIs - Ships a command-line tool for uploading photos and videos to a server while preserving metadata and album structure.
- Photo Server Maintenance CLIs - Provides a command-line utility for running server maintenance tasks like duplicate detection and photo stacking.
- Duplicate Photo Removers - Finds duplicate files on the server by name and capture date, then replaces inferior copies with the best version.
- Google Photos Takeout Importers - Processes Google Takeout archives by extracting photos and videos while preserving original metadata and album structure.
- Metadata-Preserving Uploads - Uploads large photo collections to the server while preserving original metadata and file structure.
- Photo Collection Uploaders - Uploads large photo collections from local folders and ZIP archives to a self-hosted server.
- Duplicate Photo Detectors - Finds and removes duplicate photos on a server by comparing names and capture dates.
- Google Takeout Archive Parsers - Parses Google Takeout ZIP archives to extract photos, videos, and album structure with original metadata.
- Command Line System Administration - Provides command-line utilities for inspecting and maintaining a self-hosted photo server.
- Server Administration Tools - Provides command-line utilities for inspecting and maintaining the internal state of the Immich server.
- Photo and Video Uploads - Uploads photos and videos from local folders, directory trees, and ZIP archives to the server.
- Parallel Upload Optimizers - Speeds up large uploads by running multiple file transfers in parallel without overloading the server.
- Upload Concurrency Balancers - Balances how many files upload at once to keep throughput high without overwhelming the network or server.
- Photo Stacking - Groups related photos into stacks on the server to reduce visual clutter and keep duplicates together.
- Photo Backup Exporters - Downloads photos and albums from a self-hosted server for backup or migration to another instance.
- Cloud Photo Downloaders - Downloads photos and albums from the server for backup or migration to another instance.
- Variant Grouping - Groups related photos into stacks using burst sequences and raw/JPEG pairs to reduce visual clutter.
- Archive Source Ingestion - Accepts input from local directories, directory trees, and ZIP archives for photo uploads.
