winget install --id simulot.immich-goAbout immich-go
Immich-Go is an open-source tool designed to streamline uploading large photo collections to your self-hosted Immich server. It doesn't require NodeJS or Docker for installation. This makes it easy to get started, even for those less familiar with technical environments.
What's new in 0.32.0
Release Notes - v0.32.0 This release brings full compatibility with Immich V3.0.0. All upload, album, and server communication paths have been updated to work with the new API while maintaining backward compatibility with Immich V2. A big thank you to bwees who has done the very neat work for addressing changes: ✨ New Features - Immich V3 support – Full compatibility with Immich V3.0.0. The tool now detects the server version and adapts its behavior accordingly, ensuring smooth operation regardless of which version you're running. - Server version detection – immich-go now reads and exposes the server version at startup, enabling version-aware API calls. 🚀 Improvements - Album contents via search – Album asset retrieval now uses the paginated POST /api/search/metadata endpoint instead of relying on GET /api/albums/{id} to return assets. This works with both Immich V2 and V3 and is more reliable for large albums. - Error handling overhaul – Server error messages are now parsed according to the server version (Zod-based errors for V3, legacy format for V2), providing clearer and more actionable error output. 🔧 Internal Changes - Asset upload field changes – Removed deviceId and deviceAssetId from the upload payload (dropped in Immich V3's AssetMediaCreateDto). These fields are silently ignored by V2, so this change is safe across versions. - Duration field handling – The duration field has been updated to use "0" as a plain string value, which is accepted by both Immich V2 and V3. - Removed deprecated replaceAsset – The ReplaceAsset method and its associated asset.replace per...
Version history
| Version | Updated | Notes |
|---|---|---|
| 0.32.0 | Unknown | Release Notes - v0.32.0 This release brings full compatibility with Immich V3.0.0. All upload, album, and server communication paths have been updated to work with the new API while maintaining backward compatibility wit... |
| 0.31.0 | Unknown | Release Notes - v0.31.0 This release focuses on richer visibility while uploading assets and a major refresh of the CI/CD system that keeps Immich Go healthy across every platform. ✨ New Features - Live terminal tracking... |
| 0.30.0 | Unknown | Release Notes for v0.30.0 We're excited to announce the next major release of immich-go, bringing significant improvements to testing infrastructure, enhanced filtering capabilities, and better stability across the board... |
| 0.29.0 | Unknown | Release Notes - v0.29.0 This release brings powerful new filtering capabilities for the from-immich command and configuration file support, making it easier to manage complex migration scenarios. ✨ New Features - Advance... |
| 0.28.0 | Unknown | Parallel Uploads On the immich-go side, upload operations are primarily limited by I/O, whether reading takeouts and files or sending files to the server. To improve upload throughput, @jonathan-teamstatus proposed enabl... |
| 0.27.0 | Unknown | Faster PaulSonOfLars has significantly improved the performance of immich-go when the source of photos is located on a network folder. In his environment, the performance boost is remarkable, going from uploading one pic... |
| 0.26.3 | Unknown | What's Changed - chore(deps): bump golang.org/x/sync from 0.13.0 to 0.14.0 by @dependabot in #935 - Fixes #942: archive command fails by @simulot in #947 - Added build instructions for Termux to readme.md by @Syntoxr in... |
| 0.26.2 | Unknown | What's Changed - Fix: #928 header timeout by @simulot in #930 Full Changelog: v0.26.1...v0.26.2 |
| 0.26.1 | Unknown | What's Changed - ignore empty icloud csv files by @cederigo in #925 Full Changelog: v0.26.0...v0.26.1 |
| 0.26.0 | Unknown | Be Nice with the Immich Server Release This release addresses the internal errors (500) that have been occurring in Immich over the past few months. These errors happen when metadata is updated through an API call while... |
| 0.25.3 | Unknown | This release fixes the error when importing iCloud's memories. Changelog - 46cc6b2 chore(deps): bump github.com/navidys/tvxwidgets from 0.10.0 to 0.11.0 - 29de9bc chore(deps): bump golang.org/x/sync from 0.12.0 to 0.13.0... |
| 0.25.2 | Unknown | This release fixes some pending issues. Changelog - 3ef1d69 BUG some date time exif tags are not correctly parsed Fixes #727 - 2e585a7 Missing deoDataExif data from Google Takeouts Fixes #841 - 082a555 chore(lint): updat... |
| 0.25.1 | Unknown | This release is focused on bug fixing and maintenance. A big thank you to @exciton who has resolved the issue with live photos causing a Closed Pipe Error. Changelog - 172120e Don't filter any images in GetAllAssets so w... |
| 0.25.0 | Unknown | Release notes |
| 0.24.7 | Unknown | This release focuses on improving the handling of potential file duplication sources to minimize duplicate uploads to the Immich server. The goal is to reduce internal errors and bad requests. The duplication check has b... |
| 0.24.2 | Unknown | This release addresses Bad Request and Internal Error issues caused by the incorrect use of the replaceAsset API call, combined with an error in identifying variations of the same photo on the Immich server. Changelog -... |
| 0.24.1 | Unknown | Changelog - 6ce50e5 Implement file tracking and improve logging (#729) - 03b23f2 fix: adjust goreleaser configuration for build tags and architectures (#730) - 53096d0 fix: ensure close and remove temporary files on Wind... |