Skip to content

fix: make the tgz rejection error actionable - #1440

Open
BeLazy167 wants to merge 1 commit into
simulot:developfrom
BeLazy167:tgz-error-hint
Open

BeLazy167 wants to merge 1 commit into
simulot:developfrom
BeLazy167:tgz-error-hint

Conversation

@BeLazy167

Copy link
Copy Markdown

Problem

upload from-google-photos rejects .tgz / .tar.gz Takeout parts by design (#36, #96, #1038: a gzip stream cannot be seeked). The error only says:

immich-go can't use tgz archives: takeout-...-010.tgz

Users typically hit this after downloading a 400+ GB export and get no hint about what to do next. The docs currently imply tgz works (#1389 fixes that side).

Change

One-line change in internal/fshelper/parseArgs.go: the error now states the two valid options.

immich-go can't read tgz archives: takeout-...-010.tgz. Extract all parts into one folder (tar xzf) and pass that folder, or re-export the takeout as ZIP

"All parts into one folder" matters: sidecar JSONs and media can live in different parts (docs/misc/google-takeout.md), so per-part extraction loses metadata.

No behaviour change; go build ./... and go test ./internal/fshelper/ pass.

Complements #1389.

@BeLazy167
BeLazy167 requested a review from simulot as a code owner September 13, 2026 05:36
immich-go rejects .tgz/.tar.gz Google Takeout parts by design (gzip
streams cannot be seeked, see simulot#36, simulot#96, simulot#1038), but the error only said
the archive can't be used. Users hit this after downloading hundreds of
GB and are left guessing. Say what to do: extract all parts into one
folder and pass the folder, or re-export as ZIP.

Complements simulot#1389 (docs).
@BeLazy167
BeLazy167 changed the base branch from main to develop September 13, 2026 05:46

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant