immich-go(1)

📦 version 0.32.0, in ubuntu stonking

💖 immich-go-archive-from-icloud 💖

okay bestie, welcome to the immich-go manual — yeah, immich-go, section 1, the coolest corner of your man pages 💅

✨ NAME ✨

immich-go-archive-from-icloud — upload photos from an iCloud takeout folder or zip file 🦋

🌸 SYNOPSIS 🌸

immich-go archive from-icloud [flags] ...

🎀 DESCRIPTION 🎀

Upload photos from an iCloud takeout folder or zip file. That's it, that's the whole vibe — you point it at your iCloud takeout situation and it goes to work. no cap. ✨

💅 OPTIONS 💅

  • --album-path-joiner=" / " — pick a string to glue multiple folder names together into one album name (like ' ' or ' - ') 🫶
  • --ban-file='@eaDir/', '@__thumb/', 'SYNOFILETHUMB.', 'Lightroom Catalog/', 'thumbnails/', '.DSStore', '/.*', '.Spotlight-V100/', '.photostructure/', 'Recently Deleted/' — yeet a file out of the run based on a pattern (case-insensitive, so it doesn't care about your capitalization drama). can be specified multiple times, stack 'em up 💀
  • --date-from-name[=true] — if the metadata is being shady and has no date, steal the date from the filename instead. (only works for jpg, mp4, heic, dng, cr2, cr3, arw, raf, nef, mov) 🙈
  • --date-range=unset — only import photos taken inside the date range you specify, nothing outside the window bestie
  • --exclude-extensions= — comma-separated list of extensions to exclude (e.g. .gif,.PM) (default: none) 🚫
  • --folder-as-album=NONE — import all files into albums defined by the folder structure. set it to 'FOLDER' to use just the folder name as the album name, or 'PATH' to use the full path as the album name 📁
  • --folder-as-tags[=false] — use the folder structure as tags, so a file like holiday/summer 2024/file.jpg ends up with the tag holiday/summer 2024 🏷️
  • -h, --help[=false] — help for from-icloud 💖
  • --ignore-sidecar-files[=false] — don't upload the sidecar along with the photo, leave that little guy at home
  • --include-extensions= — comma-separated list of extensions to include (e.g. .jpg,.heic) (default: all) ✅
  • --include-type= — a single file type to include, either VIDEO or IMAGE (default: all) 🎬
  • --into-album="" — name an album and every single file gets dumped into it
  • --memories[=false] — import iCloud memories as albums, yes really, memories are going in the album bin 📸
  • --recursive[=true] — explore the folder and every sub-folder inside it, all the way down 🌀

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • --concurrent-tasks=16 — number of concurrent tasks, range is 1-20 🔥
  • --config="" — config file (default is ./immich-go.yaml)
  • --dry-run[=false] — dry run, a little test run before the real thing
  • -l, --log-file="" — write log messages into the file 📝
  • --log-level="INFO" — log level (DEBUG|INFO|WARN|ERROR), default INFO
  • --log-type="text" — log formatted as text of JSON file
  • --on-errors=stop — what to do when an error occurs (stop, continue, accept N errors at max) 😭
  • --save-config[=false] — save the configuration to immich-go.yaml 💾
  • -w, --write-to-folder="" — path where to write the archive
fr fr, pay attention to these inherited ones — they're running the show in the background whether you think about them or not 👑

👀 SEE ALSO 👀

immich-go-archive(1)

📜 HISTORY 📜

28-Mar-2026 — auto generated by spf13/cobra

and that's the whole page bestie!! this beauty was auto generated by spf13/cobra, dated Mar 2026, living in the immich-go(1) manual — go forth and archive your iCloud chaos, you absolute icon 👑✨💜

📦 where this page comes from